Herramienta de Contenido de YouTube
Cuándo usarla
Úsala cuando el usuario comparta una URL de YouTube o enlace de video, pida resumir un video, solicite una transcripción, o quiera extraer y reformatear contenido de cualquier video de YouTube. Transforma transcripciones en contenido estructurado (capítulos, resúmenes, hilos, publicaciones de blog).
Extrae transcripciones de videos de YouTube y conviértelas en formatos útiles.
Configuración
Usa uv para que la dependencia se instale en el mismo entorno gestionado por Hermes que ejecuta el script auxiliar:
uv pip install youtube-transcript-api
Script Auxiliar
SKILL_DIR es el directorio que contiene este archivo SKILL.md. El script acepta cualquier formato estándar de URL de YouTube, enlaces cortos (youtu.be), shorts, embeds, enlaces en vivo, o un ID de video de 11 caracteres sin formato.
# Salida JSON con metadatos
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"
# Texto plano (ideal para pasarlo a otros procesos)
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only
# Con marcas de tiempo
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps
# Idioma específico con cadena de respaldo
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en
Formatos de Salida
Después de obtener la transcripción, formatéala según lo que pida el usuario:
- Capítulos: Agrupa por cambios de tema, genera lista de capítulos con marcas de tiempo
- Resumen: Visión general concisa de 5 a 10 oraciones de todo el video
- Resúmenes por capítulo: Capítulos con un breve párrafo de resumen para cada uno
- Hilo: Formato de hilo para Twitter/X: publicaciones numeradas, cada una de menos de 280 caracteres
- Publicación de blog: Artículo completo con título, secciones y conclusiones clave
- Citas: Citas destacadas con marcas de tiempo
Ejemplo: salida de Capítulos
00:00 Introducción — el presentador abre con el planteamiento del problema
03:45 Antecedentes — trabajo previo y por qué las soluciones existentes no son suficientes
12:20 Método principal — recorrido del enfoque propuesto
24:10 Resultados — comparativas de referencia y conclusiones clave
31:55 Preguntas y respuestas — preguntas del público sobre escalabilidad y próximos pasos
Flujo de Trabajo
- Obtén la transcripción usando el script auxiliar con
--text-only --timestampsmedianteuv run python3. - Valida: confirma que la salida no esté vacía y esté en el idioma esperado. Si está vacía, reintenta sin
--languagepara obtener cualquier transcripción disponible. Si sigue vacía, informa al usuario que el video probablemente tiene las transcripciones desactivadas. - Divide en fragmentos si es necesario: si la transcripción supera aproximadamente 50 000 caracteres, divídela en fragmentos superpuestos (~40 000 con 2000 de superposición) y resume cada fragmento antes de fusionarlos.
- Transforma al formato de salida solicitado. Si el usuario no especificó un formato, usa un resumen por defecto.
- Verifica: vuelve a leer la salida transformada para comprobar coherencia, marcas de tiempo correctas y completitud antes de presentarla.
Manejo de Errores
- Transcripción desactivada: informa al usuario; sugiere que verifique si hay subtítulos disponibles en la página del video.
- Video privado o no disponible: transmite el error y pide al usuario que verifique la URL.
- Sin idioma coincidente: reintenta sin
--languagepara obtener cualquier transcripción disponible, luego notifica al usuario el idioma real. - Falta la dependencia: ejecuta
uv pip install youtube-transcript-apiy reintenta.