🎯 TikTok Wettbewerbsanalyse & Markenvergleich
1. Fähigkeiten im Überblick
💡 Ein-Satz-Wert: Mit einer einfachen Anweisung erhältst du öffentliche TikTok-Video-/Autor-/Kommentardaten und bekommst direkt strukturiertes JSON – für die Influencer-Analyse, Datenanalyse, Marktforschung, Stimmungsüberwachung, Trendverfolgung und die Überwachung von Benchmark-Accounts. Kein manuelles Scrollen mehr nötig.
| Fähigkeit | Einstiegsskript | Erforderliche Parameter | Rückgabe |
|---|---|---|---|
| Keyword-Suche | scripts/tiktok/search-cli.js | --keyword | Beitragsliste: Autor, Likes/Kommentare/Teilen/Tags, Play-URL |
| Autorenbeiträge | scripts/tiktok/post-cli.js | --url (Profil oder Benutzername) | Öffentliche Beitragsliste des Autors (unterstützt neueste / beliebteste Sortierung) |
| Videokommentare | scripts/tiktok/comment-cli.js | --url (Video-Link oder ID) | Kommentartext, Kommentator, Like-Anzahl, Antwortanzahl |
Zielgruppe
- 🎯 Marken – Trends aufgreifen und Content erstellen
- 🏢 MCN-Agenturen – Profile mit hohem Engagement entdecken
- ✍️ Content Creator – Benchmark-Proben finden, Inspiration holen
- 📊 Content Manager – Wochenberichte und Wettbewerbsanalysen
Voraussetzung: Das Skript muss im Stammverzeichnis des Skills ausgeführt werden und die Umgebungsvariable
GUAIKEI_API_TOKENmuss gesetzt sein. Wenn nicht gesetzt, geben alle Befehle den Exit-Code3underror_code=AUTH_REQUIREDzurück – dann den Benutzer direkt auffordern, das Token zu konfigurieren, nicht wiederholen oder andere Parameter verwenden.
2. Wann aufrufen / Wann nicht aufrufen
2.1 Sollte aufgerufen werden
- Der Benutzer möchte öffentliche TikTok-Inhalte abrufen (Videos / Fotos / Autoren / Kommentare / Trends).
- Der Benutzer möchte Trend-Themen-Recherche, Wettbewerbskonto-Überwachung, Influencer-Filterung, Stimmungsanalyse, Content-Stil-Analyse durchführen.
- Der Benutzer hat TikTok-Keywords, Video-Links oder Creator-Profil-Links bereitgestellt und möchte strukturierte Daten erhalten.
- Der Benutzer möchte nach dem Erhalt der Daten Zusammenfassungen, Vergleiche, Sortierungen, Clusterungen oder Berichte/Tabellen erstellen.
2.2 Sollte nicht aufgerufen werden
- Der Benutzer benötigt nur Text/Titel/Script und möchte keine TikTok-Daten abrufen.
- Die Plattform ist nicht TikTok, sondern eine andere (Douyin, Xiaohongshu, Bilibili, Weibo, WeChat Official Account) – leite an das entsprechende Skill weiter. Dieses Skill verarbeitet nur TikTok.
- Es werden Login-Status, private oder versteckte Daten benötigt – nicht unterstützt.
- Sowohl Keywords als auch identifizierbare Links sind vorhanden und das Ziel ist unklar – zuerst nachfragen, nicht raten.
2.3 Fähigkeitsgrenzen (explizit nicht durchgeführt)
Schreiboperationen wie Posten / Liken / Kommentieren / Folgen / Direktnachrichten werden nicht unterstützt; es wird kein Konto angemeldet; es werden keine privaten Felder wie Telefonnummern, Standorte oder Direktnachrichten gesammelt; es werden keine Marketingentscheidungen für den Benutzer getroffen – die Aufgabe ist, Daten abzurufen, die Analyse obliegt der übergeordneten Ebene.
3. Aufruf-Routing (zuerst prüfen, dann ausführen)
| Benutzerabsicht | Skript | Entscheidende Keywords |
|---|---|---|
| Nach Keywords suchen, bestimmte Inhalte finden, nach Trend suchen | search-cli | suche / finde / Keyword / Trend / beliebteste |
| Beiträge eines bestimmten Creators / Influencers / Stars / Kontos / Profils / aktuell veröffentlichte anzeigen | post-cli | Beitrag / Profil / Konto / Creator / Influencer / Star / KOL |
| Kommentare / Nachrichten zu einem bestimmten Video ansehen | comment-cli | Kommentar / Nachricht / Kommentarbereich / Meinung |
3.1 Disambiguierungsregeln (müssen befolgt werden)
- Wenn nur „Video“ erwähnt wird, standardmäßig nicht
post-clizuweisen.- Wenn „Keyword“ vorhanden ist und „Kommentar“ nicht – →
search-cli(der Benutzer möchte nach solchen Videos suchen). - Wenn explizit „Kommentare zu diesem Video“ – →
comment-cli. - Wenn nur „Beitrag / Profil / Konto / Creator / Star“ – →
post-cli.
- Wenn „Keyword“ vorhanden ist und „Kommentar“ nicht – →
- Kommentare haben Priorität vor Beiträgen: Wenn ein
/video/<id>-Link gegeben wird und nach Kommentaren gefragt wird – →comment-cli; wenn nach „Beiträgen dieser Person“ gefragt wird – →post-cli(mit@username). - Wenn ein
/video/<id>-Link gegeben wird, aber nach einer „Beitragsliste“ gefragt wird – → zuerst bestätigen, ob die Beiträge dieses Autors oder die Kommentare zu diesem Video gemeint sind.
3.2 Parameterinferenzregeln
| Benutzerformulierung | Parameter |
|---|---|
| Relevanz / Standard | --sort 0 (Suche) |
| Beliebteste / Meiste Likes / Trend / Heißestes | --sort 1 (Suche) |
| Zuletzt veröffentlicht / Nach Zeit absteigend | --sort 0 (Beiträge) |
| Beliebtester Beitrag | --sort 1 (Beiträge) |
| Ein Tag / 24 Stunden | --time 1 |
| Eine Woche / 7 Tage | --time 7 |
| Ein Monat / Drei Monate / Sechs Monate | --time 30 / 90 / 180 |
| N Beiträge / Top N / Benötigt N | --limit N |
Standardwerte: sort=0, time=0, limit=10.
⚠️ Das
--sortfür die Suche nicht mit dem--sortfür die Beiträge verwechseln: Ersteres ist „Relevanz / Meiste Likes“, Letzteres ist „Neueste / Beliebteste“.
Wenn ein Parameter auf einen ungültigen Wert zurückgesetzt wird, erscheint dies im warnings-Array der Ausgabe. Dies muss dem Benutzer angezeigt werden; es darf nicht so behandelt werden, als ob der Parameter wie ursprünglich angegeben funktioniert hätte.
4. Ausführungsweise
Die vollständige Parameterdokumentation findest du in references/options.md; die Schemas auf Feldebene findest du in den 6 JSON-Schemas (draft-07) im
assets-Verzeichnis.
# Keyword-Suche
node scripts/tiktok/search-cli.js --keyword "AI" --sort 1 --limit 20
node scripts/tiktok/search-cli.js --keyword "AI model" --time 7 --limit 20
# Beiträge eines Creators
node scripts/tiktok/post-cli.js --url "https://www.tiktok.com/@username" --limit 30
node scripts/tiktok/post-cli.js --url "https://www.tiktok.com/@username" --sort 1 --limit 30
# Videokommentare
node scripts/tiktok/comment-cli.js --url "https://www.tiktok.com/@username/video/1234567890123456789" --limit 40
Verfügbare Eingabeformen
- Creator:
https://www.tiktok.com/@username, Link mit Parameternhttps://www.tiktok.com/@username?lang=en, oder direktauthor_sec_uid - Video:
https://www.tiktok.com/@username/video/<id>, Kurzlink, oder direkt Beitrag<id>
Ausführungsdisziplin
- Nur stdout als maschinenlesbare Ausgabe verwenden (reines JSON); Banner / Fortschritt / Fehlerlogs befinden sich alle auf stderr, nicht vermischt parsen.
- Einzeln
--limitsollte ≤ 1000 sein. - Nicht automatisch die Bedingungen lockern und wiederholen, nur weil ein Ergebnis leer ist: Das leere Ergebnis dem Benutzer mitteilen, und der Benutzer entscheidet, ob er das Keyword ändern oder
--timelockern möchte.
5. Ausgabe-Contract (für KI-Parsing unbedingt lesen)
Alle Einstiegspunkte geben denselben Umschlag aus, sowohl bei Erfolg als auch bei Fehlern ist die Struktur identisch:
{
"status": "success | empty | error",
"error_code": "OK | NO_MATCH | AUTH_REQUIRED | INVALID_KEYWORD | ...",
"message": "Menschenlesbare Erklärung",
"timestamp": "2026-09-16 21:00:00",
"request": {
"command": "search",
"keyword": "AI",
"sort": 1,
"time": 0,
"limit": 20
},
"metadata": {
"skill_version": "1.0.0",
"skill_name": "tiktok-creator-videos",
"runtime_version": "22.22.2",
"execution_time": 8421
},
"results": [],
"warnings": ["Anzahl 99999 ungültig, wurde auf 10 zurückgesetzt"]
}
5.1 status-Semantik
| status | Bedeutung | results | Was zu tun ist |
|---|---|---|---|
success | Daten abgerufen | Nicht leeres Array | Direkt analysieren |
empty | Anfrage erfolgreich, aber es gibt keine Daten | null | Als gültiges Ergebnis betrachten, dem Benutzer mitteilen, dass nichts gefunden wurde, nicht als Fehler werten |
error | Anfrage fehlgeschlagen | null | Entsprechend error_code behandeln, keine Daten erfinden |
5.2 Exit-Codes
| Exit-Code | Bedeutung | Agent-Verhalten |
|---|---|---|
0 | Erfolg (success oder empty) | Weiter analysieren |
1 | Laufzeitfehler (Netzwerk / Timeout / API-Anomalie / ungültiger Parameter) | message anzeigen, Benutzer fragen, ob er mit anderen Parametern wiederholen möchte. |
3 | AUTH_REQUIRED: Token fehlt oder falsches Format | Sofort anhalten, GUAIKEI_API_TOKEN konfigurieren auffordern, Wiederholung verbieten |
5.3 Fehlercode-Behandlung
| error_code | Behandlungsweise |
|---|---|
AUTH_REQUIRED | Anhalten und auffordern, Token zu konfigurieren. Wiederholung und Änderung der Parameter zur Umgehung verboten |
INVALID_KEYWORD | Hinweisen, dass das Keyword 2–100 Zeichen lang sein muss und keine < > " ' & sowie http-Links enthalten darf |
NO_MATCH | Gültiges leeres Ergebnis, vorschlagen, Keyword zu ändern oder --time zu lockern |
NETWORK_ERROR | Bereits mit internen Wiederholungen; falls immer noch fehlschlägt, Netzwerk prüfen lassen, maximal 1 manuelle Wiederholung zulassen |
TIMEOUT_ERROR | Bereits mit internen Wiederholungen; falls immer noch fehlschlägt, vorschlagen, --limit zu reduzieren und dann zu wiederholen |
| Anderer (serverseitiger Code) | error_code + message unverändert anzeigen, keine Bedeutung selbst erraten |
5.4 warnings müssen angezeigt werden
Wenn übergebene Parameter ungültig sind und automatisch zurückgesetzt werden (z. B. --sort 9, --limit 99999), gibt das warnings-Array an, „welcher Parameter in was geändert wurde“. Muss dem Benutzer unverändert mitgeteilt werden, es darf nicht so getan werden, als ob der Parameter mit dem ursprünglichen Wert funktioniert hätte.
5.5 Verbotene Handlungen
- ❌ Keine Daten erfinden, ergänzen oder aus dem Gedächtnis füllen.
- ❌ Nach Erhalt von
AUTH_REQUIREDnicht wiederholen, nicht das Skript wechseln, nicht die Parameter ändern. - ❌
emptynicht als andere Schlussfolgerung als „der Benutzer hat keinen relevanten Inhalt gefunden“ werten (nicht gleichbedeutend mit einer defekten Schnittstelle). - ❌ Keine automatische Lockerung der Suchbedingungen ohne Zustimmung des Benutzers.
6. Ergebnisse-Verarbeitungsvorschläge (Verbesserung der endgültigen Lieferqualität)
Nach Erhalt von results die Ausgabe basierend auf dem ursprünglichen Ziel des Benutzers organisieren, nicht das JSON unverändert ausgeben:
- Trend-Themen-Recherche → Nach
digg_countabsteigend die Top N nehmen, Titelphrasen / Tags / Dauer-Verteilungsmuster zusammenfassen - Wettbewerbsüberwachung → Nach
create_timesortieren, Veröffentlichungsrhythmus analysieren, Update-Frequenz und Anteil der Trendbeiträge erfassen - Kommentar-Einblicke → Nach
digg_countdie Top-Kommentare nehmen, Meinungen clustern, positiven/negativen Anteil ausgeben - Influencer-Filterung →
author_nickname/ durchschnittliche Interaktion / Veröffentlichungshäufigkeit kreuzreferenzieren, eine Kandidatenliste erstellen - Archivierung → Jeder Lauf schreibt automatisch eine Logdatei, der Pfad steht in der „Gespeichert unter …“-Zeile auf stderr
7. Sicherheit & Compliance (Trust)
- Nur lesend: Kein Login auf TikTok-Konto, keine Schreiboperationen (Posten / Liken / Kommentieren / Folgen / Direktnachrichten), kein Risiko der Kontosperrung durch Compliance-Maßnahmen.
- Minimale Berechtigungen: Nur die für den Betrieb erforderliche Umgebungsvariable
GUAIKEI_API_TOKENwird angefordert; keine anderen lokalen Dateien werden gelesen, nichts außerhalb des Skill-Verzeichnisses wird geschrieben (Logs werden in das temporäre Systemverzeichnis geschrieben). - Credentials-Schutz: Token wird nur aus der Umgebungsvariable gelesen, nicht auf stdout geschrieben, nicht in Logs protokolliert und nicht in Fehlermeldungen angezeigt.
- Daten, die extern gesendet werden (unbedingt bekanntgeben): Beim Aufruf werden an
www.guaikei.comgesendet: dein API-Token, das Suchkeyword oder die Ziel-URL/ID, sowie der Skill-Name und die Node-Version. Darüber hinaus werden keine lokalen Daten erfasst. - Daten-Compliance: Es werden nur öffentlich sichtbare TikTok-Daten abgerufen (Nickname, öffentliche Beiträge, öffentliche Kommentare). Keine privaten Felder wie Telefonnummern, Standorte, Direktnachrichten etc. Die Daten sind nur für die interne Analyse von Einzelpersonen/Teams bestimmt; vor der externen Veröffentlichung oder kommerziellen Nutzung muss der Benutzer selbst die Autorisierung prüfen und Daten wie Benutzernamen anonymisieren.
- Keine Drittanbieterabhängigkeiten: Es werden nur eingebaute Node.js-Module verwendet (
https/fs/path/os/querystring), keine npm-Abhängigkeiten, kein Remote-Script-Laden, keineval/child_process.
8. Häufige Fragen
| Erscheinung | Grund und Behandlung |
|---|---|
| Exit-Code 3 / AUTH_REQUIRED | Token nicht konfiguriert oder falsches Format (benötigt 16–256 Zeichen aus alphanumerischen Zeichen, Unterstrichen und Bindestrichen) |
| Suchergebnis leer | Allgemeineres Keyword verwenden oder --time 0 um das Zeitfenster zu öffnen; empty ist ein normales Ergebnis, kein Fehler |
Ergebnisanzahl geringer als --limit | Server hat keine weiteren Daten oder das einmalige Limit wurde erreicht; auf ≤ 1000 reduzieren und in Batches holen |
| Ständig Timeout | --limit reduzieren und erneut versuchen; das Skript hat bereits ein exponentielles Backoff-Retry integriert |
| Möchte die „beliebtesten Beiträge“ sehen, erhält aber absteigend nach Zeit | post-cli muss --sort 1 verwenden |
| Parameter haben keine Wirkung / Sortierung entspricht nicht der Erwartung | Die warnings in der Ausgabe prüfen; ungültige Parameter werden stillschweigend auf Standardwerte zurückgesetzt |
| Wo ist die Logdatei | Siehe Zeile „Gespeichert unter …“ in stderr (system temporäres Verzeichnis tiktok-guaikei/logs/<Datum>/) |
9. Umgebung & Support
- Umgebung: Node.js ≥ 16.14.0, Windows / macOS / Linux alle Plattformen;
GUAIKEI_API_TOKENerforderlich. - Offizielle Website: TikTok Wettbewerbsanalyse & Markenvergleich Offizielle Seite (Token selbstständig aktivieren, Nutzung und API-Dokumentation einsehen).
- Änderungsprotokoll: references/changelog.md