TranscriptFetch
API de transcripciones para IA: YouTube, TikTok, Instagram y podcasts a texto estructurado y limpio, con un servidor MCP para agentes.
Documentación
Servidor MCP de TranscriptFetch
Un Protocolo de Contexto de Modelo que brinda a cualquier cliente MCP (Claude Desktop, Cursor y otros) acceso a la API de TranscriptFetch: una API de transcripción de producción para YouTube, TikTok e Instagram, con transcripción por IA cuando faltan subtítulos. Obtén transcripciones, busca videos, lista canales y listas de reproducción, y verifica tu saldo de créditos.
Obtén una clave de API
- Crea una cuenta gratuita en transcriptfetch.com. No se necesita tarjeta.
- Abre Panel de control, luego claves de API y crea una clave. Comienza con
tf_live_. - Colócala en
TRANSCRIPTFETCH_API_KEYen la configuración del cliente a continuación.
Cada cuenta recibe 50 créditos gratuitos al mes. Los fallos son gratuitos: una búsqueda que no devuelve transcripción nunca se cobra.
Se ejecuta localmente a través de stdio y llama a la API de TranscriptFetch con tu clave. ¿Prefieres un servidor remoto alojado? Apunta tu cliente a https://transcriptfetch.com/mcp en su lugar (OAuth o clave de API). El servidor alojado espera en línea la transcripción por IA de formato corto, por lo que no se necesita sondeo allí.
Herramientas
| Herramienta | Qué hace |
|---|---|
get_transcript | Transcripción de un video. YouTube, TikTok, Instagram o una URL de medios directa. Configura ai_fallback: true para transcribir el audio cuando no existen subtítulos (normalmente ~30 segundos para videos cortos, más para los largos) |
search_videos | Busca en YouTube por palabra clave |
list_channel_videos | Lista los videos de un canal de YouTube (usuario, ID o URL) |
list_playlist_videos | Lista los videos de una lista de reproducción de YouTube (ID o URL) |
get_credits | Saldo de créditos restante para la clave. Nunca se factura |
El precio es por resultado exitoso: una búsqueda de subtítulos o una lista de videos cuesta 1 crédito, y la transcripción por IA del audio cuesta 1 crédito por minuto iniciado de audio, cobrado solo al entregarse. Los resultados fallidos, bloqueados y vacíos nunca se cobran, lo cual es importante en videos de formato corto donde muchos clips no tienen habla en absoluto.
Instalación
No se necesita instalación. Ejecútalo bajo demanda con npx:
TRANSCRIPTFETCH_API_KEY=tf_live_... npx -y transcriptfetch-mcp
O instálalo globalmente:
npm install -g transcriptfetch-mcp
Requiere Node 18+.
Ejecutar desde el código fuente
git clone https://github.com/TranscriptFetch/mcp-server
cd mcp-server && npm install && npm run build
Luego apunta tu cliente al punto de entrada compilado con "command": "node" y
"args": ["/absolute/path/to/mcp-server/dist/index.js"].
Configuración del cliente
Claude Desktop
Agrega esto a claude_desktop_config.json (Configuración, luego Desarrollador, luego Editar configuración):
{
"mcpServers": {
"transcriptfetch": {
"command": "npx",
"args": ["-y", "transcriptfetch-mcp"],
"env": { "TRANSCRIPTFETCH_API_KEY": "tf_live_..." }
}
}
}
Cursor
Agrega el mismo bloque bajo mcpServers en la configuración de MCP de Cursor.
Reinicia el cliente y aparecerán las cinco herramientas.
Ejemplo
Una vez conectado, pídele a tu asistente de forma natural:
Obtén la transcripción de https://youtu.be/aircAruvnKk y resume los puntos clave.
Busca en YouTube "cómo funcionan los transformadores" y lista los 5 mejores videos.
Lista los videos más recientes de @lexfridman y extrae la transcripción del más nuevo.
¿Cuántos créditos de TranscriptFetch me quedan?
El asistente elige la herramienta adecuada y trabaja con la transcripción o la lista de videos devuelta.
Configuración
| Variable de entorno | Requerida | Predeterminado |
|---|---|---|
TRANSCRIPTFETCH_API_KEY | sí | ninguna |
TRANSCRIPTFETCH_BASE_URL | no | https://transcriptfetch.com |
Docker
El servidor habla MCP a través de stdio, por lo que no hay puerto que exponer. -i es
requerido: sin un stdin adjunto, el transporte se cierra inmediatamente y el
contenedor parece que se bloqueó.
docker build -t transcriptfetch-mcp .
docker run --rm -i -e TRANSCRIPTFETCH_API_KEY=tf_live_... transcriptfetch-mcp
Enlaces
- Documentación de la API: https://transcriptfetch.com/docs
- Documentación de MCP: https://transcriptfetch.com/docs/mcp
- SDK de Node: https://github.com/TranscriptFetch/node-sdk
- SDK de Python: https://github.com/TranscriptFetch/python-sdk
Licencia
MIT