Skip to main content
Glama
tiktok-downloader-mcp

tiktok-downloader-mcp

by abdouldotdev

📱 TikTok Media Downloader & Analytics(CLI & MCP サーバー)

npm version License: MIT

オールインワンの 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 フラグリファレンス

フラグ

値

デフォルト

説明

<target>

@username | url

必須

プロフィールのユーザー名、プロフィール URL、または投稿 URL

--media

all | photos | videos

all

ダウンロードするメディアタイプをフィルタ

--photos-only

-

false

--media photos のショートカット

--videos-only

-

false

--media videos のショートカット

--max

number | all

50

取得する最大投稿数

--out

path

./tiktok_downloads

システム上の出力ディレクトリ

--help, -h

-

-

ヘルプメニューを表示


🤖 パート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-mcp

Claude Code 内でステータスを確認:

/mcp

2. Claude Desktop

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"]
    }
  }
}

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-mcp

MCP ツールリファレンス

ツール

目的

パラメータ

自然言語の例

tiktok_extract_post

ファイルを保存せずに透かしなしのメディア URL、音声、指標を抽出します。

url(文字列)

"このリンクから画像、音声、再生回数を抽出して:https://www.tiktok.com/@user/photo/123"

tiktok_get_user_posts

プロフィールの最近の投稿 ID、アップロード日、URL を一覧表示します。

username(文字列)、max(数値)

"@username が公開した最新15件の投稿を日付付きでリストして。"

tiktok_download_post

単一の投稿(写真または動画)を日付フォルダにダウンロードし、post.json を保存します。

url(文字列)、output_dir(文字列)

"この TikTok 動画を HD でダウンロードフォルダにダウンロードして。"

tiktok_download_user_media

動画/写真を日付フォルダに一括ダウンロードし、グローバルな account_summary.json を作成します。

username(文字列)、max(数値)、output_dir(文字列)、media_type("all"|"photos"|"videos")

"@username のすべての写真カルーセルをダウンロードして、エンゲージメントをまとめて。"

tiktok_get_user_analytics

ファイルをダウンロードせずに、アカウントの合計値、平均、エンゲージメント率、トップ投稿を計算します。

username(文字列)、max(数値)

"@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 とトラブルシューティング

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 tools
tiktok_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

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    Five tools is well-scoped for a TikTok downloader: essential operations for data extraction, listing, downloading, and analytics are covered without bloat.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      Not graded
      maintenance
      A 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.
      12
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      TikTok 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.
      10
      82 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables reading TikTok trends, profiles, comments, and own-account metrics via an unofficial facade with fallback providers and risk-tiered tools, plus queued posting capabilities.
      -