Que fait Outil Contenu YouTube ?
Quand l'utiliser
Utilisez lorsque l'utilisateur partage une URL YouTube ou un lien vidéo, demande de résumer une vidéo, sollicite une transcription, ou souhaite extraire et reformater le contenu d'une vidéo YouTube. Transforme les transcriptions en contenu structuré (chapitres, résumés, fils de discussion, articles de blog).
Extrait les transcriptions de vidéos YouTube et les convertit en formats utiles.
Configuration
Utilisez uv pour que la dépendance soit installée dans le même environnement géré par Hermes qui exécute le script d'aide :
uv pip install youtube-transcript-api
Script d'aide
SKILL_DIR est le répertoire contenant ce fichier SKILL.md. Le script accepte tout format d'URL YouTube standard, les liens courts (youtu.be), les shorts, les embeds, les liens de direct, ou un identifiant brut de 11 caractères.
# Sortie JSON avec métadonnées
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"
# Texte brut (idéal pour le piping vers un traitement ultérieur)
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only
# Avec horodatage
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps
# Langue spécifique avec chaîne de repli
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en
Formats de sortie
Après avoir récupéré la transcription, formatez-la selon la demande de l'utilisateur :
- Chapitres : Regrouper par changements de sujet, produire une liste de chapitres horodatés
- Résumé : Aperçu concis de 5 à 10 phrases de l'ensemble de la vidéo
- Résumés de chapitres : Chapitres avec un court paragraphe de résumé pour chacun
- Fil de discussion : Format fil Twitter/X — messages numérotés, chacun sous 280 caractères
- Article de blog : Article complet avec titre, sections et points clés
- Citations : Citations notables avec horodatage
Exemple — Sortie Chapitres
00:00 Introduction — l'hôte ouvre avec l'énoncé du problème
03:45 Contexte — travaux antérieurs et pourquoi les solutions existantes sont insuffisantes
12:20 Méthode principale — présentation détaillée de l'approche proposée
24:10 Résultats — comparaisons de référence et points clés
31:55 Questions-Réponses — questions du public sur l'évolutivité et les prochaines étapes
Flux de travail
- Récupérer la transcription à l'aide du script d'aide avec
--text-only --timestampsviauv run python3. - Valider : confirmer que la sortie n'est pas vide et dans la langue attendue. Si elle est vide, réessayer sans
--languagepour obtenir toute transcription disponible. Si toujours vide, indiquer à l'utilisateur que la vidéo a probablement les transcriptions désactivées. - Fragmenter si nécessaire : si la transcription dépasse environ 50 000 caractères, la diviser en fragments qui se chevauchent (environ 40 000 avec 2 000 de chevauchement) et résumer chaque fragment avant de les fusionner.
- Transformer dans le format de sortie demandé. Si l'utilisateur n'a pas spécifié de format, utiliser un résumé par défaut.
- Vérifier : relire la sortie transformée pour vérifier la cohérence, l'exactitude des horodatages et l'exhaustivité avant de la présenter.
Gestion des erreurs
- Transcription désactivée : en informer l'utilisateur ; suggérer de vérifier si les sous-titres sont disponibles sur la page de la vidéo.
- Vidéo privée/non disponible : transmettre l'erreur et demander à l'utilisateur de vérifier l'URL.
- Aucune langue correspondante : réessayer sans
--languagepour récupérer toute transcription disponible, puis notifier la langue réelle à l'utilisateur. - Dépendance manquante : exécuter
uv pip install youtube-transcript-apiet réessayer.