YouTubeTranscriptAPI
Um servidor MCP hospedado que permite que Claude, ChatGPT, Cursor e outros aplicativos de IA leiam transcrições do YouTube, pesquisem no YouTube e listem vídeos de um canal ou playlist. Faça login ou use uma chave de API.
Servidor MCP hospedado
npx add-mcp 'https://youtubetranscriptapi.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Servidor MCP do YouTube
Deixe o Claude, o ChatGPT e seu agente de codificação lerem o YouTube: transcrições, busca, canais e playlists. Ele é hospedado, então não há nada para instalar. Cole uma URL no aplicativo e faça login.
URL do servidor
https://youtubetranscriptapi.com/mcp
Funciona com
Escolha seu aplicativo
ClaudeAnyone · Entrar · cerca de 2 minUm conector personalizado que permite ao Claude ler transcrições, buscar no YouTube e listar os vídeos de um canal.Guia de configuração Anyone · Entrar · cerca de 3 minUm plugin personalizado que permite ao ChatGPT ler transcrições de vídeo, buscar no YouTube e listar uploads de canais.Guia de configuração Claude CodeDesenvolvedores · Entrar ou chave de API · cerca de 2 minUm comando adiciona o servidor hospedado; faça login via /mcp ou passe uma chave de API como cabeçalho.Guia de configuração CursorDesenvolvedores · Entrar ou chave de API · cerca de 2 minInstale com um link e entre, ou adicione ao mcp.json com uma chave de API.Guia de configuração VS CodeDesenvolvedores · Entrar ou chave de API · cerca de 2 minDê ao modo agente do Copilot as ferramentas do YouTube: instale com um link e entre, ou adicione algumas linhas ao mcp.json com uma chave que o VS Code pede uma vez.Guia de configuração n8nAutomação · Chave de API · cerca de 5 minDê a um Agente de IA do n8n as ferramentas do YouTube através do nó MCP Client Tool.Guia de configuração WindsurfDesenvolvedores · Chave de API ou entrar · cerca de 3 minO Windsurf agora se chama Devin Desktop.Guia de configuração
Desenvolvedores · Entrar ou chave de API · cerca de 2 minUm comando adiciona o servidor hospedado ao Codex.Guia de configuração Gemini CLIDesenvolvedores · Entrar ou chave de API · cerca de 3 minPassos para ambos os agentes de codificação do Google: Gemini CLI e Antigravity.Guia de configuração OpenClawDesenvolvedores · Chave de API ou entrar · cerca de 4 minAdicione um bloco ao openclaw.json e seu assistente poderá ler vídeos, buscar no YouTube e acompanhar canais, a partir de qualquer aplicativo de chat em que você conversar com ele.Guia de configuração Outros aplicativosZed, Cline, Junie, LM Studio, Perplexity, Le Chat, Zapier…Onde cada um guarda a configuração, e se faz login ou usa uma chave.Ver todos
O que sua IA pode fazer com ele
Sete ferramentas, todas somente leitura. O aplicativo escolhe a certa a partir da sua solicitação; você não precisa nomeá-las.
| Ferramenta | O que faz | Custo |
|---|---|---|
| get_transcript | Lê o que é dito em qualquer vídeo público | 1 crédito |
| search_youtube | Busca no YouTube por vídeos ou canais | 4 créditos |
| search_channel | Busca um tópico nos vídeos de um canal | 1 crédito |
| list_channel_videos | Lista os 100 uploads mais recentes de um canal | 20 créditos |
| get_latest_videos | Mostra os 15 vídeos mais novos de um canal | Grátis |
| resolve_channel | Converte um @handle em um ID de canal | Grátis |
| list_playlist_videos | Lista os vídeos de uma playlist | 20 créditos |
- Chamadas com falha nunca são cobradas: um vídeo sem legendas, um link inválido, um timeout.
- Uma transcrição longa volta em partes. Partes posteriores, e reler o mesmo vídeo dentro de 24 horas, não custam nada.
- Ferramentas gratuitas ainda precisam de um saldo de pelo menos 1 crédito.
- Contas novas recebem 100 créditos grátis, sem cartão. Veja os planos.
Como funciona a conexão
- Claude e ChatGPT fazem login: o aplicativo abre youtubetranscriptapi.com, você entra ou cria uma conta e aprova esse aplicativo em uma tela de consentimento. Cada aplicativo conectado aparece em Dashboard → Connect apps, onde um clique o desconecta.
- Cursor, VS Code, Claude Code e n8n podem entrar da mesma forma ou enviar uma chave de API como cabeçalho (
Authorization: Bearer tk_live_…). Revogue uma chave em Dashboard → API Keys. - De qualquer forma, o aplicativo usa seus créditos pelos mesmos preços da API REST, e apenas para as chamadas que faz.
Por que usar um servidor hospedado
Nada para instalar
Sem Python, sem Node, sem servidor local para manter rodando. Funciona no Claude e no ChatGPT na web, onde servidores locais não podem rodar.
Sem bloqueios do YouTube para enfrentar
Scripts que buscam legendas da sua própria máquina frequentemente sofrem limitação de taxa ou bloqueio de IP pelo YouTube. Nós lidamos com isso, então você não vê os erros 429 do YouTube.
Chamadas com falha são gratuitas
Um vídeo sem legendas, um link inválido ou um timeout não custam nada. Apenas chamadas bem-sucedidas usam créditos.
100 créditos grátis
Suficiente para cerca de 100 transcrições, sem cartão. Depois disso, os planos começam em US$ 7 por mês para 1.000 créditos.
Coisas para pedir depois que estiver conectado
Summarize this video in five bullet points: <link>
What did the speaker say about pricing, with timestamps? <link>
Find videos from @channel about onboarding and compare what they recommend.
What has @channel posted this week? Summarize each new video in two lines.
Turn this lecture into study notes with headings and a short quiz: <link>
Para agentes que você configura uma vez e reutiliza, como um resumidor de vídeos ou um resumo diário de novos uploads, veja as receitas de agentes de IA do YouTube.
Bom saber
- Listagens de canais e playlists retornam apenas a primeira página: até 100 vídeos.
- Transcrições longas voltam em partes que o aplicativo lê uma após a outra. Partes posteriores são gratuitas por 24 horas.
- Cada chave ou aplicativo conectado pode fazer até 300 solicitações por minuto.
- As ferramentas apenas leem dados públicos do YouTube. Elas não podem postar, comentar ou alterar nada no YouTube ou na sua conta.
Detalhes do protocolo, parâmetros das ferramentas e códigos de erro estão na referência MCP.
Nomes de produtos e logotipos pertencem aos seus donos e são mostrados apenas para indicar com quais aplicativos isso funciona. OpenAI, ChatGPT, Codex e o logotipo da OpenAI são marcas registradas da OpenAI. O YouTubeTranscriptAPI não é afiliado nem endossado por eles.
Conecte seu primeiro aplicativo
Escolha um guia acima, ou crie sua conta gratuita agora: 100 créditos, sem cartão.