TikTok MCP Server

Ein gehosteter Model Context Protocol (MCP)-Server, der Claude, Cursor, Windsurf und jedem anderen MCP-Client vier schreibgeschützte TikTok-Tools bereitstellt. Ein öffentliches Profil abrufen, die Videos eines Kontos durchgehen, die Kommentare zu einem Video lesen und TikTok nach Videos oder Creators durchsuchen – alles als strukturiertes JSON, ohne TikTok-Entwicklerkonto und ohne OAuth.

Der Server liest nur öffentliche Daten, die ein nicht angemeldeter Besucher sehen kann. Er meldet sich nicht an, postet nichts und tritt nicht als Konto auf.

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

Inhalt

• Was du brauchst

• Schnellstart

• Beispiel-Prompts

• Tools

• Fehler und Fehlerpfade

• Preise, kostenloser Tarif 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 erstellbar. Das ist ein Remote-Server, der einfachste Weg ist daher eine URL und ein x-api-key-Header, ohne Container und ganz ohne TikTok-Entwicklerkonto im Ablauf. Ein Client, der nur stdio spricht, erreicht ihn über einen schlanken Launcher, der als @hasdata/tiktok-mcp auf npm und als hasdata-tiktok-mcp auf PyPI veröffentlicht ist, siehe unten.

Schnellstart

Die Server-URL ist für jeden Client dieselbe. Wir haben ihn praktisch in Claude Code und Claude Desktop eingesetzt. Die weiteren Blöcke folgen dem jeweils dokumentierten Format dieser Clients für einen Remote-Server.

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

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

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

Für den Weg über die Konfigurationsdatei: Claude Desktop lädt nur lokale (stdio-)Server, also erreicht er 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 Folgendes zu claude_desktop_config.json hinzu:

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

Python statt Node? Dann nimm stattdessen 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 alle Projekte, oder .cursor/mcp.json für ein einzelnes:

{
  "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 Workspace:

{
  "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 entscheide selbst für das Tool. Jeder Prompt ist mit den dafür nötigen Aufrufen annotiert, denn bei MCP entscheidet das Modell, wie viele Aufrufe es macht, und jeder erfolgreiche Aufruf kostet 10 Credits.

Nimm dir @mrbeast. Zieh das Profil, dann die ersten beiden Seiten der Videos und gib mir den Median der Abspielzahlen über diese Seiten.

Drei Aufrufe, 30 Credits. Das Profil ist ein Aufruf, und jede Seite der Videos ist ein weiterer.

Suche TikTok nach Creators zum Thema „Cold Brew Coffee“ und sortiere die Top Ten danach "followers, jeweils mit Bio.

Ein Aufruf, 10 Credits. Eine Benutzersuche enthält bereits Follower-Zahl und Bio, also braucht es danach keine Profilabfrage mehr.

Nimm eine Video-URL. Lies die Kommentare und sage mir die Gesamtstimmung und die drei meistgelikten Antworten.

Ein Aufruf, 10 Credits. Die Zahlen-ID in der URL genügt für das Kommentar-Tool vollkommen.

Nimm sich dasselbe Video und klappe dann die Antworten unter dem meistgelikten Kommentar auf.

Zwei Aufrufe, 20 Credits. Zuerst die obersten Kommentare, dann ein zweiter Aufruf mit der ID des Kommentars

Suche „asmr“-Videos und rufe dann die Ersteller-Profile der drei mit den höchsten Abrufzahlen ab.

Vier Aufrufe, 40 Credits. Ein Aufruf für die Suche, danach je einer per Profil. Jeder Ersteller in einem Suchergebnis trägt einen direkten Link auf den eigenen Profil-Endpunkt, muss also keinen Handle raten.

Paging kostet pro Seite ja Aufruf. Ein Creatoraudit, das ein Profil liest und dann fünf Seiten mit Videos durch eine Seite durchgeht, sind sechs Aufrufe und 60 Credits. Das Probeabo reicht also für enge Fragen weiter als für offene Crawls.

Tools

Vier Tools, alle schreibgeschützt. Die Beispiele unten sind gekürzte Auszüge aus echten Aufrufen, die Zahlen verschieben sich mit jedem TikTok-Update. Betrachte sie also als Beispiele für strukturellen Aufbau. Jeder Tool-Name verlinkt auf die zugehörige Endpoint-Referenz mit der vollständigen Feldliste.

Die Beispiele zeigen den Payload, nicht die komplette Antwort. Ein tools/call-Ergebnis enthält genau einen Textblock, und dieser Text ist selbst JSON mit url, status, text und json; die gescrappten Daten liegen unter json. In einer rohen JSON-RPC-Antwort wäre der Pfad: result.content[0].text parsen, danach den .json-Teil entnehmen. Ein Chat-Client löst das für dich auf; Code, der direkt irgend GitHub spricht, tut das nicht.

Handles, Video-IDs und Kommentar-IDsGängen ineinander: über. Ein Profil verlinkt zu seinen Videos und jeder Beitrag trägt die eigenen Video-ID fürs Kommentar-Tool, ebenso wie jeder Ersteller in Kommentaren und Suchergebnissen einen hasdataLink für das Profil und einen hasdataPostsLink für die Videos hat. So geht ein Agent von einem Keyword zu einem Creator, weiter zu einem Video und zu dessen Kommentaren, ohne je selbst eine URL zusammenbauen.

TikTok-Profil abrufen

hasdata_tiktok_profile_getTikTokProfile

Ein öffentliches Konto per Handle.

Antwort liefert username, nickname, biography, bioLink, verified, language, createTime, die Avatar-URLs sowie followers, follows, likes, videos und friends als Ganzzahlen. Die Zahlen sind bereits als Zahlen geparst; so vergleicht followers > 1000000 wirklich Zahlen und keine Anzeige-Texte.

Ein Handle, das es nicht gibt, liefert trotzdem requestMetadata.status mit genau ok zurück – nur profile fehlt einfachPrüfe also, ob das Objekt existiert, bevor du username oder irgendein anderes Read-Feld liest; ein Rustuntime bei profile.username wirft sonst auf nichts.

{
  "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 deines Kontovideos für einen Handle, neueste zuerst.

Ein Aufruf liefert rund dreißig Videos + pagination mit hasMore und nestedPageToken für den nächsten page. Eins für die erste Ausgabe verfehlt man, jede nachfolgende Seite. Jedes Videoauflistung enthält id, description, url, duration, die Cover- und abspielbaren Video-URLs, music, sowie die Zahlteller likes, comments, shares, plays, retrieves, collects und reposts als Ganzzahlen.

hashtags und mentions sind nur bei Videos vorhanden, die sie wirklich Nutzen. Auf einer echten Seite mit 27 Videos waren vier mit hashtags und zehn mit mentions–Array abgedeckt. Teste den Schlüssel prüfen und nicht davon ausgehen, dass jedes Video beides hat.

To confirm: "Dich beide" das 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 einzelnen Kommentar.

Jeder Kommentar trägt text, likes, createTime, replyCount sowie einen author, und die Autoren wiederum.bringen den hasdataLink zu Profilen und hasdataPostsLink zu den Videos. Über Avenir/in pagination.totalsteht die Gesamtzahl der Kommentare zum Video, sodass die Tiefe klar ist. Kommentare mitreplyCountother than zero haben Antworten, die du durch erneuten Aufruf mitzältestidalscommentId` erreichst.

{
  "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-Suche

hasdata_tiktok_search_getTikTokSearch (API-Referenz)

Eine Keyword-Suche über Videos oder Creators.

Bei type: video enthält die Antwort Videos in derselben Form wie Posts. Bei type: user enthält sie Creators, jeweils mit username, nickname, signature (die Bio), avatarUrl, followers sowie denselben hasdataLink und hasdataPostsLink, um Weitere ins Profil oder seine Videos zu führen. Ein verified-Flag ist bei Konten vorhanden, die es 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 der Begründung als Text. Der Agent liest also eine Nachricht dort, wo Sie vielleicht eine Statuszeile erwarten würden.

Ein falscher Schlüssel zeigt sich 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 anzeigt. Der erste Tool-Aufruf kommt dann mit isError: true und dem Text HasData API error: 401 Unauthorized zurück. Achten Sie auf diese Zeichenfolge, denn nichts vorher im Ablauf meldet das Problem.

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

Ein Argument, das das Schema eines Tools bricht, wird abgelehnt, bevor daraus ein Scrape wird. Der Server antwortet mit isError: true und dem Text MCP error -32602: Input validation error und nennt das betreffende Feld. Es wird nichts abgerufen und nichts berechnet.

Ein Aufruf, der erfolgreich ist und nichts findet, ist der Fall, der viele hereinfällt. Ein Handle, das nicht existiert, kommt als gewöhnliches Ergebnis mit requestMetadata.status auf ok und schlicht ohne den Daten-Schlüssel zurück. Nichts im Rumpf sagt, dass das Ergebnis leer war. Prüfen Sie auf das Feld, das Sie brauchen, nicht auf einen Fehler.

Eine Kennung, die das Platform ablehnt, liefert 400 mit requestMetadata.status auf error.

Ergebnisse, die Daten tragen, enthalten außerdem eine requestMetadata.id, die sich im Support anzuführen lohnt.

Preise, kostenloser Tarif und Limits

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

Der kostenlose Test umfasst 1.000 Credits über 30 Tage ohne Karte, also 100 TikTok-Aufrufe. Danach erhält ein aktives Konto täglich 100 Credits gutgeschrieben, sobald sein Guthaben unter 100 liegt, sodass ein Agent mit geringem Volumen dauerhaft im kostenlosen Tarif laufen kann.

Bezahlte Tarife beginnen bei 49 $ pro Monat für 200.000 Credits, also 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 bestimmt auch die Parallelität. Der kostenlose Test erlaubt 1 gleichzeitige Anfrage, Startup 15, Business 30, Growth 50, und die High-volume-Tarife laufen mit 200 bis 1.500. Behandeln Sie den Überlauffall in jedem unbeaufsichtigten Prozess defensiv, denn ein .", das auf zweigt online packt, erreicht die Obergrenze vor Ihnen.

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

Tool-Auswahl

Der Abfrageparameter apis bestimmt, welche Tools Ihr Agent sieht. Weniger Tools bedeuten weniger Kontext, der für Tool-Deklarationen aufgewendet wird, und weniger Gelegenheiten, 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 akzeptiert Providernamen wie tiktok und einzelne API-Namen wie tiktok_search. Falsch geschriebene Namen werden ignoriert. Wenn alle Namen falsch sind, schlägt die Anfrage mit 400 fehl, und der Rumpf listet auf, was er nicht erkannt hat, und alle gültigen Werte. Lassen Sie den Parameter weg, und liest man denselben Endpunkt über alle 57 HasData-Tools.

Vergleich mit offiziellen TikTok-APIs

TikToks eigenes Entwicklerprogramm deckt kein allgemeines Lesen öffentlicher Inhalte ab. Die Research API ist hinter einem Antrag verborgen und steht zugelassenen akademischen und gemeinnützigen Forschern in einer begrenzten Anzahl von Regionen offen. Die Display API liefert nur die Inhalte des Kontos, das sich über OAuth anmeldet. Keines beidem passt zu einem Agenten, der ein beliebiges öffentliches Profil, dessen Videos oder die Kommentare zu einem Video lesen muss.

Die meisten anderen TikTok-MCP-Server wickeln einen einzigen inoffiziellen Endpunkt. Dieser hier deckt die vier Lesearten ab, unter ein Agent tatsächlich ver deckt – Profil zu Posts zu Kommentaren – plus Suche, sodass ein ganzer Recherchedurchgang gegen einen einzigen Server läuft.

Was dieser Server nicht tut. Keine Posts, keine Direktnachrichten, keine nur für Follower sichtbaren oder privaten Inhalte, keine Analysen für Konten, die Ihnen nicht gehören. Er liest, was ein abgemeldeter Besucher sehen kann.

FAQ

Gibt es einen offiziellen TikTok-MCP-Server?

Nein, TikTok veröffentlicht einen [Server] selbst nicht. Jede Option ist Ausdrucksstärke eines Dritten. Dieser hier wird von HasData betrieben und liest öffentliche Seiten, weshalb kein TikTok-Entwicklerkonto nötig ist.

Was ist ein TikTok-MCP-Server?

Ein Server, der TikTok-Daten als Tools bereitstellt, die ein KI-Client aufrufen kann. Der Client sendet einen Tool-Aufruf über das Model Context Protocol, der Server holt die Daten und liefert strukturiertes JSON, und das Modell arbeitet mit dem Ergebnis, ohne eine HTML-Seite zu sehen. Dieser Server bietet vier Tools an und läuft entfernt. 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 Zugangsdaten sind Ihr HasData-Schlüssel. Es gibt keinen Entwicklerantrag zu stellen und keinen OAuth-Zustimmungsbildschirm, weil die Tools öffentliche TikTok-Seiten lesen und nicht die TikTok-Entwickler-APIs.

Muss ich etwas hosten oder ausführen?

Nein. Dies ist ein [MCP-Server] im Remote-Betrieb über streamable HTTP. Nichts zu installieren, kein Container, den Sie warmhalten müssen, kein Prozess, den Sie neu starten müssen.

Sind die Daten live oder gezwich?

Live. Jeder Aufruf holen frisch zum Zeitpunkt der Anfrage und trägt eine eigene requestMetadata-ID. Zähler wie Aufrufe und Likes folgen der Seite, also verändern sie sich mit.

Kann ich ein privates Konto lesen?

Nein. Die Tools geben zurück, was ein abgemeldeter Besucher sieht. Ein privates Konto eine Videos sind nicht öffentlich und daher in keiner Antwort enthalten.

Kann ich auch Antworten auf Kommentare lesen, nicht nur die obersten Kommentare?

Ja. Rufen Sie das Kommentierungs-Tool mit einer Kommentar-id als commentId auf, dann erhalten Sie die Antworten zu diesem Kommentar. Ein replyCount eines Kommentars sagt Ihnen, ob es überhaupt Antworten gibt.

Kann ich dies mit anderen HasData-APIs verwenden?

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

Compliance und personenbezogene Daten

HasData greift nur auf öffentlich zugängliche Daten zu. Die Bedingungen einer Plattform können den automatisierten Zugriff beschränken, und Sie sind für Ihre eigen Einhaltung verantwortlich. Wenn die gesammelten Daten personenbezogene Informationen umfassen, stellen Sie sicher, dass eine Rechtsgrundlage dafür vorliegt – nach DSGVO, CCPA oder den entsprechenden Regelungen in Ihrer Rechts-Bedeutung.

HasData-Links

Projekt

Dieses Repository ist Konfiguration und Dokumentation für einen Remote-Server. Es gibt keinenBuild-Schritt und keine Containerisierung.

Die Tests in test/ prüfen den Tool-Vertrag, den Teil, die eine fehlschlagen kann, ohne dass hier ein Commit anfällt. In den Tests wird geprüft, ob ?apis=tiktok genau vier Tools zurückgibt, dass jedes Tool noch sein erforderliches Parameter deklariert, dass sich kein Name geändert hat und dass der verwendete Schlüssel wirklich akzeptiert wird. Der letzte Check ruft ein Tool wirklich auf und verbraucht 10 Credits – so viel kostet ein Kanarienvogel, der aus dem richtigen Grund ausfallen 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 nach Zeitplan, weil sich die Upstream-Tool-Liste ändern kann, ohne dass jemand Tap dieses Repository. Ein Fehler bedeutet: Die Tool-Liste verschoben hat, der Schlüssel nicht mehr funktioniert oder der Endpunkt nicht erreichbar ist; die Behauptungsnachricht enthält die Details.

Beiträge

Korrekturen an der Tool-Tabellen und den Beispiele-Antwortentries dies in den Beispiel-Antwortdiensten sind der wertvollste Beitrag, diese sind die Teile, die am ehesten hochtreiben. Geben Sie den Aufruf und die erhaltene Antwort als Beleg an. Pull Requests aus Forks lassen die Suite ohne Schlüssel laufen, und die Live-Checks werden übersprungen, nicht rot.

Lizenz

MIT. Siehe LICENSE.