Communitygithub.com

why20261/tiktok-competitor-radar

Vergleiche die Content-Performance, Interaktionsdaten und Diskussionstrends von Marken auf TikTok, unterstützt durch historische Datenanalysen, und liefere Unterschiede, Belege und umsetzbare Chancen für Wettbewerbsanalysen, Markenvergleiche, periodische Veränderungen, Markenkommunikations-Reviews und Markenstrategieoptimierung.

Was ist tiktok-competitor-radar?

Dieses Skill ermöglicht es, öffentliche TikTok-Daten (Videos, Autoren, Kommentare) strukturiert abzurufen und als JSON auszugeben. Es eignet sich für die Wettbewerbsanalyse, Influencer-Recherche, Trendverfolgung und Stimmungsanalyse von Marken auf TikTok. Das Skill bietet drei Kernfunktionen: 1) Keyword-Suche mit Filteroptionen nach Beliebtheit/Relevanz und Zeitraum. 2) Abruf von öffentlichen Beiträgen eines bestimmten Creators (über Profil-Link oder Benutzername). 3) Abruf von Kommentaren zu einem bestimmten Video (über Video-Link oder ID). Die Ergebnisse enthalten strukturierte Daten wie Autor, Interaktionsmetriken, Tags und Links. Das Skill ist plattformunabhängig (Node.js) und benötigt nur eine API-Umgebungsvariable (`GUAIKEI_API_TOKEN`). Es handelt sich ausschließlich um einen Lesevorgang – es erfolgen keine Schreiboperationen (Posten, Liken, Kommentieren etc.) auf TikTok. Die Ausgabe folgt einem einheitlichen JSON-Envelope-Format mit Status, Fehlercodes und Warnungen, was eine robuste Integration in KI-Agenten-Workflows ermöglicht.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add why20261/tiktok-competitor-radar

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

🎯 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ähigkeitEinstiegsskriptErforderliche ParameterRückgabe
Keyword-Suchescripts/tiktok/search-cli.js--keywordBeitragsliste: Autor, Likes/Kommentare/Teilen/Tags, Play-URL
Autorenbeiträgescripts/tiktok/post-cli.js--url (Profil oder Benutzername)Öffentliche Beitragsliste des Autors (unterstützt neueste / beliebteste Sortierung)
Videokommentarescripts/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_TOKEN muss gesetzt sein. Wenn nicht gesetzt, geben alle Befehle den Exit-Code 3 und error_code=AUTH_REQUIRED zurü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)

BenutzerabsichtSkriptEntscheidende Keywords
Nach Keywords suchen, bestimmte Inhalte finden, nach Trend suchensearch-clisuche / finde / Keyword / Trend / beliebteste
Beiträge eines bestimmten Creators / Influencers / Stars / Kontos / Profils / aktuell veröffentlichte anzeigenpost-cliBeitrag / Profil / Konto / Creator / Influencer / Star / KOL
Kommentare / Nachrichten zu einem bestimmten Video ansehencomment-cliKommentar / Nachricht / Kommentarbereich / Meinung

3.1 Disambiguierungsregeln (müssen befolgt werden)

  1. Wenn nur „Video“ erwähnt wird, standardmäßig nicht post-cli zuweisen.
    • 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.
  2. 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).
  3. 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

BenutzerformulierungParameter
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 --sort für die Suche nicht mit dem --sort fü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 Parametern https://www.tiktok.com/@username?lang=en, oder direkt author_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 --limit sollte ≤ 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 --time lockern 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

statusBedeutungresultsWas zu tun ist
successDaten abgerufenNicht leeres ArrayDirekt analysieren
emptyAnfrage erfolgreich, aber es gibt keine DatennullAls gültiges Ergebnis betrachten, dem Benutzer mitteilen, dass nichts gefunden wurde, nicht als Fehler werten
errorAnfrage fehlgeschlagennullEntsprechend error_code behandeln, keine Daten erfinden

5.2 Exit-Codes

Exit-CodeBedeutungAgent-Verhalten
0Erfolg (success oder empty)Weiter analysieren
1Laufzeitfehler (Netzwerk / Timeout / API-Anomalie / ungültiger Parameter)message anzeigen, Benutzer fragen, ob er mit anderen Parametern wiederholen möchte.
3AUTH_REQUIRED: Token fehlt oder falsches FormatSofort anhalten, GUAIKEI_API_TOKEN konfigurieren auffordern, Wiederholung verbieten

5.3 Fehlercode-Behandlung

error_codeBehandlungsweise
AUTH_REQUIREDAnhalten und auffordern, Token zu konfigurieren. Wiederholung und Änderung der Parameter zur Umgehung verboten
INVALID_KEYWORDHinweisen, dass das Keyword 2–100 Zeichen lang sein muss und keine < > " ' & sowie http-Links enthalten darf
NO_MATCHGültiges leeres Ergebnis, vorschlagen, Keyword zu ändern oder --time zu lockern
NETWORK_ERRORBereits mit internen Wiederholungen; falls immer noch fehlschlägt, Netzwerk prüfen lassen, maximal 1 manuelle Wiederholung zulassen
TIMEOUT_ERRORBereits 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_REQUIRED nicht wiederholen, nicht das Skript wechseln, nicht die Parameter ändern.
  • ❌ empty nicht 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_count absteigend die Top N nehmen, Titelphrasen / Tags / Dauer-Verteilungsmuster zusammenfassen
  • Wettbewerbsüberwachung → Nach create_time sortieren, Veröffentlichungsrhythmus analysieren, Update-Frequenz und Anteil der Trendbeiträge erfassen
  • Kommentar-Einblicke → Nach digg_count die 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_TOKEN wird 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.com gesendet: 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, kein eval / child_process.

8. Häufige Fragen

ErscheinungGrund und Behandlung
Exit-Code 3 / AUTH_REQUIREDToken nicht konfiguriert oder falsches Format (benötigt 16–256 Zeichen aus alphanumerischen Zeichen, Unterstrichen und Bindestrichen)
Suchergebnis leerAllgemeineres Keyword verwenden oder --time 0 um das Zeitfenster zu öffnen; empty ist ein normales Ergebnis, kein Fehler
Ergebnisanzahl geringer als --limitServer 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 Zeitpost-cli muss --sort 1 verwenden
Parameter haben keine Wirkung / Sortierung entspricht nicht der ErwartungDie warnings in der Ausgabe prüfen; ungültige Parameter werden stillschweigend auf Standardwerte zurückgesetzt
Wo ist die LogdateiSiehe Zeile „Gespeichert unter …“ in stderr (system temporäres Verzeichnis tiktok-guaikei/logs/<Datum>/)

9. Umgebung & Support

Verwandte Skills