一站式 TikTok 提取套件：既可作为独立 CLI 工具（无需 AI）直接在终端运行，也可作为模型上下文协议（MCP）服务器接入 AI 助手（Claude Code、Claude Desktop、Cursor、Windsurf、Antigravity）。
提取、分析并批量下载 TikTok 高清视频 (.mp4) 和无水印原始品质的图片轮播/幻灯片，按结构化日期文件夹（YYYY-MM-DD_<id>）整理，并提供全面的账号互动分析。
Related MCP server: TikTok MCP Server
⚡ 双模式运行：既可通过 npx 在终端直接使用，也可作为 MCP 服务器集成到 LLM。
🎥 高清无水印视频：下载高分辨率 .mp4 视频文件及原始封面缩略图。
📸 高清无水印图片：提取全分辨率原始图片及轮播幻灯片。
📁 按日期整理：每条帖子存入 YYYY-MM-DD_<id>/ 文件夹。
📊 丰富的互动分析：
总播放量（play_count）
总点赞数（digg_count）
总评论数（comment_count）
总分享数（share_count）
总收藏数（collect_count）
总下载数（download_count）
平均互动率（%）
最佳表现帖子（播放最多、点赞最多、分享最多、评论最多）
📝 双层 JSON 摘要：
账号根目录下的 account_summary.json 与 account_activity.json。
每个帖子文件夹内的 post.json 与 account_activity_recap.json。
🚀 无需登录 / Cookie：开箱即用，通过 TikTok 公开接口工作。
无需任何 AI 助手或配置，直接在终端运行下载器。
# Option A: One-liner via NPX (No installation needed)
npx tiktok-downloader-mcp <arguments>
# Option B: Global NPM install
npm install -g tiktok-downloader-mcp
tiktok-downloader-mcp <arguments>
# Option C: Local Git Clone
git clone https://github.com/abdouldotdev/tiktok-downloader-mcp.git
cd tiktok-downloader-mcp && npm install && npm run build
node dist/index.js <arguments>下载所有幻灯片的全分辨率版本并保存元数据：
npx tiktok-downloader-mcp "https://www.tiktok.com/@username/photo/7405928371928371234"生成的结构：
tiktok_downloads/
└── username/
└── 2026-08-16_7405928371928371234/
├── slide_01.jpg
├── slide_02.jpg
├── slide_03.jpg
├── cover.jpg
└── post.json下载无水印高清视频及封面缩略图：
npx tiktok-downloader-mcp "https://www.tiktok.com/@username/video/7106594312292453675"生成的结构：
tiktok_downloads/
└── username/
└── 2026-08-15_7106594312292453675/
├── video.mp4 # Clean HD video without watermark
├── cover.jpg # Video thumbnail
└── post.json # Views, likes, comments, sound metadatavm.tiktok.com）短链接会自动解析：
npx tiktok-downloader-mcp "https://vm.tiktok.com/ZMhNxxxx/"扫描个人资料，下载图片和视频，并计算账号总互动分析：
# Download recent 50 posts (default):
npx tiktok-downloader-mcp @username
# Download recent 20 posts:
npx tiktok-downloader-mcp @username --max 20
# Download ALL posts from the profile:
npx tiktok-downloader-mcp @username --max all过滤掉单独的视频，仅下载图片轮播/幻灯片：
npx tiktok-downloader-mcp @username --media photos
# or:
npx tiktok-downloader-mcp @username --photos-only --max 30过滤掉图片轮播，仅下载高清 MP4 视频帖子：
npx tiktok-downloader-mcp @username --media videos
# or:
npx tiktok-downloader-mcp @username --videos-only --max 30指定文件存储位置：
npx tiktok-downloader-mcp @username --out "/Users/me/Desktop/MyTikTokMedia"参数 | 值 | 默认值 | 描述 |
|
| 必填 | 用户名、个人资料 URL 或直接帖子 URL |
|
|
| 筛选要下载的媒体类型 |
| - |
| 等价于 |
| - |
| 等价于 |
|
|
| 最大获取帖子数 |
|
|
| 系统上的目标输出目录 |
| - | - | 显示帮助菜单 |
将服务器连接至 AI 助手，让 LLM 通过自然语言为您提取、分析并下载 TikTok 内容。
# Add via NPX:
claude mcp add tiktok-downloader -- npx -y tiktok-downloader-mcp
# Or directly from GitHub:
claude mcp add tiktok-downloader -- npx -y github:abdouldotdev/tiktok-downloader-mcp在 Claude Code 中检查状态：
/mcp添加到 claude_desktop_config.json：
macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"tiktok-downloader": {
"command": "npx",
"args": ["-y", "tiktok-downloader-mcp"]
}
}
}添加到 .cursor/mcp.json 或项目 .mcp.json：
{
"mcpServers": {
"tiktok-downloader": {
"command": "npx",
"args": ["-y", "tiktok-downloader-mcp"]
}
}
}agy mcp add tiktok-downloader -- npx -y tiktok-downloader-mcp工具 | 用途 | 参数 | 自然语言示例 |
| 提取无水印媒体 URL、音频和指标，不保存文件。 |
| "提取这个链接的图片、音频和播放量：https://www.tiktok.com/@user/photo/123" |
| 列出某个账号最近的帖子 ID、发布日期和 URL。 |
| "列出 @username 最近发布的 15 个帖子及其日期。" |
| 下载单个帖子（图片或视频）到日期文件夹，并生成 |
| "把这个 TikTok 视频高清下载到我的下载文件夹。" |
| 批量下载视频/图片到日期文件夹，并创建全局 |
| "下载 @username 的所有图片轮播，并总结它们的互动情况。" |
| 计算账号总量、平均值、互动率及最佳帖子，不下载文件。 |
| "分析 @username 的互动率和表现最好的帖子。" |
account_summary.json（账号级别）保存在用户文件夹根目录（tiktok_downloads/<username>/account_summary.json）：
{
"account": {
"username": "example_user",
"nickname": "Creator Name",
"user_id": "7582772389835113485",
"avatar": "https://.../avatar.jpeg",
"profile_url": "https://www.tiktok.com/@example_user"
},
"activity_totals": {
"total_posts_analyzed": 50,
"total_slideshows_count": 32,
"total_videos_count": 18,
"total_images_count": 312,
"total_views": 1066188,
"total_likes": 17388,
"total_comments": 6078,
"total_shares": 410,
"total_favorites_saves": 2579,
"total_downloads": 74,
"total_all_interactions": 26455
},
"performance_averages": {
"avg_views_per_post": 21324,
"avg_likes_per_post": 348,
"avg_comments_per_post": 121.6,
"avg_shares_per_post": 8.2,
"avg_favorites_per_post": 51.6,
"avg_engagement_rate_percent": 2.48
},
"top_performing_posts": {
"most_viewed": { "id": "7652520719259159822", "date": "2026-06-18", "views": 461748, "type": "slideshow" },
"most_liked": { "id": "7652520719259159822", "date": "2026-06-18", "likes": 5558, "type": "slideshow" }
},
"updated_at": "2026-08-18T15:57:52.024Z"
}post.json（帖子级别）保存在每个帖子文件夹内（tiktok_downloads/<username>/YYYY-MM-DD_<id>/post.json）：
{
"post_details": {
"id": "7674774636999003406",
"user": "example_user",
"author": { "uniqueId": "example_user", "nickname": "Creator Name" },
"title": "Summer outfit ideas #fashion #summer",
"media_type": "slideshow",
"date": "2026-08-16",
"timestamp": 1787049600,
"url": "https://www.tiktok.com/@example_user/video/7674774636999003406",
"slides_count": 10,
"stats": {
"views": 1120,
"likes": 21,
"comments": 17,
"shares": 1,
"favorites": 5,
"downloads": 0,
"total_interactions": 44,
"engagement_rate_percent": 3.93
},
"music": {
"id": "7644346595656730640",
"title": "Original Sound",
"author": "Sound Creator",
"duration": 60,
"play_url": "https://.../audio.mp4"
}
},
"account_recap": {
"username": "example_user",
"activity_totals": { "total_views": 1066188, "total_likes": 17388 },
"performance_averages": { "avg_engagement_rate_percent": 2.48 }
}
}tiktok_downloads/
└── example_user/
├── account_summary.json # Cumulative totals, averages, engagement & top posts
├── account_activity.json # Complete chronological history of all posts
│
├── 2026-08-16_7674774636999003406/ # 📸 Photo Slideshow post folder
│ ├── slide_01.jpg
│ ├── slide_02.jpg
│ ├── slide_03.jpg
│ ├── cover.jpg
│ ├── post.json # Individual post metrics + global account recap
│ └── account_activity_recap.json
│
└── 2026-08-15_7674392602606619917/ # 🎬 Video post folder
├── video.mp4 # HD unwatermarked video
├── cover.jpg # Video cover thumbnail
├── post.json
└── account_activity_recap.json答： 不需要。所有下载和元数据提取均通过公共接口开箱即用，无需任何登录或会话 Cookie。
答： 没有。100% 下载的媒体文件都是干净、原始品质的文件，不含 TikTok 跳动水印。
答： 不会。工具会检查磁盘上文件的大小和存在性。如果某个幻灯片或视频已下载，将自动跳过以获得即时速度。
答： Node.js >= 18。对于个人资料扫描，推荐使用 yt-dlp（macOS 上 brew install yt-dlp，或 pip install yt-dlp）。
# Clone repository
git clone https://github.com/abdouldotdev/tiktok-downloader-mcp.git
cd tiktok-downloader-mcp
# Install dependencies
npm install
# Compile TypeScript
npm run build
# Run CLI locally
node dist/index.js @username --max 10
# Run MCP Server on stdio
node dist/index.js --stdioMIT © abdouldotdev
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Download YouTube, TikTok, Vimeo, SoundCloud and 6 more platforms from any MCP AI chatbot.
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/abdouldotdev/tiktok-downloader-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server