Communitygithub.com

ever-just/agentskills

Obtén transcripciones de videos de YouTube automáticamente, genera resúmenes estructurados y envía transcripciones completas a plataformas de mensajería. Detecta URLs de YouTube y proporciona metadatos, ideas clave y transcripciones descargables.

¿Qué es agentskills?

Esta habilidad para agentes de IA automatiza completamente el proceso de extracción, resumen y entrega de transcripciones de videos de YouTube. Al recibir una URL de YouTube, el agente detecta el ID del video, utiliza un servidor MCP dedicado (mcp-server-youtube-transcript) para obtener la transcripción y los metadatos (título, canal, vistas, fecha de publicación), y genera un resumen estructurado en uno de tres modos: 'quick' (TL;DR de 3 viñetas), 'standard' (resumen completo con tesis, ideas y conclusión) o 'deep' (resumen extendido con desglose por capítulos y oportunidades de reutilización). Además, guarda la transcripción completa con marcas de tiempo en un archivo local y puede enviarla a plataformas de mensajería como Telegram. Funciona de manera fiable en servidores VPS o en la nube mediante emulación de cliente Android, evitando el bloqueo de IP que afecta a herramientas como yt-dlp. Está diseñada para investigadores, creadores de contenido y cualquier persona que necesite analizar múltiples videos de forma eficiente, reduciendo el tiempo de procesamiento manual de 30-45 minutos a solo 15-20 segundos por video.

Compatible con✓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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad de Resumidor de YouTube

Obtén transcripciones de videos de YouTube automáticamente, genera resúmenes estructurados y entrega transcripciones completas a plataformas de mensajería.

Modo

Detectar del contexto o preguntar: "¿TL;DR rápido, resumen completo o resumen completo con ángulos de contenido?"

ModoLo que obtienesMejor para
quickTL;DR de 3 viñetas + una conclusión claveConsumo rápido, compartir un clip
standardResumen estructurado completo: tesis, ideas, conclusiónAprendizaje, toma de notas, investigación
deepResumen completo + desglose por capítulos + oportunidades de reutilización de contenidoConvertir un video en un activo de contenido

Predeterminado: standard — usa quick si solo quieren la esencia. Usa deep si quieren extraer el video para convertirlo en contenido utilizable.


Por qué esto vs ChatGPT?

Problema con ChatGPT: No puede acceder directamente a las transcripciones de YouTube. Tienes que copiar/pegar los subtítulos manualmente o usar una herramienta de terceros primero, luego alimentar el texto a ChatGPT. Es un proceso de múltiples pasos, torpe y pierde los metadatos del video.

Esta habilidad proporciona:

  1. Extracción de transcripción en un solo paso - Introduce una URL de YouTube, obtén la transcripción completa automáticamente
  2. Resumen estructurado - Formato consistente (tesis → ideas → conclusión) cada vez, no puntos aleatorios
  3. Metadatos del video incluidos - Título, canal, vistas, fecha de publicación incrustados en el resumen
  4. Entrega de transcripción completa - Guarda la transcripción con marcas de tiempo en un archivo y la envía a Telegram/plataformas de chat
  5. Funciona desde VPS/nube - Utiliza emulación de cliente Android para evitar el bloqueo de IP de YouTube en la nube (donde yt-dlp falla)
  6. Soporte multilingüe - Obtiene automáticamente en el idioma solicitado con respaldo al inglés

Puedes replicar esto habilitando manualmente los subtítulos, copiando el texto, pegándolo en ChatGPT, reformateando la salida, guardándolo en un archivo y subiéndolo. Tarda de 5 a 10 minutos. Esta habilidad lo hace en 15-20 segundos.

Cuándo usar

Activa esta habilidad cuando:

  • El usuario comparte una URL de YouTube (youtube.com/watch, youtu.be, youtube.com/shorts)
  • El usuario pide resumir o transcribir un video de YouTube
  • El usuario solicita información sobre el contenido de un video de YouTube
  • Necesitas analizar el contenido de un video para investigación o creación de contenido

Dependencias

Requerido: El servidor MCP de Transcripción de YouTube debe estar instalado en: /root/clawd/mcp-server-youtube-transcript

Si no está presente, instálalo:

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

Flujo de Trabajo

1. Detectar URL de YouTube

Extrae el ID del video de estos patrones:

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://www.youtube.com/shorts/VIDEO_ID
  • ID de video directo: VIDEO_ID (11 caracteres)

2. Obtener Transcripción

Ejecuta este comando para obtener la transcripción:

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

Reemplaza VIDEO_ID con el ID extraído. Lee la salida de /tmp/yt-transcript.json.

3. Procesar los Datos

Analiza el JSON para extraer:

  • result.metadata.title - Título del video
  • result.metadata.author - Nombre del canal
  • result.metadata.viewCount - Conteo de vistas formateado
  • result.metadata.publishDate - Fecha de publicación
  • result.actualLang - Idioma utilizado
  • result.lines - Array de segmentos de la transcripción

Texto completo: result.lines.map(l => l.text).join(' ')

4. Generar Resumen

Crea un resumen estructurado usando esta plantilla:

📹 **Video:** [título]
👤 **Canal:** [autor] | 👁️ **Vistas:** [vistas] | 📅 **Publicado:** [fecha]

**🎯 Tesis Principal:**
[1-2 oraciones del argumento/mensaje central]

**💡 Ideas Clave:**
- [idea 1]
- [idea 2]
- [idea 3]
- [idea 4]
- [idea 5]

**📝 Puntos Notables:**
- [punto adicional 1]
- [punto adicional 2]

**🔑 Conclusión:**
[Aplicación práctica o conclusión]

Procura:

  • Tesis principal: máximo 1-2 oraciones
  • Ideas clave: 3-5 viñetas, cada una de 1-2 oraciones
  • Puntos notables: 2-4 detalles de apoyo
  • Conclusión: conclusión procesable

5. Guardar Transcripción Completa

Guarda la transcripción completa en un archivo con marca de tiempo:

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

Incluye en el archivo:

  • Encabezado de metadatos del video (título, canal, URL, fecha)
  • Texto completo de la transcripción
  • Referencia de URL para búsqueda fácil

6. Entrega Específica de la Plataforma

Si el canal es Telegram:

message --action send --channel telegram --target CHAT_ID \
  --filePath /root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt \
  --caption "📄 Transcripción de YouTube: [título]"

Si el canal es otro/webchat: Solo responde con el resumen (sin adjuntar archivo).

7. Responder con el Resumen

Envía el resumen estructurado como tu respuesta al usuario.

Caso de Estudio Real

Usuario: Creador de contenido investigando estrategias de competidores en YouTube

Desafío: Necesitaba analizar más de 20 videos de competidores por semana para identificar temas de tendencia, patrones de mensajería y brechas de contenido. Proceso manual: ver el video, tomar notas, transcribir citas clave. Tiempo: 30-45 min por video.

Solución con youtube-summarizer:

  1. Introduce la URL de YouTube en el chat
  2. Obtén un resumen estructurado en 20 segundos
  3. Transcripción completa guardada para referencia
  4. Copia ideas clave para el documento de planificación de contenido

Ejemplo de flujo de trabajo:

Usuario: Analiza este video: https://youtube.com/watch?v=abc123
[20 segundos después]

📹 Video: "10 Herramientas de IA Que Reemplazarán Tu Trabajo en 2026"
👤 Canal: TechFuturist | 👁️ Vistas: 847K | 📅 Publicado: 12 Ene 2026

🎯 Tesis Principal:
Las herramientas de IA están automatizando el trabajo creativo y del conocimiento más rápido de lo esperado, pero la verdadera oportunidad está en la aumentación, no en el reemplazo.

💡 Ideas Clave:
- El uso de ChatGPT entre los especialistas en marketing saltó del 12% al 67% en un año
- El tiempo de edición de video se redujo en un 80% usando herramientas de IA como Descript
- Los mayores logros provienen de combinar herramientas (Notion + Claude + Zapier)
- Las empresas están contratando "diseñadores de flujos de trabajo de IA" para optimizar la colaboración humano-IA
- Los trabajadores que usan IA en secreto superan a sus pares en un 40% (estudio de BCG)

📝 Puntos Notables:
- Muestra ejemplos de 3 pequeñas empresas que multiplicaron por 10 su producción con IA
- Advierte contra la automatización excesiva: "La IA puede escribir, pero no puede pensar estratégicamente"

🔑 Conclusión:
No te preguntes "¿Me reemplazará la IA?" Pregúntate "¿Cómo puedo usar la IA para volverme 10 veces más valioso?"

Resultados después de 8 semanas:

  • Tiempo ahorrado: 25 horas/semana (de 600 min a 60 min para 20 videos)
  • Producción de contenido: 3 videos/semana (frente a 1/semana)
  • Mejores ideas: Transcripciones completas con capacidad de búsqueda, se encontraron patrones que se pasaban por alto al solo ver
  • Inteligencia competitiva: Se creó una base de datos de resúmenes de más de 160 videos de competidores con citas clave
  • Cita de ROI: "Esta habilidad convirtió la investigación de competidores de una tarea tediosa en una línea de ensamblaje."

Por Qué Esto Supera los Métodos Manuales

MétodoTiempoObtiene MetadatosSalida EstructuradaArchivo con BúsquedaAmigable con la Nube
Ver + tomar notas30-45 minNoNoSolo manualN/A
Función de transcripción de YouTube5 minNoNoNoSí
yt-dlp2-5 minSíNoSí❌ Bloqueado en VPS
Copiar a ChatGPT10 minNoA vecesNoSí
Esta habilidad20 segSíSíSí✅ Funciona en VPS

Manejo de Errores

Si falla la obtención de la transcripción:

  • Verifica si el video tiene subtítulos habilitados
  • Intenta con lang: 'en' como respaldo si el idioma solicitado no está disponible
  • Informa al usuario que la transcripción no está disponible y sugiere alternativas:
    • Función de transcripción manual de YouTube (Configuración → Mostrar transcripción)
    • El video puede no tener subtítulos
    • Prueba con un video diferente

Si el servidor MCP no está instalado:

  • Proporciona instrucciones de instalación
  • Ofrece instalarlo automáticamente si está en el contexto adecuado

Si falla la extracción del ID del video:

  • Pide al usuario que proporcione la URL completa de YouTube o el ID del video

Si el video tiene restricción de edad o es privado:

  • Informa al usuario que no se puede acceder a la transcripción debido a restricciones
  • Sugiere verificar la configuración de privacidad del video

Ejemplos

Ejemplo 1: Tutorial Tecnológico

Entrada: https://youtube.com/watch?v=dQw4w9WgXcQ

Salida:

📹 **Video:** "Construyendo un SaaS Desde Cero: Lecciones de $10K MRR"
👤 **Canal:** IndieHackerTV | 👁️ **Vistas:** 124K | 📅 **Publicado:** 1 Feb 2026

**🎯 Tesis Principal:**
La mayoría de los fundadores de SaaS fracasan porque construyen durante 6 meses antes de hablar con los clientes. El camino hacia $10K MRR son las conversaciones con los clientes primero, el MVP segundo.

**💡 Ideas Clave:**
- Entrevistó a 50 clientes potenciales antes de escribir una sola línea de código
- El primer cliente de pago se registró con un mockup de Figma (sin producto construido aún)
- Cobró $99/mes desde el día 1 (sin nivel gratuito, sin descuentos)
- Gastó $0 en anuncios; todo el crecimiento provino de la participación en Twitter + Reddit
- Alcanzó $10K MRR en 9 meses diciendo "no" a las solicitudes de funciones que no encajaban en el ICP

📝 **Puntos Notables:**
- Usó enlaces de pago de Stripe antes de construir un sistema de facturación
- Los primeros 3 clientes llegaron al resolver su problema en público en Twitter
- Las actualizaciones semanales de "construir en público" en Twitter impulsaron el 40% de los registros

🔑 **Conclusión:**
Valida la demanda antes de construir. Si 10 personas no pagan por un mockup, 1000 no pagarán por el producto real.

Ejemplo 2: Video de Estrategia Empresarial

Entrada: https://youtu.be/abc123xyz

Salida:

📹 **Video:** "Por Qué el Modelo de Negocio de Notion es Genial"
👤 **Canal:** SaaS Breakdowns | 👁️ **Vistas:** 456K | 📅 **Publicado:** 28 Ene 2026

**🎯 Tesis Principal:**
La estrategia de crecimiento de Notion invierte el SaaS tradicional: regala el producto gratis a individuos y monetiza cuando lo llevan al trabajo.

**💡 Ideas Clave:**
- El 80% de los acuerdos empresariales de Notion comenzaron con un solo empleado usando el plan gratuito
- Adopción de abajo hacia arriba = equipo de ventas cero necesario para los primeros $10M ARR
- El mercado de plantillas creó un volante de contenido (más de 100,000 plantillas gratuitas)
- Tasa de conversión de uso personal (gratuito) a uso en equipo (de pago): 23% (promedio de la industria: 2-5%)
- El evangelismo de la comunidad reemplazó el marketing tradicional (más de 4 millones de miembros en Reddit/Discord)

📝 **Puntos Notables:**
- Coeficiente viral de Notion: 1.4 (cada usuario invita a 1.4 otros en promedio)
- Los creadores de plantillas impulsan el 30% de la adquisición de nuevos usuarios
- Estrategia de precios: gratis hasta 10 personas = sin fricción para empezar

🔑 **Conclusión:**
Construye primero un producto que los individuos amen. Las ventas empresariales llegarán cuando los empleados lo exijan en el trabajo.

Directrices de Calidad

  • Sé conciso: El resumen debe poder escanearse en 30 segundos
  • Sé preciso: No agregues información que no esté en la transcripción
  • Sé estructurado: Usa un formato consistente para facilitar la lectura
  • Sé contextual: Ajusta el nivel de detalle según la duración del video
    • Videos cortos (<5 min): Resumen breve (3 ideas clave)
    • Videos medianos (5-30 min): Formato estándar (5 ideas clave)
    • Videos largos (>30 min): Desglose detallado (7+ ideas, dividido en secciones si es necesario)
  • Extrae valor: Concéntrate en ideas procesables, puntos de datos y opiniones contrarias (no en consejos genéricos)

Consejos Profesionales

Para Mejores Resúmenes:

  1. Prioriza los puntos de datos - Los números, porcentajes y citas de estudios destacan
  2. Extrae citas - Las frases memorables hacen que los resúmenes sean compartibles
  3. Identifica marcos - Si el video presenta un método/proceso, extrae los pasos
  4. Detecta opiniones contrarias - La sabiduría no convencional es más valiosa que los consejos comunes
  5. Anota pruebas - Ejemplos, casos de estudio, resultados de antes/después añaden credibilidad

Para Flujos de Trabajo de Investigación:

  1. Construye una biblioteca de transcripciones - Organiza por tema/niche para detectar patrones
  2. Busca en todas las transcripciones - Usa grep o búsqueda de texto para encontrar menciones de temas específicos
  3. Rastrea tendencias - El mismo tema en varios videos = tendencia creciente
  4. Extrae indicaciones - Guarda marcos/métodos útiles como indicaciones reutilizables

Para Creación de Contenido:

  1. Encuentra brechas de contenido - ¿Qué preguntas se hacen pero no se responden completamente?
  2. Analiza los de mejor rendimiento - ¿Qué estructura/ritmo usan los videos con más vistas?
  3. Extrae ganchos - Los primeros 30 segundos de la transcripción = patrones de gancho probados
  4. Reutiliza ideas - Convierte las ideas del video en hilos de Twitter, publicaciones de blog, boletines

Configuración

Modo Estándar (predeterminado)

youtube-summarizer [URL]
  • Obtiene la transcripción en inglés
  • Genera un resumen estructurado
  • Guarda la transcripción en un archivo
  • Envía a la plataforma de mensajería si corresponde

Modo Rápido

youtube-summarizer [URL] --quick
  • Solo tesis + 3 ideas clave
  • No se guarda archivo de transcripción
  • Procesamiento más rápido para investigación rápida

Modo de Inmersión Profunda

youtube-summarizer [URL] --deep
  • Resumen extendido con marcas de tiempo
  • Desglose sección por sección para videos largos
  • Incluye todas las citas notables

Específico de Idioma

youtube-summarizer [URL] --lang es
  • Obtiene la transcripción en el idioma especificado
  • Retrocede al inglés si no está disponible

Instalación y Configuración

# 1. Clonar e instalar el servidor 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. Probar la instalación
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. Crear directorio de transcripciones
mkdir -p /root/clawd/transcripts

# 4. Verificar que la habilidad está lista
youtube-summarizer --check-setup

Problemas Comunes

Problema: "Transcripción no disponible"

  • Causa: El video no tiene subtítulos habilitados
  • Solución: Pide al creador del video que habilite los subtítulos, o prueba con un video diferente

Problema: "Error al obtener la transcripción" (en VPS)

  • Causa: YouTube puede haber actualizado su API
  • Solución: Actualiza el servidor MCP: cd /root/clawd/mcp-server-youtube-transcript && git pull && npm install && npm run build

Problema: "ID de video no reconocido"

  • Causa: URL mal formada o formato no compatible
  • ** Solución:* Pide al usuario la URL completa de YouTube o el ID del video de 11 caracteres

Problema: "Video con restricción de edad"

  • Causa: YouTube bloquea el acceso a videos con restricción de edad
  • Solución: El usuario debe ver el video directamente en YouTube

Problema: "Límite de velocidad excedido"

  • Causa: Demasiadas solicitudes en poco tiempo
  • Solución: Espera unos minutos y vuelve a intentarlo. El servidor MCP maneja la limitación de velocidad automáticamente.

Preguntas Frecuentes

P: ¿Puedo usar esto con videos en vivo o transmisiones? R: No, los videos en vivo y las transmisiones no tienen transcripciones disponibles hasta que se procesan después de la transmisión.

P: ¿Qué idiomas se soportan? R: Cualquier idioma que YouTube soporte para subtítulos. Usa el parámetro --lang con un código de idioma ISO (p. ej., es para español, fr para francés). Si el idioma solicitado no está disponible, se usará el inglés como respaldo.

P: ¿Cuánto almacenamiento necesito para las transcripciones? R: Aproximadamente 10-50 KB por transcripción. 10,000 transcripciones ocuparían aproximadamente 500 MB.

P: ¿Puedo buscar en transcripciones guardadas? R: Sí, usa grep -r "término de búsqueda" /root/clawd/transcripts/ para buscar en todas las transcripciones guardadas.

P: ¿Qué sucede si el video tiene más de 2 horas? R: El resumen se ajustará automáticamente con más secciones e ideas. La transcripción completa siempre se guarda para referencia.

Seguridad y Privacidad

  • Sin almacenamiento en la nube: Todas las transcripciones se almacenan localmente en /root/clawd/transcripts/
  • Sin seguimiento: No se envían datos a servidores externos excepto para obtener la transcripción de YouTube
  • Sin registro: No se registran las URLs de los videos ni los patrones de uso
  • Datos del usuario: Los archivos de transcripción son solo de lectura para el usuario que inicia la habilidad

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 relacionados