¿Qué hace Resumidor de YouTube?
Propósito
Esta habilidad extrae transcripciones de videos de YouTube y genera resúmenes completos y detallados utilizando el marco STAR + R-I-S-E. Valida la disponibilidad del video, extrae la transcripción usando la biblioteca Python youtube-transcript-api y produce documentación detallada que captura todas las ideas, argumentos y puntos clave.
La habilidad está diseñada para usuarios que necesitan un análisis de contenido exhaustivo y documentación de referencia a partir de videos educativos, conferencias, tutoriales o contenido informativo.
Cuándo usar esta habilidad
Esta habilidad debe usarse cuando:
- El usuario proporciona una URL de YouTube y desea un resumen detallado
- El usuario necesita documentar el contenido del video para consultarlo sin tener que volver a verlo
- El usuario quiere extraer ideas, puntos clave y argumentos de contenido educativo
- El usuario necesita transcripciones de videos de YouTube para su análisis
- El usuario pide "resumir", "sintetizar" o "extraer contenido" de videos de YouTube
- El usuario desea documentación completa que priorice la integridad sobre la brevedad
Paso 0: Descubrimiento y configuración
Antes de procesar videos, valida el entorno y las dependencias:
# Verificar si youtube-transcript-api está instalado
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
echo "⚠️ youtube-transcript-api no encontrado"
# Ofrecer instalar
fi
# Verificar disponibilidad de Python
if ! command -v python3 &>/dev/null; then
echo "❌ Python 3 es necesario pero no está instalado"
exit 1
fi
Preguntar al usuario si falta la dependencia:
youtube-transcript-api es necesario pero no está instalado.
¿Deseas instalarlo ahora?
- [ ] Sí - Instalar con pip (pip install youtube-transcript-api)
- [ ] No - Lo instalaré manualmente
Si el usuario selecciona "Sí":
pip install youtube-transcript-api
Verificar la instalación:
python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api instalado correctamente')"
Flujo de trabajo principal
Pautas de seguimiento del progreso
A lo largo del flujo de trabajo, muestra un indicador visual de progreso antes de cada paso para mantener informado al usuario. El formato del indicador es:
echo "[████░░░░░░░░░░░░░░░░] 20% - Paso 1/5: Validando URL"
Especificaciones de formato:
- 20 caracteres de ancho (usa █ para completado, ░ para vacío)
- Incrementos de porcentaje: Paso 1=20%, Paso 2=40%, Paso 3=60%, Paso 4=80%, Paso 5=100%
- Contador de pasos que muestra actual/total (ej. "Paso 3/5")
- Breve descripción de la fase actual
Mostrar el cuadro de estado inicial antes del Paso 1:
╔══════════════════════════════════════════════════════════════╗
║ 📹 RESUMIDOR DE YOUTUBE - Procesando video ║
╠══════════════════════════════════════════════════════════════╣
║ → Paso 1: Validando URL [EN PROGRESO] ║
║ ○ Paso 2: Verificando disponibilidad ║
║ ○ Paso 3: Extrayendo transcripción ║
║ ○ Paso 4: Generando resumen ║
║ ○ Paso 5: Formateando salida ║
╠══════════════════════════════════════════════════════════════╣
║ Progreso: ██████░░░░░░░░░░░░░░░░░░░░░░░░ 20% ║
╚══════════════════════════════════════════════════════════════╝
Paso 1: Validar URL de YouTube
Objetivo: Extraer el ID del video y validar el formato de la URL.
Formatos de URL admitidos:
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
Acciones:
# Extraer el ID del video usando regex o análisis de URL
URL="$URL_PROVIDED_BY_USER"
# Patrón 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/')
# Patrón 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 "❌ Formato de URL de YouTube inválido"
exit 1
fi
echo "📹 ID del video extraído: $VIDEO_ID"
Si la URL es inválida:
❌ URL de YouTube inválida
Proporciona una URL de YouTube válida en uno de estos formatos:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
Ejemplo: https://www.youtube.com/watch?v=dQw4w9WgXcQ
Paso 2: Verificar disponibilidad del video y la transcripción
Progreso:
echo "[████████░░░░░░░░░░░░] 40% - Paso 2/5: Verificando disponibilidad"
Objetivo: Verificar que el video existe y la transcripción es accesible.
Acciones:
from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys
video_id = sys.argv[1]
try:
# Obtener lista de transcripciones disponibles
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print(f"✅ Video accesible: {video_id}")
print("📝 Transcripciones disponibles:")
for transcript in transcript_list:
print(f" - {transcript.language} ({transcript.language_code})")
if transcript.is_generated:
print(" [Generada automáticamente]")
except TranscriptsDisabled:
print(f"❌ Las transcripciones están deshabilitadas para el video {video_id}")
sys.exit(1)
except NoTranscriptFound:
print(f"❌ No se encontró transcripción para el video {video_id}")
sys.exit(1)
except Exception as e:
print(f"❌ Error al acceder al video: {e}")
sys.exit(1)
Manejo de errores:
| Error | Mensaje | Acción |
|---|---|---|
| Video no encontrado | "❌ El video no existe o es privado" | Preguntar al usuario que verifique la URL |
| Transcripciones deshabilitadas | "❌ Las transcripciones están deshabilitadas para este video" | No se puede continuar |
| No hay transcripción disponible | "❌ No se encontró transcripción (no generada automáticamente ni añadida manualmente)" | No se puede continuar |
| Video privado/restringido | "❌ El video es privado o está restringido" | Solicitar un video público |
Paso 3: Extraer transcripción
Progreso:
echo "[████████████░░░░░░░░] 60% - Paso 3/5: Extrayendo transcripción"
Objetivo: Obtener la transcripción en el idioma preferido.
Acciones:
from youtube_transcript_api import YouTubeTranscriptApi
video_id = "VIDEO_ID"
try:
# Intentar obtener la transcripción en el idioma preferido del usuario primero
# Recurrir al inglés si no está disponible
transcript = YouTubeTranscriptApi.get_transcript(
video_id,
languages=['pt', 'en'] # Preferir portugués, recurrir al inglés
)
# Combinar segmentos de la transcripción en un texto completo
full_text = " ".join([entry['text'] for entry in transcript])
# Obtener metadatos del video
from youtube_transcript_api import YouTubeTranscriptApi
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print("✅ Transcripción extraída correctamente")
print(f"📊 Longitud de la transcripción: {len(full_text)} caracteres")
# Guardar en archivo temporal para procesamiento
with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
f.write(full_text)
except Exception as e:
print(f"❌ Error al extraer la transcripción: {e}")
exit(1)
Procesamiento de la transcripción:
- Combinar todos los segmentos de la transcripción en un texto coherente
- Conservar la puntuación y el formato cuando esté disponible
- Eliminar segmentos duplicados o superpuestos (si son artefactos de generación automática)
- Almacenar en archivo temporal para su análisis
Paso 4: Generar resumen completo
Progreso:
echo "[████████████████░░░░] 80% - Paso 4/5: Generando resumen"
Objetivo: Aplicar el prompt mejorado STAR + R-I-S-E para crear un resumen detallado.
Prompt aplicado:
Utilizar el prompt mejorado de la Fase 2 (marco STAR + R-I-S-E) con la transcripción extraída como entrada.
Acciones:
- Cargar el texto completo de la transcripción
- Aplicar el prompt de resumen completo
- Usar el modelo de IA (Claude/GPT) para generar un resumen estructurado
- Asegurar que la salida siga la estructura definida:
- Encabezado con metadatos del video
- Síntesis ejecutiva
- Desglose detallado sección por sección
- Ideas clave y conclusiones
- Conceptos y terminología
- Recursos y referencias
Implementación:
# Usar el archivo de transcripción como entrada para el prompt de IA
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"
# El agente de IA:
# 1. Leerá la transcripción
# 2. Aplicará el marco de resumen STAR + R-I-S-E
# 3. Generará una salida Markdown completa
# 4. Estructurará con encabezados, listas y destacados
Leer "$TRANSCRIPT_FILE" # Leer la transcripción en el contexto
Luego aplicar el prompt de resumen completo (de la versión mejorada en la Fase 2).
Paso 5: Formatear y presentar la salida
Progreso:
echo "[████████████████████] 100% - Paso 5/5: Formateando salida"
Objetivo: Entregar el resumen en Markdown limpio y bien estructurado.
Estructura de la salida:
# [Título del Video]
**Canal:** [Nombre del Canal]
**Duración:** [Duración]
**URL:** [https://youtube.com/watch?v=VIDEO_ID]
**Fecha de Publicación:** [Fecha si está disponible]
## 📝 Resumen Detallado
### [Tema 1]
[Explicación completa con ejemplos, datos, citas...]
#### [Subtema 1.1]
[Desglose detallado...]
### [Tema 2]
[Análisis detallado continuado...]
## 📚 Conceptos y Terminología
- **[Término 1]:** [Definición y contexto]
- **[Término 2]:** [Definición y contexto]
## 📌 Conclusión
[Síntesis final y conclusiones clave]
Ejemplo 2: Dependencia faltante
Entrada del usuario:
claude> resume este video de youtube https://youtu.be/abc123
Respuesta de la habilidad:
⚠️ youtube-transcript-api no instalado
Esta habilidad requiere la biblioteca Python 'youtube-transcript-api'.
¿Deseas que la instale ahora?
- [ ] Sí - Instalar con pip
- [ ] No - Lo instalaré manualmente
El usuario selecciona "Sí":
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1
✅ Instalación completa. Procediendo con el resumen del video...
Ejemplo 4: URL inválida
Entrada del usuario:
claude> resume el video de youtube www.youtube.com/some-video
Respuesta de la habilidad:
❌ Formato de URL de YouTube inválido
Ejemplos de formato esperado:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
Proporciona una URL de video de YouTube válida.
📊 Resumen Ejecutivo
Este video proporciona una introducción completa a los conceptos fundamentales de la Inteligencia Artificial (IA), diseñada tanto para principiantes como para profesionales que desean comprender los fundamentos técnicos y las aplicaciones prácticas de la IA moderna. El instructor cubre todo, desde definiciones básicas hasta algoritmos de aprendizaje automático, utilizando ejemplos prácticos y visualizaciones para facilitar la comprensión.
[... resumen detallado continuado ...]
**Opciones de guardado:**
¿Qué te gustaría guardar? → Resumen + transcripción original
✅ Archivo guardado: resumen-ejemplo123-2026-02-01.md (incluye transcripción original) [████████████████████] 100% - ✓ Procesamiento completado
Bienvenido a este tutorial completo sobre fundamentos de aprendizaje automático. En el video de hoy, exploraremos los conceptos centrales que impulsan los sistemas modernos de IA...
---
**Versión:** 1.2.0
**Última actualización:** 2026-02-02
**Mantenido por:** Eric Andrade
## Limitaciones
- Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No consideres la salida como un sustituto de la validación específica del entorno, pruebas o revisión de expertos.
- Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.