TikTok MCP Server

Ein gehosteter Model Context Protocol (MCP)-Server, der Claude, Cursor, Windsurf und jedem anderen MCP-Client vier schreibgeschützte TikTok-Tools bietet. Rufe ein öffentliches Profil ab, blättere durch die Videos eines Kontos, lies die Kommentare zu einem Video und durchsuche TikTok nach Videos oder Creatorn – alles als strukturiertes JSON, ohne TikTok-Entwicklerkonto und ohne OAuth.

Er liest öffentliche Daten, die ein abgemeldeter Besucher sehen kann. Er meldet sich nicht an, postet nicht und agiert nicht als Konto.

https://mcp.hasdata.com/api/mcp?apis=tiktok

Inhalt

• Was du brauchst

• Schnellstart

• Beispiel-Prompts

• Tools

• Fehler und Fehlerfälle

• Preise, kostenloses Kontingent und Limits

• Tool-Auswahl

• Vergleich

• FAQ

• HasData-Links

• Entwicklung

• Mitwirken

• Lizenz

Related MCP server: tiktok-mcp

Was du brauchst

Einen MCP-Client und einen HasData-API-Schlüssel aus dem Dashboard, kostenlos zu erstellen. Das ist ein Remote-Server, also ist der einfachste Weg eine URL und ein x-api-key-Header, ohne Container, den du ausführen musst, und ohne TikTok-Entwicklerkonto irgendwo im Ablauf. Ein Client, der nur stdio spricht, erreicht ihn über einen schlanken Launcher, veröffentlicht als @hasdata/tiktok-mcp auf npm und hasdata-tiktok-mcp auf PyPI, wie unten gezeigt.

Schnellstart

Die Server-URL ist für jeden Client dieselbe. Wir setzen sie direkt in Claude Code und Claude Desktop ein. Die anderen Blöcke folgen dem jeweils dokumentierten Format des Clients für einen Remote-Server.

Clients mit OAuth-Unterstützung können dieselbe URL als Connector hinzufügen und sich anmelden, ohne einen Schlüssel in eine Konfigurationsdatei zu setzen.

claude mcp add --transport http tiktok "https://mcp.hasdata.com/api/mcp?apis=tiktok" \
  --header "x-api-key: HASDATA_API_KEY"

Einstellungen, dann Connectors, dann Add custom connector, dann füge https://mcp.hasdata.com/api/mcp?apis=tiktok ein und melde dich an.

Für den Konfigurationsdatei-Weg lädt Claude Desktop nur lokale (stdio) Server, also erreicht es einen Remote-Server über einen stdio-Launcher. Das Paket @hasdata/tiktok-mcp ist dieser Launcher und liest den Schlüssel aus der Umgebung. Füge das zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "tiktok": {
      "command": "npx",
      "args": ["-y", "@hasdata/tiktok-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Python statt Node? Tausche den Launcher gegen das PyPI-Paket, das uvx ohne manuelle Installation ausführt:

{
  "mcpServers": {
    "tiktok": {
      "command": "uvx",
      "args": ["hasdata-tiktok-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

~/.cursor/mcp.json für jedes Projekt, oder .cursor/mcp.json für eines:

{
  "mcpServers": {
    "tiktok": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=tiktok",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json. Windsurf nennt das Feld serverUrl, nicht url:

{
  "mcpServers": {
    "tiktok": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=tiktok",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "tiktok": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=tiktok",
      "type": "streamableHttp",
      "headers": { "x-api-key": "HASDATA_API_KEY" },
      "disabled": false
    }
  }
}

.vscode/mcp.json im Arbeitsbereich:

{
  "servers": {
    "tiktok": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=tiktok",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codex/config.toml:

[mcp_servers.tiktok]
url = "https://mcp.hasdata.com/api/mcp?apis=tiktok"

[mcp_servers.tiktok.headers]
"x-api-key" = "HASDATA_API_KEY"

~/.gemini/settings.json:

{
  "mcpServers": {
    "tiktok": {
      "httpUrl": "https://mcp.hasdata.com/api/mcp?apis=tiktok",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Beispiel-Prompts

Prompts, kein Code. Füge einen ein und der Agent wählt selbst das Tool. Jeder ist mit den Aufrufen annotiert, die er benötigt, denn in MCP entscheidet das Modell, wie viele Aufrufe es macht, und jeder erfolgreiche Aufruf kostet 10 Credits.

Nimm @mrbeast. Rufe das Profil ab, blättere dann durch die ersten beiden Seiten der Videos und nenn mir die mediane Abspielzahl über sie hinweg.

Drei Aufrufe, 30 Credits. Das Profil ist ein Aufruf, und jede Videoseite ist ein weiterer.

Suche auf TikTok nach Creatorn zum Thema „cold brew coffee“ und reihe die Top Ten nach Followern ein, jeweils mit ihrer Bio.

Ein Aufruf, 10 Credits. Eine Benutzersuche enthält bereits Follower-Anzahl und Bio, daher ist kein weiterer Profilabruf nötig.

Hier ist eine Video-URL. Lies ihre Top-Kommentare und sag mir die Gesamtstimmung und die drei Antworten mit den meisten Likes.

Ein Aufruf, 10 Credits. Die numerische ID in der URL ist alles, was das Kommentare-Tool braucht.

Nimm dasselbe Video und klappe dann die Antworten unter seinem Kommentar mit den meisten Likes auf.

Zwei Aufrufe, 20 Credits. Zuerst die Kommentare auf oberster Ebene, dann ein zweiter Aufruf mit der ID dieses Kommentars für seine Antworten.

Suche nach „asmr“-Videos und rufe dann die Autorenprofile der drei mit den höchsten Abspielzahlen ab.

Vier Aufrufe, 40 Credits. Eine Suche, dann jeweils ein Profil. Jeder Autor in einem Suchergebnis trägt einen Link direkt zu seinem Profil-Endpunkt, sodass der Agent nie einen Handle erraten muss.

Paging kostet jedes Mal einen Aufruf. Ein Creator-Audit, das ein Profil liest und dann fünf Videoseiten durchläuft, sind sechs Aufrufe und 60 Credits. Mit der Testversion kommst du bei engen Fragen weiter als bei offenen Crawls.

Tools

Vier Tools, alle mit Leserecht. Die Beispiele unten sind aus echten Aufrufen gekürzt, und die Zahlen darin verändern sich, wenn TikTok aktualisiert. Lies sie als Formen. Jeder Toolname verlinkt auf seine Endpunkt-Referenz, die die vollständige Feldliste enthält.

Die Beispiele sind die Nutzlast, nicht die gesamte Antwort. Ein tools/call-Ergebnis trägt einen Textblock, und dieser Text ist selbst JSON, das url, status, text und json enthält, mit den gescrapten Daten unter json. Bei einer rohen JSON-RPC-Antwort ist der Pfad result.content[0].text, geparst, dann .json. Ein Chat-Client packt das für dich aus, Code, der direkt mit dem Endpunkt spricht, jedoch nicht.

Handles, Video-IDs und Kommentar-IDs bilden eine Kette. Ein Profil verlinkt auf seine Posts, jeder Post trägt seine eigene Video-ID für das Kommentare-Tool, und jeder Autor in Kommentaren und Suchergebnissen trägt einen hasdataLink zu seinem Profil und einen hasdataPostsLink zu seinen Videos. Ein Agent geht von einem Suchbegriff zu einem Creator, zu einem Video und zu dessen Kommentaren, ohne jemals eine URL zu erstellen.

TikTok-Profil abrufen

hasdata_tiktok_profile_getTikTokProfile

Ein öffentliches Konto per Handle.

Gibt username, nickname, biography, bioLink, verified, language, createTime, die Avatar-URLs und die Anzahlen für followers, follows, likes, videos und friends als Ganzzahlen zurück. Die Anzahlen sind bereits geparst, sodass followers > 1000000 Zahlen vergleicht und keine Anzeigestrings.

Ein Handle, der nicht existiert, kommt weiterhin mit requestMetadata.status = ok zurück; das profile-Objekt fehlt lediglich. Prüfe, ob das Objekt vorhanden ist, bevor du username oder ein anderes Feld liest, sonst wirft ein Agent, der profile.username ausführt, eine Ausnahme ins Leere.

{
  "username": "mrbeast",
  "nickname": "MrBeast",
  "verified": true,
  "biography": "Checkout My New Book!👇",
  "bioLink": "http://themostdangerousgames.com",
  "createTime": "2018-10-20T19:26:16.000Z",
  "followers": 138387571,
  "follows": 354,
  "likes": 1427086888,
  "videos": 466,
  "friends": 285
}

TikTok-Posts abrufen

hasdata_tiktok_posts_getTikTokPosts

Eine Seite der Videos eines Kontos per Handle, neueste zuerst.

Ein Aufruf liefert etwa dreißig Videos plus pagination mit hasMore und dem nextPageToken, den du zurückspeist, um die Kontohistorie Seite für Seite durchzugehen. Jedes Video enthält id, description, url, duration, die Cover- und abspielbaren Video-URLs, music sowie die Anzahlen für likes, comments, shares, plays, collects und reposts als Ganzzahlen.

hashtags und mentions sind nur bei Videos vorhanden, die sie verwenden. Auf einer echten Seite mit 27 Videos hatten 4 ein hashtags-Array und 10 enthielten mentions. Prüfe den Key, bevor du ihn liest, statt anzunehmen, dass jedes Video beides hat.

{
  "id": "7677375185028271391",
  "description": "would you take the car or nah?",
  "url": "https://www.tiktok.com/@mrbeast/video/7677375185028271391",
  "createTime": "2026-08-23T23:36:59.000Z",
  "duration": 41,
  "likes": 129500,
  "comments": 6670,
  "shares": 2033,
  "plays": 1100000,
  "collects": 4986,
  "music": { "title": "original sound", "authorName": "MrBeast", "original": true }
}

TikTok-Kommentare abrufen

hasdata_tiktok_comments_getTikTokComments

Die Kommentare zu einem öffentlichen Video oder die Antworten unter einem Kommentar.

Jeder Kommentar trägt text, likes, createTime, replyCount und einen author, und jeder Autor trägt einen hasdataLink zu seinem Profil und einen hasdataPostsLink zu seinen Videos. pagination.total meldet die gesamte Kommentar-Anzahl des Videos, sodass du die Tiefe kennst, bevor du blätterst. Ein Kommentar mit einem replyCount ungleich null hat Antworten, die du erreichst, indem du erneut mit seiner id als commentId aufrufst.

{
  "id": "7677377150003053325",
  "text": "How could someone turn down a car",
  "createTime": "2026-08-23T23:45:06.000Z",
  "likes": 3802,
  "replyCount": 22,
  "author": {
    "username": "hohce.verggr",
    "nickname": "Sasori",
    "hasdataLink": "https://api.hasdata.com/scrape/tiktok/profile?handle=hohce.verggr",
    "hasdataPostsLink": "https://api.hasdata.com/scrape/tiktok/posts?handle=hohce.verggr"
  }
}

TikTok durchsuchen

hasdata_tiktok_search_getTikTokSearch

Eine Stichwortsuche über Videos oder Creatorn.

Mit type: video enthält die Antwort Videos in derselben Form, die das posts-Tool zurückgibt, jeweils mit seinem Autor. Mit type: user enthält sie Ersteller, jeweils mit username, nickname, signature (der Bio), avatarUrl, followers sowie denselben hasdataLink und hasdataPostsLink, um in ein Profil oder dessen Videos zu springen. Ein verified-Flag ist bei Konten vorhanden, die eines tragen.

{
  "username": "la.mooncoldbrew",
  "nickname": "lamoon cold brew coffee",
  "signature": "อยากได้สูตรชงเมนูไหน Comment ไว้เลยน้า",
  "followers": 48000,
  "hasdataLink": "https://api.hasdata.com/scrape/tiktok/profile?handle=la.mooncoldbrew",
  "hasdataPostsLink": "https://api.hasdata.com/scrape/tiktok/posts?handle=la.mooncoldbrew"
}

Fehler und Fehlerpfade

Ihr Client sieht bei einem Tool-Aufruf fast nie einen HTTP-Fehlercode. Die MCP-Ebene antwortet mit 200 und legt den Fehler in das Ergebnis, mit isError auf true und dem Grund als Text. Der Agent liest eine Meldung, wo man eine Statuszeile erwarten würde.

Ein falscher Schlüssel erscheint als Tool-Ausgabe, nicht als fehlgeschlagene Verbindung. tools/list akzeptiert jeden nicht-leeren Schlüssel und gibt alle vier Tools zurück, sodass der Client seinen Handshake abschließt und grün zeigt. Der erste Tool-Aufruf kommt dann mit isError: true und dem Text HasData API error: 401 Unauthorized zurück. Achten Sie auf diesen String, denn nichts früher im Ablauf meldet das Problem.

Ein fehlender Schlüssel ist der einzige echte HTTP-Fehler. Die Autorisierung läuft vor jedem Tool ab, und die Verbindung selbst schlägt mit 401 fehl. CORS-Header sind vorhanden, und ein Browser-Client liest den Status und keinen undurchsichtigen Netzwerkfehler.

Ein Argument, das das Schema eines Tools verletzt, wird abgewiesen, bevor es zu einem Scrape kommt. Der Server antwortet mit isError: true und dem Text MCP error -32602: Input validation error, wobei das fehlerhafte Feld benannt wird. Es wird nichts abgerufen und nichts in Rechnung gestellt.

Ein Aufruf, der erfolgreich ist und nichts findet, ist der Fall, über den viele stolpern. Ein Handle, das nicht existiert, kommt als gewöhnliches Ergebnis zurück, mit requestMetadata.status auf ok und dem einfach fehlenden Daten-Schlüssel. Nichts im Body sagt, dass das Ergebnis leer war. Testen Sie auf das Feld, das Sie benötigen, nicht auf einen Fehler.

Eine Kennung, die die Plattform ablehnt, gibt 400 zurück mit requestMetadata.status auf error.

Ergebnisse, die Daten enthalten, tragen auch eine requestMetadata.id, die es wert ist, im Support angegeben zu werden.

Preise, kostenloser Tarif und Limits

Jedes TikTok-Tool kostet 10 Credits pro erfolgreichem Aufruf. Die Antwortgröße ändert den Preis nicht. Eine volle Seite mit Videos kostet so viel wie ein Profil mit einem Feld.

Die kostenlose Testphase umfasst 1.000 Credits über 30 Tage ohne Karte, also 100 TikTok-Aufrufe. Danach erhält ein aktives Konto weiterhin täglich 100 Credits aufgestockt, sobald sein Kontostand unter 100 fällt, sodass ein Agent mit geringem Volumen dauerhaft auf dem kostenlosen Tarif läuft.

Bezahlte Tarife beginnen bei 49 $ pro Monat für 200.000 Credits, das sind 20.000 Aufrufe. Der Stückpreis sinkt mit dem Volumen, von 2,45 $ pro 1.000 Aufrufen im Einstiegstarif auf 0,99 $ bei Business, 0,83 $ bei Growth und 0,75 $ bei den größten High-Volume-Tarifen.

Ihr Tarif legt auch die Nebenläufigkeit fest. Die kostenlose Testphase erlaubt 1 Anfrage gleichzeitig, Startup 15, Business 30, Growth 50, und die High-Volume-Tarife liegen zwischen 200 und 1.500. Behandeln Sie den Überlauf-Fall in allem Unbeaufsichtigten defensiv, denn ein Agent, der verzweigt, erreicht die Obergrenze eher als Sie.

Eine Anfrage, die mit nicht-200 zurückkommt, wird nicht abgerechnet. Ein erfolgreicher Aufruf, der nichts findet, ist dennoch ein Aufruf.

Tool-Auswahl

Der Abfrageparameter apis entscheidet, welche Tools Ihr Agent sieht. Weniger Tools bedeuten weniger Kontext für Tool-Definitionen und weniger Chancen, dass das Modell zum falschen greift.

?apis=tiktok                     the four tools in this repo
?apis=tiktok,instagram           a social bundle
?apis=tiktok,google_serp         add Google search

Der Parameter nimmt Anbieternamen wie tiktok und einzelne API-Namen wie tiktok_search. Falsch geschriebene Namen werden ignoriert. Wenn jeder Name falsch ist, schlägt die Anfrage mit 400 fehl, und der Body listet sowohl das, was er nicht erkannt hat, als auch jeden gültigen Wert. Wenn Sie den Parameter weglassen, legt derselbe Endpunkt alle 57 HasData-Tools offen.

Wie es sich vergleichen lässt

TikToks eigenes Entwicklerprogramm deckt das allgemeine Lesen öffentlicher Inhalte nicht ab. Die Research API ist durch ein Antragsverfahren abgeschirmt und steht genehmigten akademischen und gemeinnützigen Forschern in einer begrenzten Anzahl von Regionen offen. Die Display API gibt nur die Inhalte des Kontos zurück, das sich über OAuth anmeldet. Weder das eine noch das andere passt zu einem Agenten, der ein beliebiges öffentliches Profil, dessen Videos oder die Kommentare eines Videos lesen muss.

Die meisten anderen TikTok-MCP-Server kapseln einen einzigen inoffiziellen Endpunkt. Dieser hier deckt die vier Lesevorgänge ab, die ein Agent tatsächlich verketet, Profil zu posts zu Kommentaren, plus Suche, sodass ein ganzer Recherchedurchlauf gegen einen einzigen Server läuft.

Was dieser Server nicht tut. Kein Veröffentlichen, keine Direktnachrichten, keine Nur-follower- oder privaten Inhalte, keine Analytik für Konten, die Ihnen nicht gehören. Er lesst, was ein abgemeldeter Besucher sehen kann.

FAQ

Gibt es einen offiziellen TikTok-MCP-Server?

TikTok veröffentlicht keinen. Jede Option wird von jemand anderem gebaut. Dieser wird von HasData gewartet und lesst öffentliche Seiten, weshalb er kein TikTok-Entwicklerkonto benötigt.

Was ist ein TikTok-MCP-Server?

Ein Server, der TikTok-Daten als Tools bereitstellt, die ein AI-Cliient aufrufen kann. Der Client sendet einen Tool-Aufruf über das Model Context Protocol, der Server holt die Daten und gibt strukturiertes JSON zurück, und das Modell arbeitet mit dem Ergebnis und sieht nie eine HTML-Seite. Dieser legt vier Tools offen und läuft remote. Der Client verbindet sich mit einer URL und startet keinen lokalen Prozess.

Brauche ich einen TikTok-API-Schlüssel oder ein Entwicklerkonto?

Nein. Die einzige Berechtigung ist Ihr HasData-Schlüssel. Es gibt kein Entwicklerantrag einzureichen und keinen OAuth-Zustimmungsbidschirm, weil die Tools öffentliche TikTok-Seiten lesen und nicht die TikTok-Entwickler-APIs.

Muss ich etwas hosten oder betreiben?

Nein. Dies ist ein Remote-MCP-Server auf streamable HTTP. Nichts zu installieren, kein Container, den man warm halten muss, kein Prozess, den man neu starten muss.

Sind die Daten live oder gecached?

Live. Jeder Aufruf holt die Daten zum Zeitpunkt der Anfrage und trägt seine eigene requestMetadata.id. Zähler wie Aufrufe und Likes folgen der Seite und bewegen sich also mit der Seite.

Kann ich ein privates Konto lesen?

Nein. Die Tools geben zurück, was ein abgemeldeter Besucher sieht. Die Videos eines privaten Kontos sind nicht öffentlich und daher in keiner Antwort enthalten.

Kann ich Antworten auf Kommentare lesen, nicht nur Kommentare auf oberster Ebene?

Ja. Rufen Sie das comments-Tool mit der id eines Kommentars als commentId auf, und es gibt die Antworten auf diesen Kommentar zurück. Der replyCount eines Kommentars sagt Ihnen, ob es welche gibt.

Kann ich das zusammen mit anderen HasData-APIs verwenden?

Ja. Der Parameter apis nimmt eine Liste, und ?apis=tiktok,instagram gibt Ihrem Agenten die vier TikTok-Tools plus Instagram. Lassen Sie den Parameter weg und Sie erhalten alles.

Compliance und personenbezogene Daten

HasData greift nur auf öffentlich verfügbare Daten zu. Die Nutzungsbedingungen einer Plattform können automatisierten Zugriff einschränken, und Sie sind für Ihre eigene Compliance verantwortlich. Wenn die von Ihnen erhobenen Daten personenbezogene Informationen enthalten, stellen Sie sicher, dass Sie eine rechtmäßige Grundlage dafür gemäß DSGVO, CCPA oder den entsprechenden Regelungen in Ihrer Jurisdiktion haben.

HasData-Links

Entwicklung

Dieses Repository ist Konfiguration und Dokumentation für einen Remote-Server. Es gibt kein Build-Schrit und nichts zu containerisieren.

Die Tests in test/ prüfen den Tool-Vertrag, den Teil, der ohne einen Commit hier kappen kann. Sie prüfen, dass ?apis=tiktok genau vier Tools zurückgibt, dass jedes Tool weiterhin seinen erforderlichen Parameter deklariert, dass sich kein Name geändert hat und dass der verwendete Schlüssel tatsächlich akzeptiert wird. Die letzte Prüfung ruft ein Tool wirklich auf und kostet 10 Credits – das ist der Preis eines Kanarienvogels, der aus dem richtigen Grund scheitern kann.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

Dieselbe Suite läuft in CI bei jedem Push und einmal pro Woche planmäßig, weil sich die Upstream-Tool-Liste ändern kann, ohne dass jemand dieses Repository anfasst. Ein Fehler bedeutet, dass sich die Tool-Liste verschoben hat, der Schlüssel nicht mehr funktioniert oder der Endpunkt nicht erreichbar war, und die Assertion-Meldung sagt, welches.

Mitwirken

Korrekturen an den Tool-Tabellen und den Antwortbeispielen sind der nützlichste Beitrag, weil das die Teile sind, die abdriften. Geben Sie den Aufruf an, den Sie gemacht haben, und die Antwort, die Sie erhalten haben. Pull-Requests aus Forks lassen die Suite ohne Schlüssel laufen, und die Live-Prüfungen werden übersprungen, statt rot zu werden.

Lizenz

MIT. Siehe LICENSE.