TranscriptFetch

API de transcrição para IA - YouTube, TikTok, Instagram e podcasts para texto estruturado e limpo, com um servidor MCP para agentes.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP TranscriptFetch

Um servidor Model Context Protocol que dá a qualquer cliente MCP (Claude Desktop, Cursor e outros) acesso à API TranscriptFetch: uma API de transcrição em produção para YouTube, TikTok e Instagram, com transcrição por IA quando as legendas não estão disponíveis. Busque transcrições, pesquise vídeos, liste canais e playlists e verifique seu saldo de créditos.

Obtenha uma chave de API

Crie uma conta gratuita em transcriptfetch.com. Não é necessário cartão de crédito.
Abra Dashboard, depois API keys e crie uma chave. Ela começa com tf_live_.
Coloque-a em TRANSCRIPTFETCH_API_KEY na configuração do cliente abaixo.

Toda conta recebe 50 créditos gratuitos por mês. Falhas são gratuitas: uma busca que não retorna transcrição nunca é cobrada.

Funciona localmente via stdio e chama a API TranscriptFetch com sua chave. Prefere um servidor remoto hospedado? Aponte seu cliente para https://transcriptfetch.com/mcp (OAuth ou chave de API). O servidor hospedado aguarda inline pela transcrição por IA de vídeos curtos, então não é necessário polling lá.

Ferramentas

Ferramenta	O que faz
`get_transcript`	Transcrição de um vídeo. YouTube, TikTok, Instagram ou URL de mídia direta. Defina `ai_fallback: true` para transcrever o áudio quando não houver legendas (normalmente ~30 segundos para vídeos curtos, mais para vídeos longos)
`search_videos`	Pesquisa no YouTube por palavra-chave
`list_channel_videos`	Lista os vídeos de um canal do YouTube (handle, ID ou URL)
`list_playlist_videos`	Lista os vídeos de uma playlist do YouTube (ID ou URL)
`get_credits`	Saldo de créditos restante para a chave. Nunca é cobrado

O preço é por resultado bem-sucedido: uma busca de legendas ou uma lista de vídeos custa 1 crédito, e a transcrição por IA do áudio custa 1 crédito por minuto iniciado de áudio, cobrada apenas na entrega. Resultados com falha, bloqueados ou vazios nunca são cobrados, o que importa em vídeos curtos onde muitos clipes não têm fala alguma.

Instalação

Não é necessária instalação. Execute sob demanda com npx:

TRANSCRIPTFETCH_API_KEY=tf_live_... npx -y transcriptfetch-mcp

Ou instale globalmente:

npm install -g transcriptfetch-mcp

Requer Node 18+.

Executar a partir do código-fonte

git clone https://github.com/TranscriptFetch/mcp-server
cd mcp-server && npm install && npm run build

Depois aponte seu cliente para o entrypoint compilado com "command": "node" e "args": ["/absolute/path/to/mcp-server/dist/index.js"].

Configuração do cliente

Claude Desktop

Adicione isto a claude_desktop_config.json (Settings, depois Developer, depois Edit Config):

{
  "mcpServers": {
    "transcriptfetch": {
      "command": "npx",
      "args": ["-y", "transcriptfetch-mcp"],
      "env": { "TRANSCRIPTFETCH_API_KEY": "tf_live_..." }
    }
  }
}

Cursor

Adicione o mesmo bloco em mcpServers nas configurações MCP do Cursor.

Reinicie o cliente e as cinco ferramentas aparecerão.

Exemplo

Depois de conectado, pergunte ao seu assistente de forma natural:

Obtenha a transcrição de https://youtu.be/aircAruvnKk e resuma os pontos principais.

Pesquise no YouTube por "how transformers work" e liste os 5 principais vídeos.

Liste os vídeos mais recentes de @lexfridman e puxe a transcrição do mais novo.

Quantos créditos do TranscriptFetch ainda tenho?

O assistente escolhe a ferramenta correspondente e trabalha com a transcrição ou lista de vídeos retornada.

Configuração

Variável de ambiente	Obrigatória	Padrão
`TRANSCRIPTFETCH_API_KEY`	sim	nenhum
`TRANSCRIPTFETCH_BASE_URL`	não	`https://transcriptfetch.com`

Docker

O servidor fala MCP via stdio, então não há porta para expor. -i é obrigatório: sem um stdin anexado, o transporte fecha imediatamente e o container parece ter travado.

docker build -t transcriptfetch-mcp .
docker run --rm -i -e TRANSCRIPTFETCH_API_KEY=tf_live_... transcriptfetch-mcp

Licença

MIT