neoris/TubeScript-API
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
TubeScript-API/QUICKSTART_TRANSCRIPTS.md

3.7 KiB
Raw Blame History

🚀 INICIO RÁPIDO: Obtener Transcripts de YouTube

⚡ Método Más Rápido (30 segundos)

Usando cookies de Chrome directamente:

# 1. Asegúrate de estar logueado en YouTube en Chrome
# 2. Ejecuta este comando:

yt-dlp --cookies-from-browser chrome --skip-download --write-auto-sub \
  --sub-lang es --sub-format vtt -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=K08TM4OVLyo"

# 3. Listo! Verás el archivo: K08TM4OVLyo.es.vtt

🎯 3 Formas de Obtener Transcripts

1️⃣ Script Bash (Recomendado - MÁS FÁCIL)

./get_transcript_chrome.sh VIDEO_ID

Ventajas:

  • ✅ Genera VTT + TXT automáticamente
  • ✅ Muestra preview del contenido
  • ✅ Maneja múltiples perfiles de Chrome

2️⃣ Script Python

python3 fetch_transcript.py VIDEO_ID es chrome

Ventajas:

  • ✅ Genera JSON + TXT
  • ✅ Integrado con el proyecto
  • ✅ Maneja formatos automáticamente

3️⃣ Comando directo yt-dlp

yt-dlp --cookies-from-browser chrome \
  --skip-download --write-auto-sub \
  --sub-lang es --sub-format vtt \
  -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=VIDEO_ID"

Ventajas:

  • ✅ Control total
  • ✅ Personalizable
  • ✅ Para usuarios avanzados

🔑 Usar Perfil Específico de Chrome

Ver perfiles disponibles:

# macOS
ls ~/Library/Application\ Support/Google/Chrome/

# Verás algo como:
# Default
# Profile 1
# Profile 2

Usar un perfil específico:

# Opción 1: Script bash
./get_transcript_chrome.sh VIDEO_ID es chrome "Profile 1"

# Opción 2: Python
python3 fetch_transcript.py VIDEO_ID es "chrome:Profile 1"

# Opción 3: yt-dlp directo
yt-dlp --cookies-from-browser "chrome:Profile 1" \
  --skip-download --write-auto-sub \
  --sub-lang es --sub-format vtt \
  -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=VIDEO_ID"

❌ Si te sale "HTTP Error 429"

YouTube está bloqueando tu IP. Solución rápida con Tor:

# 1. Instalar Tor
brew install tor  # macOS
# sudo apt install tor  # Linux

# 2. Iniciar Tor
tor &

# 3. Usar con proxy
yt-dlp --cookies-from-browser chrome \
  --proxy "socks5h://127.0.0.1:9050" \
  --skip-download --write-auto-sub \
  --sub-lang es --sub-format vtt \
  -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=VIDEO_ID"

📊 Ejemplo Completo

# 1. Obtener transcript
./get_transcript_chrome.sh K08TM4OVLyo es chrome

# Salida:
# ✅ Archivo generado: K08TM4OVLyo.es.vtt
# 💾 Texto guardado en: K08TM4OVLyo_transcript.txt

# 2. Ver el transcript
cat K08TM4OVLyo_transcript.txt

# 3. Subir al API (opcional)
curl -X POST "http://127.0.0.1:8000/upload_vtt/K08TM4OVLyo" \
  -F "file=@K08TM4OVLyo.es.vtt" | jq .

🆘 Problemas Comunes

Problema Solución
"Unable to extract cookies" Cierra Chrome: killall "Google Chrome"
"HTTP Error 429" Usa Tor/VPN (ver arriba)
No se genera archivo Verifica que estés logueado en YouTube
"yt-dlp not found" Instala: pip install yt-dlp

📚 Más Información

  • Guía completa Chrome: GUIA_CHROME_TRANSCRIPTS.md
  • Soluciones HTTP 429: SOLUCION_HTTP_429_TRANSCRIPT.md
  • API Endpoints: Consulta /docs de la API

🎬 Demo de 30 segundos

# Instalar yt-dlp (si no lo tienes)
pip install yt-dlp

# Obtener transcript
yt-dlp --cookies-from-browser chrome --skip-download --write-auto-sub \
  --sub-lang es --sub-format vtt -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=K08TM4OVLyo"

# Convertir a texto plano
grep -v "WEBVTT" K08TM4OVLyo.es.vtt | grep -v "^$" | grep -v "^[0-9][0-9]:" > transcript.txt

# Ver el transcript
cat transcript.txt

¡Listo! 🎉

Última actualización: 2025-02-22