Skip to main content
Glama
abdouldotdev

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

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