YouTube Transcript Extractor

Extrae transcripciones de videos públicos de YouTube.

Documentación

YouTube Transcript Extractor MCP 🎥

Un servidor de Model Context Protocol (MCP) que permite a los asistentes de IA extraer transcripciones de videos de YouTube. Construido para integración con Cursor y Claude Desktop, esta herramienta permite a la IA analizar y trabajar directamente con contenido de video de YouTube.

Características

  • 🎯 Extrae transcripciones de cualquier video público de YouTube
  • 🔌 Integración fácil con Cursor y Claude Desktop
  • 🚀 Construido con TypeScript para seguridad de tipos
  • 📦 Configuración e implementación sencillas
  • 🛠️ Basado en el Model Context Protocol

Requisitos previos

  • Node.js (v16 o superior)
  • pnpm (recomendado) o npm
  • Una URL de video de YouTube para extraer transcripciones

Instalación

  1. Clona el repositorio:
git clone https://github.com/yourusername/yt-mcp.git
cd yt-mcp
  1. Instala las dependencias:
pnpm install
  1. Compila el proyecto:
pnpm run build

Configuración

Para Cursor

  1. Abre la Configuración de Cursor
  2. Navega a MCP → Agregar nuevo servidor MCP
  3. Configura con estos ajustes:
    • Nombre: youtube-transcript
    • Tipo: command
    • Comando: node /absolute/path/to/yt-mcp/build/index.js

Para Claude Desktop

Agrega esta configuración a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "node",
      "args": ["/absolute/path/to/yt-mcp/build/index.js"]
    }
  }
}

Uso

Una vez configurado, la IA puede extraer transcripciones de videos de YouTube llamando a la herramienta con una URL de video. Ejemplo:

// The AI will use this format internally
const transcript = await extractTranscript({
  input: "https://www.youtube.com/watch?v=VIDEO_ID"
});

Detalles técnicos

El servidor está construido usando:

Limitaciones

  • Solo funciona con videos públicos de YouTube
  • Los videos deben tener subtítulos habilitados
  • Algunos videos pueden tener subtítulos generados automáticamente que podrían no ser 100% precisos

Solución de problemas

Problemas comunes y soluciones:

  1. Error "Cannot find video ID"

    • Asegúrate de que la URL de YouTube esté completa y sea correcta
    • Verifica que el video sea de acceso público
  2. Error "No transcript available"

    • Verifica que el video tenga subtítulos habilitados
    • Prueba con un video diferente para confirmar que la herramienta funciona
  3. Errores de compilación

    • Asegúrate de que todas las dependencias estén instaladas
    • Verifica la versión de Node.js (debe ser v16 o superior)

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request. Para cambios importantes, abre primero un issue para discutir lo que te gustaría cambiar.

Licencia

MIT