TranscriptFetch

API de transcripciones para IA: YouTube, TikTok, Instagram y podcasts a texto estructurado y limpio, con un servidor MCP para agentes.

Documentación

TranscriptFetch

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

  1. Crea una cuenta gratuita en transcriptfetch.com. No se necesita tarjeta.
  2. Abre Panel de control, luego claves de API y crea una clave. Comienza con tf_live_.
  3. Colócala en TRANSCRIPTFETCH_API_KEY en 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

HerramientaQué hace
get_transcriptTranscripció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_videosBusca en YouTube por palabra clave
list_channel_videosLista los videos de un canal de YouTube (usuario, ID o URL)
list_playlist_videosLista los videos de una lista de reproducción de YouTube (ID o URL)
get_creditsSaldo 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 entornoRequeridaPredeterminado
TRANSCRIPTFETCH_API_KEYninguna
TRANSCRIPTFETCH_BASE_URLnohttps://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

Licencia

MIT