¿Qué hace Descargador de Transcripciones de YouTube?
Skill para extraer y procesar subtítulos de videos de YouTube.
Orden de Prioridad
1. Verificar instalación de yt-dlp
2. Listar subtítulos disponibles
3. Intentar subtítulos manuales primero
4. Recurrir a subtítulos generados automáticamente
5. Último recurso: conversión con Whisper
Requisitos
# macOS
brew install yt-dlp
# Linux
sudo apt install yt-dlp
# Universal
pip install yt-dlp
Flujo de Trabajo
Paso 1: Listar subtítulos disponibles
yt-dlp --list-subs "VIDEO_URL"
Paso 2: Descargar subtítulos manuales (recomendado)
# Subtítulos en español
yt-dlp --write-sub --sub-lang es --skip-download "VIDEO_URL"
# Subtítulos en inglés
yt-dlp --write-sub --sub-lang en --skip-download "VIDEO_URL"
Paso 3: Subtítulos generados automáticamente (recurso alternativo)
yt-dlp --write-auto-sub --sub-lang es --skip-download "VIDEO_URL"
Paso 4: Convertir VTT a texto
# Eliminar marcas de tiempo de archivos VTT
sed '/^[0-9]/d; /^$/d; /-->/d' subtitle.es.vtt > transcript.txt
Procesamiento de Salida
Eliminación de duplicados
Los subtítulos generados automáticamente suelen tener muchas repeticiones debido a los subtítulos progresivos:
# Eliminar líneas duplicadas
vistas = set()
lineas_unicas = []
for linea in lineas:
if linea not in vistas:
vistas.add(linea)
lineas_unicas.append(linea)
Generación de resúmenes
Con los subtítulos extraídos:
- Resumen del contenido principal
- Crear capítulos por marca de tiempo
- Extraer palabras clave principales
Ejemplos
Ejemplo 1: Resumir video de una clase
Usuario: Resúmeme este video de clase - https://youtube.com/watch?v=xxx
Claude:
1. Descargar subtítulos con yt-dlp
2. Convertir VTT a texto
3. Generar resumen del contenido principal
4. Proporcionar índice por marcas de tiempo
Ejemplo 2: Extraer subtítulos multilingües
Usuario: Extrae los subtítulos en inglés y español de este video
Claude:
1. Verificar idiomas disponibles con --list-subs
2. Descargar subtítulos para cada idioma
3. Proporcionar archivos de texto organizados
Manejo de Errores
| Error | Causa | Solución |
|---|---|---|
yt-dlp not found | No instalado | Instalar con brew/apt/pip |
No subtitles available | Sin subtítulos | Sugerir usar Whisper |
Invalid URL | URL incorrecta | Verificar formato de la URL |
Video unavailable | Privado o eliminado | Notificar al usuario |
Recurso Alternativo con Whisper
Si no hay subtítulos disponibles (requiere confirmación del usuario):
# Verificar tamaño del archivo
yt-dlp --print filesize "VIDEO_URL"
# Descargar audio después de la aprobación del usuario
yt-dlp -x --audio-format mp3 "VIDEO_URL"
# Convertir con Whisper
whisper audio.mp3 --language es --model base
Nota: Requiere confirmación del usuario debido al consumo de ancho de banda y tiempo de procesamiento.