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
- Clona el repositorio:
git clone https://github.com/yourusername/yt-mcp.git
cd yt-mcp
- Instala las dependencias:
pnpm install
- Compila el proyecto:
pnpm run build
Configuración
Para Cursor
- Abre la Configuración de Cursor
- Navega a MCP → Agregar nuevo servidor MCP
- Configura con estos ajustes:
- Nombre:
youtube-transcript - Tipo:
command - Comando:
node /absolute/path/to/yt-mcp/build/index.js
- Nombre:
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:
- @modelcontextprotocol/sdk - Para la implementación de MCP
- youtube-transcript - Para la extracción de transcripciones
- TypeScript - Para seguridad de tipos y mejor experiencia de desarrollo
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:
-
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
-
Error "No transcript available"
- Verifica que el video tenga subtítulos habilitados
- Prueba con un video diferente para confirmar que la herramienta funciona
-
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