tiktok-downloader-mcp
📱 TikTok Media Downloader & Analytics(CLI & MCP サーバー)
オールインワンの TikTok 抽出スイート:スタンドアロン CLI ツール(AI 不要)としてターミナルから直接実行するか、Model Context Protocol(MCP)サーバーとして AI アシスタント(Claude Code、Claude Desktop、Cursor、Windsurf、Antigravity)に接続できます。
TikTok の HD 動画(.mp4) および写真スライドショー/カルーセルをオリジナル品質で透かしなしで抽出・分析・一括ダウンロードし、日付フォルダ(YYYY-MM-DD_<id>)に整理し、アカウント全体のエンゲージメント分析を提供します。
📑 目次
Related MCP server: TikTok MCP Server
✨ 主な機能
⚡ 二重実行方式:ターミナルで
npxを使って直接使用するか、LLM 用の MCP サーバーとして統合。🎥 HD 透かしなし動画:高解像度の
.mp4動画ファイルとオリジナルのカバーサムネイルをダウンロード。📸 HD 透かしなし写真:フル解像度のオリジナル写真とカルーセルスライドを抽出。
📁 日付ベースの整理:すべての投稿は
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 の公開エンドポイントを使用してすぐに動作。
🖥️ パート1:スタンドアロン CLI の使い方(AI 不要)
ダウンローダーは、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>ユースケース 1:単一の写真スライドショー
すべてのスライドをフル解像度でダウンロードし、メタデータを保存します。
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ユースケース 2:単一の HD 動画(MP4)
透かしなしの HD 動画とそのカバーサムネイルをダウンロードします。
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 metadataユースケース 3:モバイル短縮リンク(vm.tiktok.com)
短縮されたモバイル URL は自動的に解決されます。
npx tiktok-downloader-mcp "https://vm.tiktok.com/ZMhNxxxx/"ユースケース 4:プロフィール一括ダウンロード(すべて)
プロフィールをスキャンし、写真と動画の両方をダウンロードし、アカウント全体のエンゲージメント分析を計算します。
# 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ユースケース 5:プロフィール一括 - 写真のみ
スタンドアロン動画を除外し、写真スライドショー/カルーセルのみをダウンロードします。
npx tiktok-downloader-mcp @username --media photos
# or:
npx tiktok-downloader-mcp @username --photos-only --max 30ユースケース 6:プロフィール一括 - 動画のみ
写真スライドショーを除外し、HD MP4 動画投稿のみをダウンロードします。
npx tiktok-downloader-mcp @username --media videos
# or:
npx tiktok-downloader-mcp @username --videos-only --max 30ユースケース 7:カスタム出力ディレクトリ
ファイルの保存先を指定します。
npx tiktok-downloader-mcp @username --out "/Users/me/Desktop/MyTikTokMedia"CLI フラグリファレンス
フラグ | 値 | デフォルト | 説明 |
|
| 必須 | プロフィールのユーザー名、プロフィール URL、または投稿 URL |
|
|
| ダウンロードするメディアタイプをフィルタ |
| - |
|
|
| - |
|
|
|
|
| 取得する最大投稿数 |
|
|
| システム上の出力ディレクトリ |
| - | - | ヘルプメニューを表示 |
🤖 パート2:Model Context Protocol(MCP)のセットアップ
サーバーを AI アシスタントに接続すると、LLM が自然言語で TikTok コンテンツの抽出、分析、ダウンロードを行えるようになります。
プラットフォーム別 MCP 設定
1. Claude Code CLI(推奨)
# 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-mcpClaude Code 内でステータスを確認:
/mcp2. Claude Desktop
claude_desktop_config.json に追加:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"tiktok-downloader": {
"command": "npx",
"args": ["-y", "tiktok-downloader-mcp"]
}
}
}3. Cursor と Windsurf
.cursor/mcp.json またはプロジェクトの .mcp.json に追加:
{
"mcpServers": {
"tiktok-downloader": {
"command": "npx",
"args": ["-y", "tiktok-downloader-mcp"]
}
}
}4. Antigravity CLI
agy mcp add tiktok-downloader -- npx -y tiktok-downloader-mcpMCP ツールリファレンス
ツール | 目的 | パラメータ | 自然言語の例 |
| ファイルを保存せずに透かしなしのメディア URL、音声、指標を抽出します。 |
| "このリンクから画像、音声、再生回数を抽出して:https://www.tiktok.com/@user/photo/123" |
| プロフィールの最近の投稿 ID、アップロード日、URL を一覧表示します。 |
| "@username が公開した最新15件の投稿を日付付きでリストして。" |
| 単一の投稿(写真または動画)を日付フォルダにダウンロードし、 |
| "この TikTok 動画を HD でダウンロードフォルダにダウンロードして。" |
| 動画/写真を日付フォルダに一括ダウンロードし、グローバルな |
| "@username のすべての写真カルーセルをダウンロードして、エンゲージメントをまとめて。" |
| ファイルをダウンロードせずに、アカウントの合計値、平均、エンゲージメント率、トップ投稿を計算します。 |
| "@username のエンゲージメント率とトップパフォーマンス投稿を分析して。" |
📊 メタデータと分析スキーマ
1. 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"
}2. 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❓ FAQ とトラブルシューティング
Q: このツールを使うには TikTok アカウントや Cookie が必要ですか?
A: いいえ。すべてのダウンロードとメタデータ抽出は、ログインやセッション Cookie なしで公開エンドポイントを使用してすぐに動作します。
Q: ダウンロードした動画や画像に透かしはありますか?
A: いいえ。ダウンロードされるメディアファイルはすべて、TikTok の跳ねる透かしのない、クリーンでオリジナル品質のファイルです。
Q: コマンドを再実行した場合、既存のファイルは再ダウンロードされますか?
A: いいえ。ツールはファイルサイズとディスク上の存在を確認します。スライドや動画がすでにダウンロードされている場合は、自動的にスキップして高速処理します。
Q: 必要な依存関係は何ですか?
A: 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 --stdio📄 ライセンス
MIT © abdouldotdev
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables access to TikTok data without watermarks, including trending users, hashtags, post analytics, user profiles, and download links for specific countries. Supports searching by username, user ID, or post links.10MIT
- AlicenseBquality-maintenanceA comprehensive MCP server that enables AI assistants to search, download, and analyze TikTok content while also performing active tasks like publishing videos and interacting with posts. It provides full automation capabilities for TikTok through browser session management and anti-detection features.122
- Flicense-qualityDmaintenanceEnables AI assistants to download TikTok videos without watermarks, analyze creator metrics and audience insights, track trending content and hashtags, and search videos, users, and sounds through RapidAPI integration.
- FlicenseBqualityCmaintenanceMCP server for TikTok that enables searching videos, users, hashtags, and fetching trending content, user profiles, and video details via official API or public scraping.8
Related MCP Connectors
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…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
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