Skip to main content
Glama
tiktok-downloader-mcp

tiktok-downloader-mcp

by abdouldotdev

{"type": "text"}

📱 TikTok Media Downloader & Analytics (CLI & MCP Server)

npm version License: MIT

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 npx nutzbar 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.json im Stammverzeichnis des Accounts.

    • post.json & account_activity_recap.json in 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.json

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

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 all

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

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

Anwendungsfall 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

<target>

@username | url

Erforderlich

Profil-Benutzername, Profil-URL oder direkte Post-URL

--media

all | photos | videos

all

Medientypen zum Herunterladen filtern

--photos-only

-

false

Kurzbefehl für --media photos

--videos-only

-

false

Kurzbefehl für --media videos

--max

number | all

50

Maximale Anzahl abzurufender Beiträge

--out

path

./tiktok_downloads

Zielausgabeverzeichnis auf Ihrem System

--help, -h

-

-

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

Status innerhalb von Claude Code überprüfen:

/mcp

2. Claude Desktop

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

  • 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

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

MCP-Tools-Referenz

Tool

Zweck

Parameter

Beispiel in natürlicher Sprache

tiktok_extract_post

Extrahiert Medien-URLs ohne Wasserzeichen, Audio und Metriken, ohne Dateien zu speichern.

url (string)

"Extrahiere die Bilder, den Ton und die Aufrufzahl aus diesem Link: https://www.tiktok.com/@user/photo/123"

tiktok_get_user_posts

Listet aktuelle Beitrags-IDs, Upload-Daten und URLs für ein Profil auf.

username (string), max (number)

"Liste die letzten 15 Beiträge von @username mit ihren Daten auf."

tiktok_download_post

Lädt einen einzelnen Beitrag (Fotos oder Video) in einen Datumsordner mit post.json herunter.

url (string), output_dir (string)

"Lade dieses TikTok-Video in HD in meinen Download-Ordner herunter."

tiktok_download_user_media

Lädt Videos/Fotos in Datumsordner herunter und erstellt eine globale account_summary.json.

username (string), max (number), output_dir (string), media_type ("all"|"photos"|"videos")

"Lade alle Foto-Karussells von @username herunter und fasse ihr Engagement zusammen."

tiktok_get_user_analytics

Berechnet Account-Gesamtsummen, Durchschnitte, Engagement-Rate und Top-Beiträge, ohne Dateien herunterzuladen.

username (string), max (number)

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