Communitygithub.com

ever-just/agentskills

Récupère automatiquement les transcriptions de vidéos YouTube, génère des résumés structurés et envoie les transcriptions complètes vers des plateformes de messagerie. Détecte les URL YouTube et fournit des métadonnées, des informations clés et des transcriptions téléchargeables.

Qu'est-ce que agentskills ?

Cette compétence pour agent IA automatise entièrement le processus d'extraction et de synthèse de contenu à partir de vidéos YouTube. Elle prend en charge plusieurs modes de résumé (rapide, standard ou approfondi) pour s'adapter à différents besoins, de la simple consultation rapide à l'analyse détaillée pour la création de contenu. Fonctionnant via un serveur MCP dédié, elle est capable de fonctionner sur un VPS en utilisant une émulation de client Android pour contourner les blocages d'IP de YouTube. La compétence extrait les métadonnées de la vidéo (titre, chaîne, vues, date), génère un résumé structuré avec thèse et points clés, sauvegarde la transcription complète avec horodatages, et peut livrer le tout sur Telegram ou d'autres plateformes de messagerie. Elle est compatible avec Claude Code, Cursor et Codex, et offre un gain de temps considérable par rapport aux méthodes manuelles, passant de 30 à 45 minutes à seulement 20 secondes par vidéo.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ever-just/agentskills/tree/HEAD/skills/white-paper-writing/ai-marketing-skills/youtube-summarizer

Demander à votre IA préférée

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

Documentation

Compétence de Résumé YouTube

Récupère automatiquement les transcriptions des vidéos YouTube, génère des résumés structurés et livre les transcriptions complètes vers des plateformes de messagerie.

Mode

Détecter à partir du contexte ou demander : "Résumé rapide, résumé complet, ou résumé complet avec angles de contenu ?"

ModeCe que vous obtenezIdéal pour
rapide3 points clés + un enseignement majeurConsommation rapide, partage d'un extrait
standardRésumé structuré complet : thèse, idées clés, enseignementApprentissage, prise de notes, recherche
approfondiRésumé complet + découpage par chapitres + opportunités de réutilisationTransformer une vidéo en actif de contenu

Par défaut : standard — utilisez rapide s'ils veulent juste l'essentiel. Utilisez approfondi s'ils veulent extraire la vidéo pour en faire du contenu exploitable.


Pourquoi Cette Compétence vs ChatGPT ?

Problème avec ChatGPT : Il ne peut pas accéder directement aux transcriptions YouTube. Vous devez copier/coller manuellement les sous-titres ou utiliser un outil tiers d'abord, puis fournir le texte à ChatGPT. Un processus en plusieurs étapes, fastidieux, qui perd les métadonnées de la vidéo.

Cette compétence offre :

  1. Extraction de transcription en une étape - Déposez une URL YouTube, obtenez la transcription complète automatiquement
  2. Résumé structuré - Format cohérent (thèse → idées clés → enseignement) à chaque fois, pas de points aléatoires
  3. Métadonnées vidéo incluses - Titre, chaîne, vues, date de publication intégrés au résumé
  4. Livraison de la transcription complète - Sauvegarde la transcription horodatée dans un fichier et l'envoie sur Telegram/plateformes de chat
  5. Fonctionne depuis un VPS/cloud - Utilise l'émulation d'un client Android pour contourner le blocage IP cloud de YouTube (là où yt-dlp échoue)
  6. Support multilingue - Récupération automatique dans la langue demandée avec repli vers l'anglais

Vous pouvez reproduire cela en activant manuellement les sous-titres, en copiant le texte, en le collant dans ChatGPT, en reformatant la sortie, en sauvegardant dans un fichier et en téléchargeant. Cela prend 5 à 10 minutes. Cette compétence le fait en 15 à 20 secondes.

Quand l'Utiliser

Activez cette compétence lorsque :

  • L'utilisateur partage une URL YouTube (youtube.com/watch, youtu.be, youtube.com/shorts)
  • L'utilisateur demande de résumer ou de transcrire une vidéo YouTube
  • L'utilisateur demande des informations sur le contenu d'une vidéo YouTube
  • Vous avez besoin d'analyser le contenu vidéo pour la recherche ou la création de contenu

Dépendances

Requis : Le serveur MCP YouTube Transcript doit être installé à : /root/clawd/mcp-server-youtube-transcript

S'il n'est pas présent, installez-le :

cd /root/clawd
git clone https://github.com/kimtaeyoon83/mcp-server-youtube-transcript.git
cd mcp-server-youtube-transcript
npm install && npm run build

Flux de Travail

1. Détecter l'URL YouTube

Extrayez l'ID vidéo à partir de ces modèles :

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://www.youtube.com/shorts/VIDEO_ID
  • ID vidéo directe : VIDEO_ID (11 caractères)

2. Récupérer la Transcription

Exécutez cette commande pour obtenir la transcription :

cd /root/clawd/mcp-server-youtube-transcript && node --input-type=module -e "
import { getSubtitles } from './dist/youtube-fetcher.js';
const result = await getSubtitles({ videoID: 'VIDEO_ID', lang: 'en' });
console.log(JSON.stringify(result, null, 2));
" > /tmp/yt-transcript.json

Remplacez VIDEO_ID par l'ID extrait. Lisez la sortie depuis /tmp/yt-transcript.json.

3. Traiter les Données

Analysez le JSON pour extraire :

  • result.metadata.title - Titre de la vidéo
  • result.metadata.author - Nom de la chaîne
  • result.metadata.viewCount - Nombre de vues formaté
  • result.metadata.publishDate - Date de publication
  • result.actualLang - Langue utilisée
  • result.lines - Tableau des segments de transcription

Texte complet : result.lines.map(l => l.text).join(' ')

4. Générer le Résumé

Créez un résumé structuré en utilisant ce modèle :

📹 **Vidéo :** [titre]
👤 **Chaîne :** [auteur] | 👁️ **Vues :** [vues] | 📅 **Publié :** [date]

**🎯 Thèse Principale :**
[1-2 phrases sur l'argument/message central]

**💡 Idées Clés :**
- [idée 1]
- [idée 2]
- [idée 3]
- [idée 4]
- [idée 5]

**📝 Points Notables :**
- [point supplémentaire 1]
- [point supplémentaire 2]

**🔑 Enseignement :**
[Application pratique ou conclusion]

Visez :

  • Thèse principale : 1 à 2 phrases maximum
  • Idées clés : 3 à 5 points, chacun de 1 à 2 phrases
  • Points notables : 2 à 4 détails de soutien
  • Enseignement : Conclusion actionnable

5. Sauvegarder la Transcription Complète

Sauvegardez la transcription complète dans un fichier horodaté :

/root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt

Incluez dans le fichier :

  • En-tête des métadonnées vidéo (titre, chaîne, URL, date)
  • Texte complet de la transcription
  • Référence d'URL pour une consultation facile

6. Livraison Spécifique à la Plateforme

Si le canal est Telegram :

message --action send --channel telegram --target CHAT_ID \
  --filePath /root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt \
  --caption "📄 Transcription YouTube : [titre]"

Si le canal est autre/webchat : Répondez simplement avec le résumé (pas de pièce jointe).

7. Répondre avec le Résumé

Envoyez le résumé structuré comme votre réponse à l'utilisateur.

Étude de Cas Réelle

Utilisateur : Créateur de contenu recherchant les stratégies de concurrents sur YouTube

Défi : Nécessité d'analyser 20+ vidéos de concurrents par semaine pour identifier les sujets tendances, les schémas de message et les lacunes de contenu. Processus manuel : regarder la vidéo, prendre des notes, transcrire les citations clés. Temps : 30 à 45 minutes par vidéo.

Solution avec youtube-summarizer :

  1. Déposez l'URL YouTube dans le chat
  2. Obtenez un résumé structuré en 20 secondes
  3. Transcription complète sauvegardée pour référence
  4. Copiez les idées clés pour le document de planification de contenu

Exemple de flux de travail :

Utilisateur : Analyse cette vidéo : https://youtube.com/watch?v=abc123
[20 secondes plus tard]

📹 Vidéo : "10 Outils IA Qui Remplaceront Ton Travail en 2026"
👤 Chaîne : TechFuturiste | 👁️ Vues : 847K | 📅 Publié : 12 janv. 2026

🎯 Thèse Principale :
Les outils d'IA automatisent le travail créatif et de connaissance plus rapidement que prévu, mais la véritable opportunité réside dans l'augmentation, pas le remplacement.

💡 Idées Clés :
- L'utilisation de ChatGPT parmi les spécialistes du marketing est passée de 12 % à 67 % en un an
- Le temps de montage vidéo réduit de 80 % grâce à des outils IA comme Descript
- Les plus grands gains viennent de la combinaison d'outils (Notion + Claude + Zapier)
- Les entreprises embauchent des "concepteurs de flux de travail IA" pour optimiser la collaboration humain-IA
- Les travailleurs utilisant l'IA en secret surpassent leurs pairs de 40 % (étude BCG)

📝 Points Notables :
- Montre des exemples de 3 petites entreprises qui ont multiplié leur production par 10 avec l'IA
- Met en garde contre la surautomatisation : "L'IA peut écrire, mais ne peut pas penser stratégiquement"

🔑 Enseignement :
Ne vous demandez pas "L'IA va-t-elle me remplacer ?" Demandez-vous "Comment puis-je utiliser l'IA pour devenir 10 fois plus précieux ?"

Résultats après 8 semaines :

  • Temps gagné : 25 heures/semaine (de 600 minutes à 60 minutes pour 20 vidéos)
  • Production de contenu : 3 vidéos/semaine (contre 1/semaine auparavant)
  • Meilleures idées : Transcriptions complètes consultables, motifs repérés qui étaient manqués en regardant simplement
  • Renseignement concurrentiel : Base de données de 160+ résumés de vidéos concurrentes avec citations clés
  • Citation ROI : "Cette compétence a transformé la recherche concurrentielle d'une corvée en une chaîne de montage."

Pourquoi Cela Bat les Méthodes Manuelles

MéthodeTempsObtient les MétadonnéesSortie StructuréeArchive ConsultableAdapté au Cloud
Regarder + prendre des notes30-45 minNonNonManuel uniquementN/A
Fonction de transcription YouTube5 minNonNonNonOui
yt-dlp2-5 minOuiNonOui❌ Bloqué sur VPS
Copier dans ChatGPT10 minNonParfoisNonOui
Cette compétence20 secOuiOuiOui✅ Fonctionne sur VPS

Gestion des Erreurs

Si la récupération de la transcription échoue :

  • Vérifiez si la vidéo a des sous-titres activés
  • Essayez avec lang: 'en' comme repli si la langue demandée n'est pas disponible
  • Informez l'utilisateur que la transcription n'est pas disponible et suggérez des alternatives :
    • Fonction de transcription manuelle YouTube (Paramètres → Afficher la transcription)
    • La vidéo peut ne pas avoir de sous-titres
    • Essayez une autre vidéo

Si le serveur MCP n'est pas installé :

  • Fournissez les instructions d'installation
  • Proposez de l'installer automatiquement si le contexte est approprié

Si l'extraction de l'ID vidéo échoue :

  • Demandez à l'utilisateur de fournir l'URL YouTube complète ou l'ID vidéo

Si la vidéo est restreinte par âge ou privée :

  • Informez l'utilisateur que la transcription ne peut pas être accédée en raison de restrictions
  • Suggérez de vérifier les paramètres de confidentialité de la vidéo

Exemples

Exemple 1 : Tutoriel Technique

Entrée : https://youtube.com/watch?v=dQw4w9WgXcQ

Sortie :

📹 **Vidéo :** "Créer un SaaS de zéro : Leçons de 10 000 $ MRR"
👤 **Chaîne :** IndieHackerTV | 👁️ **Vues :** 124K | 📅 **Publié :** 1 févr. 2026

**🎯 Thèse Principale :**
La plupart des fondateurs de SaaS échouent parce qu'ils construisent pendant 6 mois avant de parler aux clients. Le chemin vers 10 000 $ MRR, ce sont les conversations clients d'abord, le MVP ensuite.

**💡 Idées Clés :**
- A interviewé 50 clients potentiels avant d'écrire une seule ligne de code
- Le premier client payant s'est inscrit avec une maquette Figma (aucun produit construit)
- A facturé 99 $/mois dès le jour 1 (pas de niveau gratuit, pas de réductions)
- A dépensé 0 $ en publicité ; toute la croissance provenait de l'engagement sur Twitter + Reddit
- A atteint 10 000 $ MRR en 9 mois en disant "non" aux demandes de fonctionnalités qui ne correspondaient pas au profil client idéal

📝 **Points Notables :**
- A utilisé les liens de paiement Stripe avant de construire un système de facturation
- Les 3 premiers clients sont venus de la résolution de leur problème en public sur Twitter
- Les mises à jour hebdomadaires "build in public" sur Twitter ont généré 40 % des inscriptions

🔑 **Enseignement :**
Validez la demande avant de construire. Si 10 personnes ne paient pas pour une maquette, 1 000 ne paieront pas pour le produit réel.

Exemple 2 : Vidéo de Stratégie Commerciale

Entrée : https://youtu.be/abc123xyz

Sortie :

📹 **Vidéo :** "Pourquoi le Modèle Économique de Notion est Génial"
👤 **Chaîne :** Décompositions SaaS | 👁️ **Vues :** 456K | 📅 **Publié :** 28 janv. 2026

**🎯 Thèse Principale :**
La stratégie de croissance de Notion renverse le SaaS traditionnel : offrir le produit gratuitement aux particuliers, monétiser quand ils l'apportent au travail.

**💡 Idées Clés :**
- 80 % des contrats entreprise de Notion ont commencé avec un seul employé utilisant le forfait gratuit
- Adoption ascendante = équipe de vente zéro nécessaire pour les premiers 10 millions $ ARR
- Le marché des modèles a créé un volant d'inertie de contenu (100 000+ modèles gratuits)
- Utilisation personnelle (gratuite) → Utilisation en équipe (payante) taux de conversion : 23 % (moy. secteur : 2-5 %)
- L'évangélisation communautaire a remplacé le marketing traditionnel (4 millions+ de membres Reddit/Discord)

📝 **Points Notables :**
- Coefficient viral de Notion : 1,4 (chaque utilisateur invite en moyenne 1,4 autres personnes)
- Les créateurs de modèles génèrent 30 % de l'acquisition de nouveaux utilisateurs
- Stratégie de prix : gratuit jusqu'à 10 personnes = pas de friction pour commencer

🔑 **Enseignement :**
Construisez d'abord un produit que les particuliers adorent. Les ventes aux entreprises suivront lorsque les employés l'exigeront au travail.

Directives de Qualité

  • Soyez concis : Le résumé doit pouvoir être parcouru en 30 secondes
  • Soyez précis : N'ajoutez pas d'informations qui ne sont pas dans la transcription
  • Soyez structuré : Utilisez un format cohérent pour une lecture facile
  • Soyez contextuel : Ajustez le niveau de détail en fonction de la longueur de la vidéo
    • Vidéos courtes (<5 min) : Résumé bref (3 idées clés)
    • Vidéos moyennes (5-30 min) : Format standard (5 idées clés)
    • Vidéos longues (>30 min) : Décomposition détaillée (7+ idées, divisées en sections si nécessaire)
  • Extrayez la valeur : Concentrez-vous sur les informations actionnables, les points de données et les points de vue non conventionnels (pas les conseils génériques)

Conseils de Pro

Pour de Meilleurs Résumés :

  1. Priorisez les points de données - Les chiffres, pourcentages, citations d'études se démarquent
  2. Extrayez les citations - Les formules mémorables rendent les résumés partageables
  3. Identifiez les modèles - Si la vidéo présente une méthode/un processus, extrayez les étapes
  4. Repérez les points de vue non conventionnels - La sagesse non conventionnelle est plus précieuse que les conseils courants
  5. Notez les preuves - Les exemples, études de cas, résultats avant/après ajoutent de la crédibilité

Pour les Flux de Travail de Recherche :

  1. Construisez une bibliothèque de transcriptions - Organisez par sujet/niche pour repérer les modèles
  2. Recherchez dans les transcriptions - Utilisez grep ou la recherche textuelle pour trouver des mentions de sujets spécifiques
  3. Suivez les tendances - Le même sujet dans plusieurs vidéos = tendance montante
  4. Extrayez les prompts - Sauvegardez les modèles/méthodes utiles comme prompts réutilisables

Pour la Création de Contenu :

  1. Trouvez les lacunes de contenu - Quelles questions sont posées mais pas entièrement répondues ?
  2. Analysez les meilleurs performeurs - Quelle structure/rythme les vidéos à fort visionnage utilisent-elles ?
  3. Extrayez les accroches - Les 30 premières secondes de la transcription = modèles d'accroche éprouvés
  4. Réutilisez les idées - Transformez les idées vidéo en fils Twitter, articles de blog, newsletters

Configuration

Mode Standard (par défaut)

youtube-summarizer [URL]
  • Récupère la transcription en anglais
  • Génère un résumé structuré
  • Sauvegarde la transcription dans un fichier
  • Envoie à la plateforme de messagerie si applicable

Mode Rapide

youtube-summarizer [URL] --quick
  • Thèse + 3 idées clés uniquement
  • Pas de fichier de transcription sauvegardé
  • Traitement plus rapide pour une recherche rapide

Mode Approfondi

youtube-summarizer [URL] --deep
  • Résumé étendu avec horodatages
  • Décomposition section par section pour les vidéos longues
  • Inclut toutes les citations notables

Spécifique à une Langue

youtube-summarizer [URL] --lang es
  • Récupère la transcription dans la langue spécifiée
  • Repli vers l'anglais si indisponible

Installation et Configuration

# 1. Cloner et installer le serveur MCP
cd /root/clawd
git clone https://github.com/kimtaeyoon83/mcp-server-youtube-transcript.git
cd mcp-server-youtube-transcript
npm install && npm run build

# 2. Tester l'installation
node --input-type=module -e "
import { getSubtitles } from './dist/youtube-fetcher.js';
const result = await getSubtitles({ videoID: 'dQw4w9WgXcQ', lang: 'en' });
console.log(result.metadata.title);
"

# 3. Créer le répertoire de transcriptions
mkdir -p /root/clawd/transcripts

# 4. Vérifier que la compétence est prête
youtube-summarizer --check-setup

Problèmes Courants

Problème : "Transcription non disponible"

  • Cause : La vidéo n'a pas de sous-titres/légendes activés
  • Correctif : Demandez au créateur de la vidéo d'activer les sous-titres, ou essayez une autre vidéo

Problème : "Échec de la récupération de la transcription" (sur VPS)

  • Cause : YouTube a peut-être mis à jour son API
  • Correctif : Mettez à jour le serveur MCP : cd /root/clawd/mcp-server-youtube-transcript && git pull && npm install && npm run build

Problème : "ID vidéo non reconnu"

  • Cause : URL malformée ou format non pris en charge
  • Correctif : Demandez à l'utilisateur de fournir une URL YouTube valide ou l'ID vidéo à 11 caractères

Problème : "Vidéo restreinte"

  • Cause : Vidéo avec limite d'âge ou vidéo privée
  • Correctif : Les transcriptions ne peuvent pas être récupérées pour les vidéos restreintes. Essayez avec une vidéo publique

Référence de l'API

getSubtitles(videoID, lang)

Paramètres :

  • videoID (obligatoire) : l'ID vidéo YouTube à 11 caractères
  • lang (optionnel) : le code de langue ISO 639-1 (par défaut : 'en')

Retour : Objet avec :

  • metadata : titre, auteur, nombre de vues, date de publication
  • actualLang : la langue effectivement récupérée
  • lines : tableau d'objets avec text (chaîne), duration (nombre en secondes), offset (nombre en secondes)

Exemple :

{
  "metadata": {
    "title": "Exemple de Vidéo",
    "author": "Nom de la Chaîne",
    "viewCount": "124K vues",
    "publishDate": "2026-01-15"
  },
  "actualLang": "en",
  "lines": [
    {
      "text": "Bonjour et bienvenue",
      "duration": 2.5,
      "offset": 0
    }
  ]
}

Individual skills in this repo

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

ever-just/agentskills

> Declarative animations for React. Springs, gestures, layout animations, and page transitions. GPU-accelerated, production-ready.

ever-just/agentskills

> Create animated logos, icons, and micro-interactions as lightweight Lottie JSON files. No After Effects needed — build animations entirely in code.

ever-just/agentskills

> A TypeScript library using generators to program animations with a real-time editor. Ideal for explainer videos, code walkthroughs, and educational content.

ever-just/agentskills

> Add animated subtitles and captions to Remotion videos from .SRT files. TikTok-style word-by-word highlights, karaoke effects, and more.

ever-just/agentskills

> Create videos programmatically using React components. The most mature framework for code-driven video production.

ever-just/agentskills

> Copy-paste video components for Remotion. Intros, text effects, transitions, and full scene templates. Like shadcn/ui but for video.

ever-just/agentskills

Extract actionable intelligence from video content across YouTube, Vimeo, and company websites. Video reveals what text sources cannot: facility scale, team composition, product demonstrations, signage, event attendance, and operational reality.

ever-just/agentskills

Optimize and embed an existing video as a fast, crisp, autoplaying hero/background/loop on a website. Use when adding or replacing a video on a marketing site and it is too heavy, will not autoplay (especially on mobile/Safari), shows a codec error, or looks soft — to transcode it to web-safe H.264 with the right pixel format, faststart, retina-aware sizing, and a poster frame, then embed and verify it actually plays. This is optimization + embedding of footage you already have, not creating/animating a video (for that use remotion/moviepy/motion-canvas). Use when the user says "add this video to the site", "the hero video is too big / won't play / isn't crisp", "replace the homepage video", or "make this loop on the landing page".

ever-just/agentskills

Full conversion audit for any homepage or landing page. Use when someone asks to "review my homepage," "audit my landing page," "why isn't my page converting," "check my website," or wants feedback on their marketing page. Requires URL or screenshot before proceeding.

Skills associés