Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Reçoit des liens ou du texte de partage de vidéos courtes (Douyin, Xiaohongshu, WeChat Video Channel), interroge les données des œuvres/comptes, extrait les transcriptions vocales et les archive en Markdown par auteur et titre.

Qu'est-ce que Tony-Claude-Code-Skills ?

Cette compétence (skill) permet d'extraire et d'archiver des informations structurées à partir de vidéos courtes provenant de plateformes chinoises comme Douyin, Xiaohongshu (RED) et WeChat Video Channel. Elle s'appuie sur deux services externes : TikHub pour les données structurées (profil, statistiques, métadonnées) et QingDou pour la transcription vocale. L'utilisateur fournit un lien ou un texte de partage, et la compétence renvoie un résumé JSON ainsi qu'un fichier Markdown sauvegardé localement. Avant toute exécution, un pré-vérification des clés API est effectuée pour déterminer les capacités disponibles (données, transcription, les deux ou aucune). En l'absence de clés, la compétence guide l'utilisateur, en français simple, pour acheter et configurer les services sans jamais exposer les clés dans la conversation. Elle supporte les modes 'data' (données uniquement), 'transcript' (transcription uniquement) et 'both' (les deux). Les plateformes actuellement supportées pour les données TikHub sont Douyin, Xiaohongshu et WeChat Video Channel ; d'autres plateformes reconnues par QingDou peuvent bénéficier de la transcription seule. La compétence est conçue pour les développeurs et utilisateurs d'agents IA comme Claude Code, Cursor ou Codex, dans le cadre d'outils de veille et d'analyse de contenu vidéo. Le projet est open source et gratuit, sans affiliation avec les services tiers.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/dbs-video-extract

Demander à votre IA préférée

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

Documentation

dbs-video-extract : Extraction d'informations de vidéos courtes

Objectif : traiter avec une seule entrée le même texte de partage d'une vidéo courte. TikHub fournit les données structurées de Douyin, Xiaohongshu (RED) et WeChat Video Channel ; QingDou fournit la transcription vocale de la vidéo courte ; le résultat final est un résumé des données et le chemin du fichier Markdown de la transcription.

Vérification préalable des clés d'accès

Avant toute tâche d'extraction, exécutez d'abord une vérification en lecture seule :

python3 scripts/extract_video.py --check-keys

Traitez selon credential_state :

ÉtatCapacitéInformation à communiquer à l'utilisateur
completeDonnées et transcription disponiblesLes deux parties peuvent être exécutées
data_onlySeule la requête TikHub est disponibleSeules les données des œuvres/comptes peuvent être obtenues, pas de transcription vocale
transcript_onlySeule la transcription QingDou est disponibleSeule la transcription vocale peut être obtenue, pas de données TikHub
unavailableAucune des deux parties n'est disponibleActuellement indisponible ; expliquez d'abord les clés d'accès, puis guidez l'utilisateur pour l'achat et la configuration

Continuez même si une seule clé est présente, sans exiger que l'utilisateur complète l'autre. Avant l'exécution, précisez clairement quelle partie peut être traitée et réduisez le mode à celle-ci par défaut. Si l'utilisateur insiste pour both, conservez les résultats du côté disponible et marquez l'autre côté comme manquant de clé.

Si les deux clés manquent, arrêtez l'extraction. N'utilisez pas directement les termes « clé API » ou « authentification d'interface » comme conclusion. Expliquez d'abord avec cette phrase :

Pour que cette compétence fonctionne, vous devez d'abord souscrire à des services de données externes. La clé API est un identifiant fourni par le prestataire après souscription ; on peut la voir comme un laissez-passer spécial de cette compétence pour appeler le service. Vous n'avez pas besoin de comprendre les détails techniques, et ne la partagez pas dans la conversation.

Ensuite dites à l'utilisateur : « Aucun des deux services n'est actuellement souscrit. Sans acheter et configurer au moins l'un d'eux, cette compétence ne peut pas être utilisée. » Puis suivez references/api-setup.md pour finaliser le choix, l'achat, la sauvegarde des clés et le test de connexion.

Ne payez pas à la place de l'utilisateur, n'acceptez pas les conditions de service et ne manipulez pas la clé complète. N'exigez pas que l'utilisateur envoie la clé dans la conversation. Le lien d'achat, les étapes guidées, le script de configuration sécurisée et le test de connexion se trouvent dans references/api-setup.md.

Chaque fois que vous montrez une adresse d'achat ou de recharge à l'utilisateur, vous devez d'abord afficher l'avertissement suivant sans l'omettre ni le modifier :

dbskill est un projet open source gratuit, sans affiliation, partenariat ou intérêt commercial avec TikHub ou QingDou. Le rechargement est une décision personnelle de l'utilisateur ; les transactions, services, litiges et risques associés relèvent de la responsabilité de l'utilisateur ; sauf disposition légale contraire, dbskill décline toute responsabilité.

Ne répétez pas cet avertissement si l'utilisateur n'est pas en phase d'achat ou de recharge.

Exigences de dialogue en l'absence de clé

En l'absence d'un service, la réponse doit suivre ce chemin continu :

  1. Expliquez d'abord la clé API en langage simple ;
  2. Laissez l'utilisateur choisir en fonction du résultat : fonctionnalité complète, données uniquement, transcription uniquement ;
  3. Expliquez quel service est nécessaire pour chaque choix et ce qui manque si un seul est acheté ;
  4. Affichez l'avertissement légal fixe, puis l'adresse de recharge correspondante ;
  5. Indiquez étape par étape : inscription/connexion, consultation des forfaits, recharge, accès au centre personnel ou à la page de gestion des clés, obtention de la clé ;
  6. Dites à l'utilisateur de ne pas envoyer la clé dans la conversation, mais de répondre « TikHub rechargé », « QingDou rechargé » ou « Les deux sont rechargés » ;
  7. Une fois que l'utilisateur a confirmé le rechargement, guidez-le pour exécuter le script de configuration sécurisée dans le terminal local :
python3 scripts/configure_api_key.py tikhub
python3 scripts/configure_api_key.py qingdou

Le script lit discrètement la clé dans le terminal et la sauvegarde dans une configuration locale privée ; ne montrez jamais la clé complète dans les commandes, réponses ou journaux. Après la sauvegarde, réexécutez --check-keys jusqu'à ce que l'état correspondant devienne disponible.

N'envoyez pas seulement un lien en une fois, et ne supposez pas que l'utilisateur sait où trouver la clé. Si le nom de la page du prestataire change, guidez avec des emplacements alternatifs comme « Centre personnel », « Clé API », « Gestion des clés », « Paramètres développeur » ; si toujours introuvable, demandez à l'utilisateur d'envoyer une capture d'écran de la page avec le compte, le solde et la clé masqués, puis continuez à localiser.

Si l'utilisateur invoque seulement cette compétence sans fournir de lien ni préciser le type de résultat souhaité, après la vérification préalable, ne faites que deux choses : expliquez la clé API, puis demandez à l'utilisateur de répondre 1, 2 ou 3 pour choisir la fonctionnalité complète, les données uniquement ou la transcription uniquement. Après avoir reçu le choix, affichez l'avertissement légal, l'adresse de recharge correspondante et les étapes d'achat. Si l'utilisateur a déjà envoyé un lien vidéo ou demandé explicitement une extraction complète, choisissez par défaut la fonctionnalité complète sans redemander.

Exécution par défaut

Utilisez de préférence l'entrée standard pour éviter que les caractères spéciaux du texte de partage soient interprétés par le Shell :

python3 scripts/extract_video.py \
  --output-dir "/chemin/absolu/transcriptions_videos_courtes" \
  --stdin

Le mode par défaut est both :

  1. Extrayez le lien du texte de partage complet ;
  2. Appelez le MCP TikHub en fonction de la plateforme du lien : Douyin supporte la page d'accueil de l'utilisateur ou une œuvre individuelle, Xiaohongshu et WeChat Video Channel supportent une vidéo individuelle ;
  3. Soumettez le texte de partage complet à l'API QingDou, interrogez jusqu'à obtention de la transcription ;
  4. Enregistrez la transcription sous {répertoire_sortie}/{auteur}/{titre}.md ;
  5. Générez un résumé JSON incluant l'état des clés, le résumé des données TikHub et le chemin du fichier de transcription.

Si l'un des côtés (TikHub ou QingDou) échoue, continuez avec l'autre côté et marquez partial_success dans le résumé. Les résultats déjà obtenus ne doivent pas être supprimés en raison d'un échec unilatéral.

Modes optionnels

Ne basculez que si l'utilisateur ne demande explicitement qu'un seul côté, ou si la vérification préalable confirme qu'une seule clé est disponible :

python3 scripts/extract_video.py --mode data --stdin
python3 scripts/extract_video.py --mode transcript --stdin
  • data : interroge uniquement les données TikHub (Douyin, Xiaohongshu, WeChat Video Channel) ;
  • transcript : extrait uniquement la transcription (plateformes supportées par l'API QingDou) ;
  • both : exécute les deux côtés simultanément.

Si la même source existe déjà, ignorez l'écriture de la transcription par défaut pour protéger les modifications de l'utilisateur ; si l'utilisateur demande explicitement une régénération, ajoutez --overwrite. Ajoutez --raw-data si vous avez besoin de la réponse TikHub complète.

Clés et coûts

Le script lit les clés dans l'ordre suivant :

  1. Variables d'environnement : TIKHUB_API_KEY, QINGDOU_API_KEY ;
  2. Fichier local spécifié par l'utilisateur : TIKHUB_API_KEYS_FILE, QINGDOU_API_KEYS_FILE ;
  3. ~/.config/dbs/API_Keys.md ;
  4. Trousseau macOS : dbs-tikhub-api-key, dbs-qingdou-api-key.

N'écrivez jamais les clés dans la compétence, les paramètres de commande, le Markdown, Git ou les journaux. Les requêtes TikHub et les transcriptions QingDou peuvent être facturées ; informez-en l'utilisateur avant l'exécution. Si l'utilisateur a déjà demandé explicitement l'extraction, il n'est pas nécessaire de confirmer à nouveau.

Limites des données

  • TikHub gère les profils d'œuvres/comptes, les statistiques et les métadonnées média ; pour Douyin, privilégiez l'App V3, ne faites qu'un seul repli vers le Web si aucune donnée valide ; pour Xiaohongshu, utilisez l'App V2 pour les notes vidéo ; pour WeChat Video Channel, utilisez Channels V2 pour les détails d'une œuvre.
  • QingDou gère la transcription vocale. Le contenu textuel est conservé fidèlement tel que renvoyé par l'API, sans ajout, révision ou correction.
  • Actuellement, l'analyse de données TikHub prend en charge Douyin, Xiaohongshu et WeChat Video Channel ; d'autres plateformes reconnues par QingDou peuvent toujours bénéficier de l'extraction de transcription uniquement.
  • Les limitations de visibilité (public, supprimé, privé, droits d'auteur) sont respectées selon les réponses de l'interface ; aucune tentative de contournement.
  • Ne téléchargez pas automatiquement de médias, ne publiez pas de contenu, ne soumettez pas à Git et ne faites pas de push.

Les détails d'appel TikHub se trouvent dans references/tikhub-api.md ; les codes d'état et la logique de compatibilité QingDou se trouvent dans references/qingdou-api.md. Ne lisez ces documents que lors du débogage ou de la maintenance de la partie correspondante.

Livraison

Après exécution, fournissez un rapport concis :

  • Quelle clé API est configurée et l'étendue de capacité disponible ;
  • Si la requête de données a réussi, l'outil MCP utilisé, et si un repli App → Web a eu lieu ;
  • Les données clés de l'œuvre/compte ;
  • Si la transcription a réussi, le chemin absolu du Markdown généré ou ignoré ;
  • La raison spécifique de l'absence de clé ou de l'échec d'exécution ;
  • Si l'interface a explicitement indiqué une facturation.

Ne montrez pas la clé API, le batchId ou tout autre identifiant interne inutile dans la réponse.

Terminez après la tâche en cours. Ne donnez une brève indication que si l'utilisateur demande explicitement l'étape suivante et que /dbs est déjà installé dans l'environnement : « Si vous n'êtes pas sûr de la suite, vous pouvez entrer /dbs. »

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-Skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

shengdabai/Tony-Claude-Code-Skills

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

shengdabai/Tony-Claude-Code-Skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

shengdabai/Tony-Claude-Code-Skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Skills associés