Skip to main content
Glama
abdouldotdev

tiktok-downloader-mcp

by abdouldotdev

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

npm version License: MIT

オールインワンの TikTok 抽出スイートスタンドアロン CLI ツール(AI 不要)としてターミナルから直接実行するか、Model Context Protocol(MCP)サーバーとして AI アシスタント(Claude CodeClaude DesktopCursorWindsurfAntigravity)に接続できます。

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.jsonaccount_activity.json

    • 各投稿フォルダ内に post.jsonaccount_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

Install Server
F
license - not found
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

  • A
    license
    B
    quality
    -
    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
  • F
    license
    B
    quality
    C
    maintenance
    MCP 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

View all related MCP servers

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…

View all MCP Connectors

Latest Blog Posts

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