TikTok MCP-Dienst

Ein Model Context Protocol-Dienst für die TikTok-Videoerkennung und Metadatenextraktion. Dieser Dienst bietet eine robuste Schnittstelle für die Suche nach TikTok-Videos anhand von Hashtags und das Abrufen von Trendinhalten mit integrierten Anti-Erkennungsmaßnahmen und Fehlerbehandlung.

Merkmale

• Videos nach Hashtags suchen

• Konfigurierbare Videoanzahl pro Suche (Standard: 30)

• Maßnahmen zur Anti-Bot-Erkennung

• Proxy-Unterstützung

• Automatische API-Sitzungsverwaltung

• Ratenbegrenzung und Fehlerbehandlung

• Überwachung des Gesundheitszustands

Related MCP server: rednote-agent

Konfiguration

Der Dienst verwendet Umgebungsvariablen zur Konfiguration. Erstellen Sie eine .env Datei mit:

ms_token=your_tiktok_ms_token  # Optional but recommended to avoid bot detection
TIKTOK_PROXY=your_proxy_url    # Optional proxy configuration

Installation und Einrichtung

Installation über Smithery

So installieren Sie TikTok Video Search für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @terrylinhaochen/tiktok_mcp --client claude

Manuelle Installation

# Install dependencies
poetry install

# Install browser automation dependencies
poetry run python -m playwright install

# Start the service
poetry run python -m tiktok_mcp_service.main

Claude Desktop Integration

Sobald Ihr Dienst läuft, können Sie ihn in Claude Desktop integrieren. Da wir Poetry für das Abhängigkeitsmanagement verwenden, führen Sie die MCP-CLI-Befehle unbedingt über Poetry aus:

# Navigate to the project directory
cd /path/to/tiktok-mcp-service

# Install the service in Claude Desktop with Poetry in editable mode
poetry run mcp install tiktok_mcp_service/main.py --with-editable . -f .env

# Optional: Install with a custom name
poetry run mcp install tiktok_mcp_service/main.py --name "TikTok Video Search" --with-editable . -f .env

Nach der Installation ist der Dienst in Claude Desktop verfügbar und wird zur ordnungsgemäßen Abhängigkeitsverwaltung mit Poetry ausgeführt.

API-Endpunkte

Gesundheitscheck

• GET /health – Überprüfen Sie die Dienstintegrität und den API-Initialisierungsstatus

  {
    "status": "running",
    "api_initialized": true,
    "service": {
      "name": "TikTok MCP Service",
      "version": "0.1.0",
      "description": "A Model Context Protocol service for searching TikTok videos"
    }
  }

Videos suchen

• POST /search - Suche nach Videos mit Hashtags

  {
    "search_terms": ["python", "coding"],
    "count": 30  // Optional, defaults to 30
  }

  Die Antwort umfasst Video-URLs, Beschreibungen und Engagement-Statistiken (Aufrufe, „Gefällt mir“-Angaben, geteilte Beiträge, Kommentare).

Ressourcenmanagement

• POST /cleanup – Ressourcen und API-Sitzungen bereinigen

Fehlerbehandlung

Der Service umfasst eine umfassende Fehlerbehandlung für:

• API-Initialisierungsfehler

• Probleme mit der Bot-Erkennung

• Netzwerkfehler

• Ratenbegrenzung

• Ungültige Suchbegriffe

Entwicklung

Gebaut mit:

• TikTokApi

• FastMCP

• Poesie für das Abhängigkeitsmanagement

• Playwright für die Browserautomatisierung

Lizenz

MIT# tiktok_mcp

Einschränkungen der TikTok-API

Wichtiger Hinweis: TikTok hat strenge Anti-Scraping-Maßnahmen implementiert, die den API-Zugriff einschränken. Daher bietet dieser Dienst die folgenden Funktionen:

1. Mock-Data-Modus : Wenn TikTok den API-Zugriff blockiert (was derzeit der Fall ist), liefert der Dienst realistisch aussehende simulierte Ergebnisse, die für die Suchbegriffe relevant sind. Dadurch wird sichergestellt, dass Ihre Claude-Integration auch dann weiterhin funktioniert, wenn TikTok den Zugriff einschränkt.

2. API-Zugriffsversuche : Der Dienst versucht weiterhin zunächst, die TikTok-API zu verwenden, greift jedoch schnell auf simulierte Daten zurück, wenn die API nicht verfügbar ist oder Fehler zurückgibt.

3. Transparenz : Wenn simulierte Daten bereitgestellt werden, wird dies in der Antwort im transformations deutlich angezeigt. Es enthält einen Hinweis darauf, dass simulierte Ergebnisse angezeigt werden.

Diese Implementierung stellt sicher, dass Ihr Dienst trotz der Anti-Scraping-Maßnahmen von TikTok betriebsbereit bleibt.