YouTube Transcript

Un servidor sin configuración para extraer transcripciones de videos de YouTube en cualquier plataforma.

Documentación

Servidor MCP remoto de YouTube Transcript

El primer servidor remoto del Model Context Protocol (MCP) que permite a Claude AI extraer transcripciones de videos de YouTube. Este servidor ofrece acceso sin configuración para usuarios en cualquier plataforma, incluidos dispositivos móviles.

🌟 Características

Cero configuración local: No se requiere instalación: funciona directamente desde la nube
Acceso universal: Funciona en versiones de escritorio, móviles y web de Claude
Caché inteligente: Sistema de caché eficiente usando Cloudflare KV para respuestas rápidas
Soporte multilingüe: Extrae transcripciones en diferentes idiomas
Manejo de errores: Manejo robusto de errores con mensajes amigables
Analíticas: Seguimiento de solicitudes y analíticas de uso integradas
Flexibilidad de URL: Maneja todos los formatos de URL de YouTube (youtube.com, youtu.be, m.youtube.com, etc.)

🚀 Inicio rápido

Opción 1: Usar nuestro servidor alojado (Recomendado)

La forma más fácil de comenzar: solo agrega nuestro servidor público a tu Claude Desktop:

Para usuarios de Claude Desktop

Abrir la configuración de Claude Desktop
- Haz clic en "Claude" en la barra de menú → "Configuración"
- Ve a la pestaña "Desarrollador"
- Haz clic en "Editar configuración"

Agregar la configuración del servidor MCP

Agrega esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/sse"
      ]
    }
  }
}

Reiniciar Claude Desktop

Después de guardar el archivo de configuración, reinicia Claude Desktop para cargar el servidor.
Verificar la instalación

Busca el icono de herramientas (🔧) en la interfaz de chat. Deberías ver la herramienta get_transcript disponible.

Opción 2: Implementa el tuyo propio

¿Quieres ejecutar tu propia instancia? Implementa en Cloudflare Workers con un clic:

O manualmente:

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run deploy

Para otros clientes MCP

El servidor soporta el protocolo MCP estándar y puede usarse con cualquier cliente compatible:

URL del servidor público: https://youtube-transcript-mcp.ergut.workers.dev/sse
Transporte: Server-Sent Events (SSE) o HTTP
Autenticación: No se requiere (servidor público)

📖 Ejemplos de uso

Extracción básica de transcripciones

Extract the transcript from this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Soporte multilingüe

Can you get the transcript of this video in Turkish: https://youtu.be/VIDEO_ID

Extract the Spanish transcript from: https://www.youtube.com/watch?v=VIDEO_ID

Formatos de URL compatibles

El servidor maneja automáticamente todos los formatos de URL de YouTube:

https://www.youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
https://m.youtube.com/watch?v=VIDEO_ID
https://www.youtube.com/live/VIDEO_ID
https://www.youtube.com/embed/VIDEO_ID
https://www.youtube.com/shorts/VIDEO_ID
Dominios internacionales (youtube.co.uk, youtube.de, etc.)

Todos los parámetros de seguimiento (como ?si=, &t=, etc.) se eliminan automáticamente.

🛠 Herramientas disponibles

`get_transcript`

Extrae la transcripción de una URL de video de YouTube.

Parámetros:

url (obligatorio): URL del video de YouTube en cualquier formato
language (opcional): Código de idioma para la transcripción (por ejemplo, 'en', 'es', 'fr'). Por defecto es 'en'.

Ejemplo de uso:

{
  "name": "get_transcript",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "language": "en"
  }
}

🔧 Configuración avanzada

Registro de depuración

Para habilitar el registro detallado para solucionar problemas:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/sse",
        "--debug"
      ]
    }
  }
}

Los registros de depuración se crearán en ~/.mcp-auth/{server_hash}_debug.log.

Solo transporte HTTP

Para forzar el transporte HTTP en lugar de SSE:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

📊 Información del servidor

Alojamiento: Cloudflare Workers
Caché: Cloudflare KV con caché de 7 días para transcripciones exitosas
Límite de velocidad: Lógica de reintento integrada con retroceso exponencial
Disponibilidad: 99.9%+ de disponibilidad a través de la red global de Cloudflare
Tiempo de respuesta: Típicamente <3 segundos para contenido en caché, <10 segundos para nuevas solicitudes

🚨 Manejo de errores

El servidor proporciona mensajes de error claros para problemas comunes:

"URL de YouTube no válida proporcionada": El formato de la URL no es reconocido
"No hay transcripción disponible para este video": El video no tiene subtítulos/transcripción
"Video no encontrado o privado": El video es privado, eliminado o no existe
"Servicio temporalmente ocupado, inténtalo de nuevo en unos minutos": Límite de velocidad de YouTube
"Las transcripciones están deshabilitadas para este video": El creador ha deshabilitado los subtítulos

🌍 Soporte de idiomas

El servidor soporta cualquier idioma para el que YouTube proporcione transcripciones. Códigos de idioma comunes:

en - Inglés (predeterminado)
tr - Turco
es - Español
fr - Francés
de - Alemán
it - Italiano
pt - Portugués
ja - Japonés
ko - Coreano
zh - Chino

🔒 Privacidad y seguridad

No se requiere autenticación: Servidor público para facilidad de uso
Sin almacenamiento de datos: Las transcripciones se almacenan en caché temporalmente solo por rendimiento
Sin información personal: Solo se procesan IDs de videos de YouTube y transcripciones
Solo HTTPS: Todas las comunicaciones están cifradas
CORS habilitado: Soporta clientes MCP basados en web

🚀 Endpoints de API

Para desarrolladores que quieran integrarse directamente:

HTTP POST `/mcp`

Endpoint estándar MCP JSON-RPC para integración directa.

Server-Sent Events `/sse`

Endpoint de transporte MCP SSE para comunicación en tiempo real.

Info `/`

Endpoint de información y estado del servidor.

Ejemplo de llamada directa a la API:

curl -X POST https://youtube-transcript-mcp.ergut.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_transcript",
      "arguments": {
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "language": "en"
      }
    }
  }'

🐛 Solución de problemas

Problemas comunes

"Error de conexión" en Claude Desktop
- Asegúrate de tener la última versión de Claude Desktop
- Verifica que mcp-remote esté configurado correctamente
- Intenta agregar la bandera --debug para ver registros detallados
"No se pudo conectar al servidor MCP"
- Verifica tu conexión a internet
- Comprueba que la URL del servidor sea correcta
- Reinicia Claude Desktop después de cambios de configuración
No se devolvió transcripción
- Verifica que la URL de YouTube sea válida y accesible
- Comprueba si el video tiene subtítulos habilitados
- Prueba con un código de idioma diferente si está disponible

Obtener ayuda

Revisar registros: Busca en ~/.mcp-auth/ los registros de depuración
Probar conexión directa: Usa npx -p mcp-remote@latest mcp-remote-client https://youtube-transcript-mcp.ergut.workers.dev/sse
Verificar estado del servidor: Visita https://youtube-transcript-mcp.ergut.workers.dev/
Abrir un problema: GitHub Issues

🤝 Contribuciones

Este es un proyecto de código abierto. ¡Las contribuciones son bienvenidas!

Reportar problemas: ¿Encontraste un error? Por favor abre un problema
Solicitudes de funciones: ¿Tienes ideas para mejoras? ¡Haznos saber!
Contribuciones de código: Se aceptan PRs para mejoras

Configuración de desarrollo

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run dev

📜 Licencia

Este proyecto es de código abierto y está disponible bajo la Licencia MIT.

🙏 Agradecimientos

Construido con el Model Context Protocol de Anthropic
Alojado en Cloudflare Workers
Usa la librería youtube-transcript
Inspirado por la comunidad MCP y los servidores de transcripción locales existentes

¿Listo para potenciar Claude con la extracción de transcripciones de YouTube? Agrega este servidor a tu configuración de Claude Desktop y comienza a extraer transcripciones de cualquier video de YouTube al instante. 🎉