Communitygithub.com

why20261/tiktok-insight

Outil d'analyse concurrentielle TikTok : surveille les performances de trafic des concurrents en temps réel, décortique les vidéos de référence, analyse les stratégies de trafic et construit des bibliothèques de mots-clés. Idéal pour les marques et créateurs TikTok.

Qu'est-ce que tiktok-insight ?

Cette compétence permet aux agents IA d'analyser en profondeur les données publiques de TikTok pour la veille concurrentielle, la recherche de tendances et l'optimisation de contenu. Elle offre trois capacités principales : la recherche par mots-clés (triable par popularité ou pertinence, filtrage temporel), la récupération des publications d'un créateur (par lien de profil ou nom d'utilisateur, tri chronologique ou par popularité), et l'extraction des commentaires d'une vidéo (avec données d'interaction, auteur et structure JSON normalisée). L'outil est conçu pour les marques, les agences MCN, les créateurs de contenu et les responsables marketing souhaitant surveiller leurs concurrents, identifier les influenceurs, analyser les commentaires et découvrir des sujets viraux. Il s'exécute via des scripts Node.js en ligne de commande, nécessite la variable d'environnement `GUAIKEI_API_TOKEN`, et retourne systématiquement des données structurées au format JSON. Une attention particulière est portée à la sécurité (lecture seule, pas de connexion à un compte TikTok) et à la gestion des erreurs (codes de sortie, messages d'erreur explicites).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add why20261/tiktok-insight

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

🎯 Analyse concurrentielle TikTok

1. Aperçu des capacités

💡Valeur en une phrase : Une instruction simple pour obtenir les données publiques des vidéos/auteurs/commentaires TikTok, directement au format JSON structuré – pour la sélection d'influenceurs, l'analyse de données, les études de marché, la surveillance d'opinion, les sujets viraux, le suivi de comptes concurrents, l'analyse des commentaires et le tracking des tendances, sans avoir à parcourir TikTok manuellement.

CapacitéScript d'entréeParamètres obligatoiresRetourne
Recherche par mot-cléscripts/tiktok/search-cli.js--keywordListe de publications : auteur, likes/commentaires/partages/favoris, tags, URL de lecture
Publications d'un créateurscripts/tiktok/post-cli.js--url (profil ou nom d'utilisateur)Liste des publications publiques du créateur (tri chronologique ou par popularité)
Commentaires d'une vidéoscripts/tiktok/comment-cli.js--url (lien vidéo ou ID)Texte du commentaire, auteur, nombre de likes, nombre de réponses

Public cible

  • 🎯 Marques – Créer du contenu de marque en surfant sur les tendances
  • 🏢 Agences MCN – Détecter les comptes à fort potentiel d'engagement
  • ✍️ Créateurs de contenu – Trouver des références et de l'inspiration
  • 📊 Responsables marketing – Sujets de rapports hebdomadaires et analyse concurrentielle

Prérequis : Doit être exécuté depuis le répertoire racine de la compétence, et la variable d'environnement GUAIKEI_API_TOKEN doit être configurée. Si elle n'est pas configurée, toutes les commandes retournent le code de sortie 3, error_code=AUTH_REQUIRED – dans ce cas, indiquez directement à l'utilisateur de configurer le Token, ne réessayez pas, ne modifiez pas les paramètres.


2. Quand appeler / Quand ne pas appeler

2.1 Quand appeler

  • L'utilisateur souhaite consulter le contenu public de TikTok (vidéos / images / auteurs / commentaires / tendances).
  • L'utilisateur cherche à faire une recherche de sujets viraux, une surveillance de comptes concurrents, une sélection d'influenceurs, une analyse d'opinion par les commentaires, une décomposition stylistique de contenu.
  • L'utilisateur a déjà fourni un mot-clé TikTok, un lien vidéo, un lien de profil de créateur, et souhaite obtenir des données structurées.
  • L'utilisateur souhaite ensuite analyser, comparer, trier, regrouper, ou produire un rapport / tableau à partir des données obtenues.

2.2 Quand ne pas appeler

  • L'utilisateur ne demande que du texte / titre / script, sans avoir besoin de données TikTok.
  • La plateforme n'est pas TikTok, mais une autre (Douyin, Xiaohongshu, Bilibili, Weibo, WeChat) → rediriger vers la compétence correspondante. Cette compétence ne traite que TikTok.
  • Demande de données nécessitant une connexion, privées, ou masquées → non supporté.
  • A la fois un mot-clé et un lien identifiable mais objectif flou → demander d'abord, ne pas deviner.

2.3 Limites (explicitement non supportées)

Toute opération d'écriture (publication, like, commentaire, abonnement, message privé) n'est pas supportée ; pas de connexion à un compte ; pas de collecte de numéros de téléphone, positions, messages privés ; pas de décision marketing à la place de l'utilisateur – le rôle est de récupérer les données, l'analyse est laissée à l'utilisateur.


3. Routage des appels (d'abord déterminer, puis exécuter)

Intention de l'utilisateurScriptMots-clés de décision
Rechercher un mot-clé, trouver un type de contenu, trouver des vidéos viralessearch-clirecherche / chercher / mot-clé / viral / le plus populaire
Voir les publications d'un créateur / influenceur / célébrité, son profil, son compte, ses publications récentespost-clipublications / profil / compte / créateur / influenceur / KOL
Voir les commentaires d'une vidéocomment-clicommentaire / avis / commentaires

3.1 Règles de désambiguïsation (impératives)

  1. Si "vidéo" apparaît seul, ne pas assigner par défaut à post-cli.
    • Avec "mot-clé" et sans "commentaire" → search-cli (l'utilisateur cherche ce type de vidéos).
    • Clairement "les commentaires / avis sur cette vidéo" → comment-cli.
    • Seulement si "publications / profil / compte / créateur / influenceur" apparaît → post-cli.
  2. Commentaires prioritaires sur publications : si le lien donné est /video/<id> et la question porte sur les commentaires → comment-cli ; si la question est "les publications de cette personne" → post-cli (avec @username).
  3. Si l'utilisateur donne un lien /video/<id> mais demande "la liste des publications" → confirmer d'abord s'il veut les publications de l'auteur ou les commentaires de la vidéo.

3.2 Règles d'inférence des paramètres

Ce que dit l'utilisateurParamètre
Pertinence / par défaut--sort 0 (recherche)
Le plus populaire / le plus aimé / viral / le plus tendance--sort 1 (recherche)
Les plus récents / ordre chronologique inverse--sort 0 (publications)
Les publications les plus populaires--sort 1 (publications)
Un jour / 24 heures--time 1
Une semaine / 7 jours--time 7
Un mois / trois mois / six mois--time 30 / 90 / 180
N publications / les N premières / je veux N--limit N

Valeurs par défaut : sort=0, time=0, limit=10.

⚠️ Ne pas confondre --sort de la recherche et --sort des publications : le premier est "pertinence / plus de likes", le second est "le plus récent / le plus populaire".

Toute valeur de paramètre invalide et automatiquement remplacée apparaîtra dans le tableau warnings du JSON de sortie et doit être signalée à l'utilisateur, sans faire comme si la valeur d'origine avait été utilisée.


4. Mode d'exécution

Documentation complète des paramètres dans references/options.md ; les schémas JSON au niveau des champs se trouvent dans les 6 fichiers sous assets/ (draft-07).

# Recherche par mot-clé
node scripts/tiktok/search-cli.js --keyword "IA" --sort 1 --limit 20
node scripts/tiktok/search-cli.js --keyword "modèle IA" --time 7 --limit 20

# Publications d'un créateur
node scripts/tiktok/post-cli.js --url "https://www.tiktok.com/@nom_utilisateur" --limit 30
node scripts/tiktok/post-cli.js --url "https://www.tiktok.com/@nom_utilisateur" --sort 1 --limit 30

# Commentaires d'une vidéo
node scripts/tiktok/comment-cli.js --url "https://www.tiktok.com/@nom_utilisateur/video/1234567890123456789" --limit 40

Formats d'entrée valides

  • Créateur : https://www.tiktok.com/@nom_utilisateur, lien avec paramètres https://www.tiktok.com/@nom_utilisateur?lang=en, ou directement author_sec_uid
  • Vidéo : https://www.tiktok.com/@nom_utilisateur/video/<id>, lien court, ou directement l'ID <id>

Discipline d'exécution

  • Ne considérer que la sortie standard (stdout) comme lisible par machine (JSON pur) ; les bannières / barres de progression / journaux d'erreur vont vers stderr, à ne pas mélanger.
  • Pour un seul appel, --limit doit être ≤ 1000 de préférence.
  • Ne pas relâcher automatiquement les critères en cas de résultat vide : d'abord informer l'utilisateur du résultat vide, c'est à lui de décider de changer de mot-clé ou d'élargir --time.

5. Contrat de sortie (lecture obligatoire pour l'IA)

Toutes les entrées produisent la même enveloppe, avec une structure identique pour le succès et l'échec :

{
  "status": "success | empty | error",
  "error_code": "OK | NO_MATCH | AUTH_REQUIRED | INVALID_KEYWORD | ...",
  "message": "description lisible par l'humain",
  "timestamp": "2026-09-16 21:00:00",
  "request": {
    "command": "search",
    "keyword": "IA",
    "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": ["La valeur 99999 n'est pas valide, elle a été remplacée par 10"]
}

5.1 Sémantique de status

statusSignificationresultsQue faire
successDonnées récupéréesTableau non videAnalyser directement
emptyRequête réussie, mais pas de donnéesnullConsidérer comme un résultat valide, informer l'utilisateur qu'aucun résultat n'a été trouvé, ne pas traiter comme une erreur
errorÉchec de la requêtenullTraiter selon error_code, ne pas inventer de données

5.2 Codes de sortie

Code de sortieSignificationComportement de l'agent
0Succès (success ou empty)Continuer l'analyse
1Erreur d'exécution (réseau / timeout / exception d'API / paramètre invalide)Afficher message, demander à l'utilisateur s'il veut réessayer avec d'autres paramètres
3AUTH_REQUIRED : Token manquant ou mal formatéArrêter immédiatement, indiquer de configurer GUAIKEI_API_TOKEN, interdire de réessayer

5.3 Gestion des codes d'erreur

error_codeMéthode de traitement
AUTH_REQUIREDArrêter et indiquer de configurer le Token. Interdire de réessayer ou de contourner en modifiant les paramètres
INVALID_KEYWORDIndiquer que le mot-clé doit faire 2 à 100 caractères, ne peut pas contenir < > " ' & ni de lien http
NO_MATCHRésultat vide valide, suggérer de changer de mot-clé ou d'élargir --time
NETWORK_ERRORNouvelle tentative intégrée ; si toujours en échec, indiquer de vérifier le réseau, réessayer manuellement au maximum 1 fois
TIMEOUT_ERRORNouvelle tentative intégrée ; si toujours en échec, suggérer de réduire --limit puis réessayer
Autres (codes serveur)Afficher error_code + message tels quels, ne pas deviner la signification

5.4 warnings doit être signalé

Lorsque des paramètres invalides sont automatiquement corrigés (ex : --sort 9, --limit 99999), le tableau warnings explique "quel paramètre a été modifié en quoi". Doit être communiqué textuellement à l'utilisateur, sans faire comme si les paramètres d'origine avaient été utilisés.

5.5 Comportements interdits

  • ❌ Ne pas inventer, ne pas compléter, ne pas remplir de données de mémoire.
  • ❌ En recevant AUTH_REQUIRED, ne pas réessayer, ne pas changer de script, ne pas modifier les paramètres.
  • ❌ Ne pas considérer empty comme autre chose que "le contenu demandé par l'utilisateur n'existe pas" (ce n'est pas une panne de l'interface).
  • ❌ Ne pas élargir automatiquement les critères de recherche sans le consentement de l'utilisateur.

6. Conseils d'exploitation des résultats (pour améliorer la qualité finale)

Une fois results récupéré, organiser la sortie en fonction de l'objectif initial de l'utilisateur, plutôt que de restituer le JSON brut :

  • Recherche de sujets → Trier par digg_count décroissant, prendre le Top N, résumer les structures de titres / tags / distribution des durées
  • Surveillance concurrentielle → Ordonner par create_time pour voir la fréquence de publication, calculer le ratio de contenu viral
  • Analyse des commentaires → Trier les commentaires populaires par digg_count et faire un clustering d'opinions, donner le ratio positif/négatif
  • Sélection d'influenceurs → Croiser author_nickname / engagement moyen / fréquence de publication, donner une liste de candidats
  • Archivage → Chaque exécution écrit automatiquement un fichier journal, le chemin est donné dans la ligne "Enregistré dans …" de stderr

7. Sécurité et conformité (Trust)

  • Lecture seule : Pas de connexion à un compte TikTok, aucune opération d'écriture (publication, like, commentaire, abonnement, message privé), aucun risque de bannissement.
  • Privilèges minimaux : Seule la variable d'environnement GUAIKEI_API_TOKEN est nécessaire ; ne lit aucun autre fichier local, n'écrit rien en dehors du répertoire de la compétence (les logs sont écrits dans le répertoire temporaire système).
  • Protection des identifiants : Le Token n'est lu que depuis la variable d'environnement, jamais écrit dans stdout, les logs, ni les messages d'erreur.
  • Portée des données envoyées (à connaître absolument) : Lors de l'appel, les données suivantes sont envoyées à www.guaikei.com : votre Token API, le mot-clé de recherche ou l'URL/ID cible, ainsi que le nom de la compétence et la version de Node. Aucune autre information locale n'est collectée.
  • Conformité des données : Seules les données publiquement visibles de TikTok sont récupérées (pseudonyme, publications publiques, commentaires publics). Aucune donnée privée (numéro de téléphone, position, message privé). Les données sont destinées à une analyse individuelle ou en équipe ; avant toute diffusion publique ou utilisation commerciale, assurez-vous des autorisations et anonymisez les pseudonymes.
  • Aucune dépendance tierce : Utilise uniquement les modules natifs de Node.js (https / fs / path / os / querystring), pas de dépendance npm, pas de chargement de script distant, pas de eval / child_process.

8. Questions fréquentes

PhénomèneCause et traitement
Code de sortie 3 / AUTH_REQUIREDToken non configuré ou mal formaté (doit être une chaîne de 16 à 256 caractères alphanumériques et underscores)
Résultat de recherche videChanger pour un mot-clé plus général, ou --time 0 pour enlever la limite de temps ; empty est un résultat normal, pas une erreur
Nombre de résultats inférieur à --limitLe serveur n'a plus de résultats à fournir, ou la limite unique a été atteinte ; réduire à ≤ 1000 pour récupérer par lots
Timeout persistantRéduire --limit puis réessayer ; le script intègre une nouvelle tentative avec backoff exponentiel
Je veux voir les "publications les plus populaires" mais j'obtiens un ordre chronologique inversePour post-cli, utiliser --sort 1
Les paramètres ne semblent pas pris en compte / ordre différent des attentesVérifier les warnings dans la sortie ; les paramètres invalides sont silencieusement remplacés par les valeurs par défaut
Où sont les fichiers journaux ?Voir la ligne "Enregistré dans …" dans stderr (dans le répertoire temporaire système tiktok-guaikei/logs/<date>/)

9. Environnement et support

Skills associés