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 :
| État | Capacité | Information à communiquer à l'utilisateur |
|---|---|---|
complete | Données et transcription disponibles | Les deux parties peuvent être exécutées |
data_only | Seule la requête TikHub est disponible | Seules les données des œuvres/comptes peuvent être obtenues, pas de transcription vocale |
transcript_only | Seule la transcription QingDou est disponible | Seule la transcription vocale peut être obtenue, pas de données TikHub |
unavailable | Aucune des deux parties n'est disponible | Actuellement 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 :
- Expliquez d'abord la clé API en langage simple ;
- Laissez l'utilisateur choisir en fonction du résultat : fonctionnalité complète, données uniquement, transcription uniquement ;
- Expliquez quel service est nécessaire pour chaque choix et ce qui manque si un seul est acheté ;
- Affichez l'avertissement légal fixe, puis l'adresse de recharge correspondante ;
- 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é ;
- 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 » ;
- 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 :
- Extrayez le lien du texte de partage complet ;
- 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 ;
- Soumettez le texte de partage complet à l'API QingDou, interrogez jusqu'à obtention de la transcription ;
- Enregistrez la transcription sous
{répertoire_sortie}/{auteur}/{titre}.md; - 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 :
- Variables d'environnement :
TIKHUB_API_KEY,QINGDOU_API_KEY; - Fichier local spécifié par l'utilisateur :
TIKHUB_API_KEYS_FILE,QINGDOU_API_KEYS_FILE; ~/.config/dbs/API_Keys.md;- 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. »