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