tiktok-downloader-mcp
{"type": "text"}
📱 TikTok Media Downloader & Analytics (CLI & MCP Server)
All-in-one TikTok-Extraktionssuite: Führen Sie sie direkt im Terminal als eigenständiges CLI-Tool (keine KI erforderlich) aus oder verbinden Sie sie als Model Context Protocol (MCP) Server mit KI-Assistenten (Claude Code, Claude Desktop, Cursor, Windsurf, Antigravity).
Extrahieren, analysieren und laden Sie TikTok HD-Videos (.mp4) und Foto-Diashows/Karussells in Originalqualität ohne Wasserzeichen herunter, organisiert in strukturierten Datumsordnern (YYYY-MM-DD_<id>) mit umfassenden Account-Engagement-Analysen.
📑 Inhaltsverzeichnis
Related MCP server: TikTok Complete MCP Server
✨ Hauptfunktionen
⚡ Duale Ausführung: Direkt im Terminal über
npxnutzbar oder als MCP-Server mit LLMs integrierbar.🎥 HD-Videos ohne Wasserzeichen: Hochauflösende
.mp4-Videodateien mit originalen Cover-Thumbnails herunterladen.📸 HD-Fotos ohne Wasserzeichen: Originalfotos und Karussellfolien in voller Auflösung extrahieren.
📁 Datumsbasierte Organisation: Jeder Beitrag wird unter
YYYY-MM-DD_<id>/abgelegt.📊 Umfassende Engagement-Analysen:
Gesamtaufrufe (
play_count)Gesamt-Likes (
digg_count)Gesamtkommentare (
comment_count)Gesamt-Shares (
share_count)Gesamt-Favoriten/Speicherungen (
collect_count)Gesamt-Downloads (
download_count)Durchschnittliche Engagement-Rate (%)
Top-Beiträge (Meistgesehen, meiste Likes, meiste Shares, meiste Kommentare)
📝 Zweischichtige JSON-Zusammenfassungen:
account_summary.json&account_activity.jsonim Stammverzeichnis des Accounts.post.json&account_activity_recap.jsonin jedem einzelnen Beitragsordner.
🚀 Kein Login / Keine Cookies erforderlich: Funktioniert sofort mit öffentlichen TikTok-Endpunkten.
🖥️ Teil 1: Eigenständige CLI-Nutzung (Keine KI erforderlich)
Sie können den Downloader direkt in Ihrem Terminal ohne KI-Assistenten oder Konfiguration ausführen.
Installations- & Ausführungsoptionen
# 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>Anwendungsfall 1: Einzelne Foto-Diashow
Lädt alle Folien in voller Auflösung herunter und speichert Metadaten:
npx tiktok-downloader-mcp "https://www.tiktok.com/@username/photo/7405928371928371234"Generierte Struktur:
tiktok_downloads/
└── username/
└── 2026-08-16_7405928371928371234/
├── slide_01.jpg
├── slide_02.jpg
├── slide_03.jpg
├── cover.jpg
└── post.jsonAnwendungsfall 2: Einzelnes HD-Video (MP4)
Lädt das HD-Video ohne Wasserzeichen und das dazugehörige Cover-Thumbnail herunter:
npx tiktok-downloader-mcp "https://www.tiktok.com/@username/video/7106594312292453675"Generierte Struktur:
tiktok_downloads/
└── username/
└── 2026-08-15_7106594312292453675/
├── video.mp4 # Clean HD video without watermark
├── cover.jpg # Video thumbnail
└── post.json # Views, likes, comments, sound metadataAnwendungsfall 3: Mobile Kurzlinks (vm.tiktok.com)
Verkürzte mobile URLs werden automatisch aufgelöst:
npx tiktok-downloader-mcp "https://vm.tiktok.com/ZMhNxxxx/"Anwendungsfall 4: Bulk-Profil-Download (Alles)
Durchsucht ein Profil, lädt sowohl Fotos als auch Videos herunter und berechnet umfassende Account-Engagement-Analysen:
# 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 allAnwendungsfall 5: Bulk-Profil - Nur Fotos
Filtert eigenständige Videos heraus und lädt nur Foto-Diashows/Karussells herunter:
npx tiktok-downloader-mcp @username --media photos
# or:
npx tiktok-downloader-mcp @username --photos-only --max 30Anwendungsfall 6: Bulk-Profil - Nur Videos
Filtert Foto-Diashows heraus und lädt nur HD-MP4-Videobeiträge herunter:
npx tiktok-downloader-mcp @username --media videos
# or:
npx tiktok-downloader-mcp @username --videos-only --max 30Anwendungsfall 7: Benutzerdefiniertes Ausgabeverzeichnis
Geben Sie an, wo die Dateien gespeichert werden sollen:
npx tiktok-downloader-mcp @username --out "/Users/me/Desktop/MyTikTokMedia"CLI-Flags-Referenz
Flag | Werte | Standard | Beschreibung |
|
| Erforderlich | Profil-Benutzername, Profil-URL oder direkte Post-URL |
|
|
| Medientypen zum Herunterladen filtern |
| - |
| Kurzbefehl für |
| - |
| Kurzbefehl für |
|
|
| Maximale Anzahl abzurufender Beiträge |
|
|
| Zielausgabeverzeichnis auf Ihrem System |
| - | - | Hilfemenü anzeigen |
🤖 Teil 2: Model Context Protocol (MCP) Einrichtung
Verbinden Sie den Server mit einem KI-Assistenten, damit das LLM TikTok-Inhalte für Sie extrahieren, analysieren und herunterladen kann – per natürlicher Sprache.
MCP-Konfiguration nach Plattform
1. Claude Code CLI (Empfohlen)
# 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-mcpStatus innerhalb von Claude Code überprüfen:
/mcp2. Claude Desktop
Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:
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
Fügen Sie Folgendes zu .cursor/mcp.json oder der Projekt-.mcp.json hinzu:
{
"mcpServers": {
"tiktok-downloader": {
"command": "npx",
"args": ["-y", "tiktok-downloader-mcp"]
}
}
}4. Antigravity CLI
agy mcp add tiktok-downloader -- npx -y tiktok-downloader-mcpMCP-Tools-Referenz
Tool | Zweck | Parameter | Beispiel in natürlicher Sprache |
| Extrahiert Medien-URLs ohne Wasserzeichen, Audio und Metriken, ohne Dateien zu speichern. |
| "Extrahiere die Bilder, den Ton und die Aufrufzahl aus diesem Link: https://www.tiktok.com/@user/photo/123" |
| Listet aktuelle Beitrags-IDs, Upload-Daten und URLs für ein Profil auf. |
| "Liste die letzten 15 Beiträge von @username mit ihren Daten auf." |
| Lädt einen einzelnen Beitrag (Fotos oder Video) in einen Datumsordner mit |
| "Lade dieses TikTok-Video in HD in meinen Download-Ordner herunter." |
| Lädt Videos/Fotos in Datumsordner herunter und erstellt eine globale |
| "Lade alle Foto-Karussells von @username herunter und fasse ihr Engagement zusammen." |
| Berechnet Account-Gesamtsummen, Durchschnitte, Engagement-Rate und Top-Beiträge, ohne Dateien herunterzuladen. |
| "Analysiere die Engagement-Rate und die leistungsstärksten Beiträge von @username." |
📊 Metadaten- & Analyse-Schemas
1. account_summary.json (Account-Ebene)
Gespeichert im Stammverzeichnis des Benutzerordners (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 (Beitragsebene)
Gespeichert in jedem einzelnen Beitragsordner (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 }
}
}📁 Ordnerhierarchie
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 & Fehlerbehebung
F: Benötige ich ein TikTok-Konto oder Cookies, um dies zu nutzen?
A: Nein. Alle Downloads und Metadatenextraktionen funktionieren sofort mit öffentlichen Endpunkten, ohne Login oder Session-Cookies.
F: Sind heruntergeladene Videos und Bilder mit Wasserzeichen versehen?
A: Nein. 100 % der heruntergeladenen Mediendateien sind saubere Dateien in Originalqualität ohne das TikTok-Springwasserzeichen.
F: Werden vorhandene Dateien erneut heruntergeladen, wenn ich den Befehl erneut ausführe?
A: Nein. Das Tool prüft die Dateigröße und das Vorhandensein auf der Festplatte. Wenn eine Folie oder ein Video bereits heruntergeladen wurde, wird es für sofortige Geschwindigkeit automatisch übersprungen.
F: Welche Abhängigkeiten werden benötigt?
A: Node.js >= 18. Für die Profil-Suche wird yt-dlp empfohlen (brew install yt-dlp auf macOS oder pip install yt-dlp).
💻 Lokale Entwicklung & Beiträge
# 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📄 Lizenz
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.-