youtube-summarizer
Règle de lecture sélective
Commencez par :
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Ensuite, chargez uniquement les documents hérités, scripts, ressources ou exemples qui correspondent à la tâche réelle de l'utilisateur.
Objectif
Cette compétence extrait les transcripts de vidéos YouTube et génère des résumés complets et détaillés en utilisant le cadre STAR + R-I-S-E. Elle valide la disponibilité de la vidéo, extrait le transcript à l'aide de la bibliothèque Python youtube-transcript-api, et produit une documentation détaillée capturant toutes les idées, arguments et points clés.
La compétence est conçue pour les utilisateurs qui ont besoin d'une analyse approfondie du contenu et d'une documentation de référence à partir de vidéos éducatives, de cours, de tutoriels ou de contenu informatif.
Quand utiliser cette compétence
Cette compétence doit être utilisée lorsque :
- L'utilisateur fournit une URL YouTube et souhaite un résumé détaillé
- L'utilisateur a besoin de documenter le contenu vidéo pour référence sans revisionner
- L'utilisateur souhaite extraire des idées, points clés et arguments d'un contenu éducatif
- L'utilisateur a besoin de transcripts de vidéos YouTube pour analyse
- L'utilisateur demande de « résumer », « synthétiser » ou « extraire le contenu » de vidéos YouTube
- L'utilisateur souhaite une documentation complète privilégiant l'exhaustivité à la concision
Étape 0 : Découverte et configuration
Avant de traiter les vidéos, validez l'environnement et les dépendances :
# Vérifier si youtube-transcript-api est installé
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
echo "⚠️ youtube-transcript-api non trouvé"
# Proposer l'installation
fi
# Vérifier la disponibilité de Python
if ! command -v python3 &>/dev/null; then
echo "❌ Python 3 est requis mais n'est pas installé"
exit 1
fi
Demandez à l'utilisateur si la dépendance est manquante :
youtube-transcript-api est requis mais n'est pas installé.
Souhaitez-vous l'installer maintenant ?
- [ ] Oui - Installer avec pip (pip install youtube-transcript-api)
- [ ] Non - Je l'installerai manuellement
Si l'utilisateur sélectionne « Oui » :
pip install youtube-transcript-api
Vérifiez l'installation :
python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api installé avec succès')"
Flux de travail principal
Directives de suivi de progression
Tout au long du flux de travail, affichez un indicateur de progression visuel avant chaque étape pour tenir l'utilisateur informé. Le format de l'indicateur est :
echo "[████░░░░░░░░░░░░░░░░] 20% - Étape 1/5 : Validation de l'URL"
Spécifications du format :
- 20 caractères de large (utilisez █ pour rempli, ░ pour vide)
- Incréments de pourcentage : Étape 1=20 %, Étape 2=40 %, Étape 3=60 %, Étape 4=80 %, Étape 5=100 %
- Compteur d'étapes montrant la progression actuelle/totale (ex. « Étape 3/5 »)
- Brève description de la phase en cours
Affichez la boîte de statut initiale avant l'Étape 1 :
╔══════════════════════════════════════════════════════════════╗
║ 📹 YOUTUBE SUMMARIZER - Traitement de la vidéo ║
╠══════════════════════════════════════════════════════════════╣
║ → Étape 1 : Validation de l'URL [EN COURS] ║
║ ○ Étape 2 : Vérification de la disponibilité ║
║ ○ Étape 3 : Extraction du transcript ║
║ ○ Étape 4 : Génération du résumé ║
║ ○ Étape 5 : Mise en forme de la sortie ║
╠══════════════════════════════════════════════════════════════╣
║ Progression : ██████░░░░░░░░░░░░░░░░░░░░░░░░ 20 % ║
╚══════════════════════════════════════════════════════════════╝
Étape 1 : Valider l'URL YouTube
Objectif : Extraire l'ID vidéo et valider le format de l'URL.
Formats d'URL pris en charge :
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://m.youtube.com/watch?v=VIDEO_ID
Actions :
# Extraire l'ID vidéo à l'aide d'une expression régulière ou d'un analyseur d'URL
URL="$URL_UTILISATEUR"
# Motif 1 : youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# Motif 2 : youtu.be/VIDEO_ID
elif echo "$URL" | grep -qE 'youtu\.be/'; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
echo "❌ Format d'URL YouTube invalide"
exit 1
fi
echo "📹 ID vidéo extrait : $VIDEO_ID"
Si l'URL est invalide :
❌ URL YouTube invalide
Veuillez fournir une URL YouTube valide dans l'un des formats suivants :
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
Exemple : https://www.youtube.com/watch?v=dQw4w9WgXcQ
Étape 2 : Vérifier la disponibilité de la vidéo et du transcript
Progression :
echo "[████████░░░░░░░░░░░░] 40% - Étape 2/5 : Vérification de la disponibilité"
Objectif : Vérifier que la vidéo existe et que le transcript est accessible.
Actions :
from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys
video_id = sys.argv[1]
try:
# Obtenir la liste des transcripts disponibles
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print(f"✅ Vidéo accessible : {video_id}")
print("📝 Transcripts disponibles :")
for transcript in transcript_list:
print(f" - {transcript.language} ({transcript.language_code})")
if transcript.is_generated:
print(" [Généré automatiquement]")
except TranscriptsDisabled:
print(f"❌ Les transcripts sont désactivés pour la vidéo {video_id}")
sys.exit(1)
except NoTranscriptFound:
print(f"❌ Aucun transcript trouvé pour la vidéo {video_id}")
sys.exit(1)
except Exception as e:
print(f"❌ Erreur lors de l'accès à la vidéo : {e}")
sys.exit(1)
Gestion des erreurs :
| Erreur | Message | Action |
|---|---|---|
| Vidéo non trouvée | "❌ La vidéo n'existe pas ou est privée" | Demander à l'utilisateur de vérifier l'URL |
| Transcripts désactivés | "❌ Les transcripts sont désactivés pour cette vidéo" | Impossible de continuer |
| Aucun transcript disponible | "❌ Aucun transcript trouvé (non généré automatiquement ni ajouté manuellement)" | Impossible de continuer |
| Vidéo privée/restreinte | "❌ La vidéo est privée ou restreinte" | Demander une vidéo publique |
Étape 3 : Extraire le transcript
Progression :
echo "[████████████░░░░░░░░] 60% - Étape 3/5 : Extraction du transcript"
Objectif : Récupérer le transcript dans la langue préférée.
Actions :
from youtube_transcript_api import YouTubeTranscriptApi
video_id = "VIDEO_ID"
try:
# Essayer d'obtenir le transcript dans la langue préférée de l'utilisateur d'abord
# Repli sur l'anglais si non disponible
transcript = YouTubeTranscriptApi.get_transcript(
video_id,
languages=['pt', 'en'] # Préférer le portugais, repli sur l'anglais
)
# Combiner les segments du transcript en texte complet
full_text = " ".join([entry['text'] for entry in transcript])
# Obtenir les métadonnées de la vidéo
from youtube_transcript_api import YouTubeTranscriptApi
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print("✅ Transcript extrait avec succès")
print(f"📊 Longueur du transcript : {len(full_text)} caractères")
# Sauvegarder dans un fichier temporaire pour le traitement
with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
f.write(full_text)
except Exception as e:
print(f"❌ Erreur lors de l'extraction du transcript : {e}")
exit(1)
Traitement du transcript :
- Combiner tous les segments du transcript en un texte cohérent
- Conserver la ponctuation et la mise en forme lorsque disponibles
- Supprimer les segments en double ou qui se chevauchent (artefacts de génération automatique)
- Stocker dans un fichier temporaire pour analyse
Étape 4 : Générer un résumé complet
Progression :
echo "[████████████████░░░░] 80% - Étape 4/5 : Génération du résumé"
Objectif : Appliquer le prompt amélioré STAR + R-I-S-E pour créer un résumé détaillé.
Prompt appliqué :
Utilisez le prompt amélioré de la Phase 2 (cadre STAR + R-I-S-E) avec le transcript extrait comme entrée.
Actions :
- Charger le texte complet du transcript
- Appliquer le prompt de résumé complet
- Utiliser le modèle IA (Claude/GPT) pour générer un résumé structuré
- S'assurer que la sortie suit la structure définie :
- En-tête avec les métadonnées de la vidéo
- Synthèse exécutive
- Décomposition détaillée section par section
- Idées clés et conclusions
- Concepts et terminologie
- Ressources et références
Implémentation :
# Utiliser le fichier de transcript comme entrée pour le prompt IA
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"
# L'agent IA va :
# 1. Lire le transcript
# 2. Appliquer le cadre de résumé STAR + R-I-S-E
# 3. Générer une sortie Markdown complète
# 4. Structurer avec des en-têtes, listes et surlignages
Lire "$TRANSCRIPT_FILE" # Lire le transcript dans le contexte
Ensuite, appliquez le prompt de résumé complet (de la version améliorée de la Phase 2).
Étape 5 : Mettre en forme et présenter la sortie
Progression :
echo "[████████████████████] 100% - Étape 5/5 : Mise en forme de la sortie"
Objectif : Délivrer le résumé en Markdown propre et bien structuré.
Structure de sortie :
# [Titre de la vidéo]
**Chaîne :** [Nom de la chaîne]
**Durée :** [Durée]
**URL :** [https://youtube.com/watch?v=VIDEO_ID]
**Date de publication :** [Date si disponible]
## 📝 Résumé détaillé
### [Sujet 1]
[Explication complète avec exemples, données, citations...]
#### [Sous-sujet 1.1]
[Décomposition détaillée...]
### [Sujet 2]
[Analyse détaillée continue...]
## 📚 Concepts et terminologie
- **[Terme 1] :** [Définition et contexte]
- **[Terme 2] :** [Définition et contexte]
## 📌 Conclusion
[Synthèse finale et points à retenir]
### **Exemple 2 : Dépendance manquante**
**Entrée utilisateur :**
claude> résume cette vidéo youtube https://youtu.be/abc123
**Réponse de la compétence :**
⚠️ youtube-transcript-api non installé
Cette compétence nécessite la bibliothèque Python 'youtube-transcript-api'.
Souhaitez-vous que je l'installe maintenant ?
- Oui - Installer avec pip
- Non - J'installerai manuellement
**L'utilisateur sélectionne « Oui » :**
```bash
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1
✅ Installation terminée ! Poursuite du résumé vidéo...
Exemple 4 : URL invalide
Entrée utilisateur :
claude> résume la vidéo youtube www.youtube.com/some-video
Réponse de la compétence :
❌ Format d'URL YouTube invalide
Exemples de formats attendus :
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
Veuillez fournir une URL YouTube valide.
📊 Résumé exécutif
Cette vidéo propose une introduction complète aux concepts fondamentaux de l'Intelligence Artificielle (IA), conçue pour les débutants et les professionnels souhaitant comprendre les bases techniques et les applications pratiques de l'IA moderne. L'instructeur couvre tout, des définitions de base aux algorithmes d'apprentissage automatique, en utilisant des exemples pratiques et des visualisations pour faciliter la compréhension.
[... suite du résumé détaillé ...]
**Options de sauvegarde :**
Que souhaitez-vous sauvegarder ? → Résumé + transcript brut
✅ Fichier sauvegardé : resumo-exemplo123-2026-02-01.md (inclut le transcript brut) [████████████████████] 100% - ✓ Traitement terminé !
Bienvenue dans ce didacticiel complet sur les fondamentaux de l'apprentissage automatique. Dans la vidéo d'aujourd'hui, nous allons explorer les concepts de base qui alimentent les systèmes d'IA modernes...
Version : 1.2.0 Dernière mise à jour : 2026-02-02 Maintenu par : Eric Andrade
Limitations
- Utilisez cette compétence uniquement lorsque la tâche correspond clairement au champ d'application décrit ci-dessus.
- Ne considérez pas la sortie comme un substitut à une validation, un test ou une revue d'expert spécifique à l'environnement.
- Arrêtez-vous et demandez des clarifications si les entrées requises, les autorisations, les limites de sécurité ou les critères de succès sont manquants.