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 Complete 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
Available Tools
5 toolstiktok_download_postA
Download a TikTok post (unwatermarked HD MP4 video or photo slides) into a date-named folder (YYYY-MM-DD_) with full post.json metadata.
Inputs: url (required), output_dir.
tiktok_download_user_mediaA
Download all media (photos slideshows and/or HD MP4 videos) from a TikTok account into organized date folders (YYYY-MM-DD_), with post.json in each folder and full account_summary.json.
Inputs: username (required), max, media_type, output_dir.
tiktok_extract_postA
Extract unwatermarked HD photos, video download URL, audio, and full engagement metrics (views, likes, comments, shares, saves) from any TikTok URL.
Inputs: url (required).
tiktok_get_user_analyticsB
Analyze a TikTok profile's recent engagement metrics, total views, likes, comments, shares, engagement rate, and top performing posts without downloading files.
Inputs: username (required), max.
tiktok_get_user_postsB
List recent post IDs, upload dates, and URLs for a TikTok user or profile URL.
Inputs: username (required), max.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clear, distinct purpose: extracting post info, listing user posts, downloading a single post, downloading all user media, and getting user analytics. No significant overlap between any two tools.
All tools follow the pattern 'tiktok_<verb>_<object>', with verbs like extract, get, download. The pattern is consistent, though 'extract' vs 'get' for similar retrieval operations is a minor inconsistency.
Five tools is well-scoped for a TikTok downloader: essential operations for data extraction, listing, downloading, and analytics are covered without bloat.
The surface covers the core workflow: obtain URLs, list posts, download individual or all user media, and analyze engagement. Missing features like search or hashtag downloads are beyond the stated scope, so minor gap.
Maintenance
Related MCP Connectors
Real-time TikTok profile, video feed, comments, search & HD media metadata API for AI agents.
Public TikTok profiles, videos, comments and keyword search as JSON. No developer account.
Real-time TikTok videos, profiles, comments, trends & Creative Center ads MCP. OAuth or API key.
TikTok research for AI agents. Ask ChatGPT, Claude, Cursor, Codex or any MCP client what people search, watch, say and buy on TikTok, and get real numbers back. 34 tools: weekly TikTok search volume and 7-day trends, content gaps, videos, creators, comments and caption transcripts, hashtags and sounds, TikTok Shop sales estimates for products, shops, creators, videos and LIVE streams, TikTok’s Top Ads library with CTR and retention, places, and a fair comment-giveaway picker. 17 markets. Built for marketers, agencies, TikTok Shop sellers and creators. Sign in with OAuth or an API key; 50 free credits, no card.
Related MCP Servers
- AlicenseBqualityNot gradedmaintenanceA 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.122MIT
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- AlicenseAqualityCmaintenanceTikTok creator toolkit for AI assistants. Four tools: download watermark-free videos by URL, look up curated 15-hashtag sets for 15 niches with strategy tips, retrieve best posting times for 12 countries, and generate viral hook formulas across 8 categories. Stdio transport, runs via npx -y tiktapdown-mcp, no API keys, no signup, free. MIT license.1082 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables reading TikTok trends, profiles, comments, and own-account metrics via an unofficial facade with fallback providers and risk-tiered tools, plus queued posting capabilities.-