Transcrições do YouTube para Agentes de IA
Um servidor MCP, uma API REST, e um fluxo de cadastro que um agente pode concluir totalmente sozinho. Nenhum humano precisa criar uma conta ou colar uma chave.
Cadastro self-service, sem humano no processo
A maioria das APIs de transcrição exige que uma pessoa se cadastre, abra um painel e copie uma chave antes que um agente possa fazer sua primeira chamada. Esta não. Duas requisições e o agente já tem uma chave funcional com 100 créditos grátis.
Passo 1 — solicite um código (nenhuma chave de API necessária):
curl -X POST https://getyoutubetranscript.com/api/v1/signup \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'Passo 2 — troque o código por uma chave:
curl -X POST https://getyoutubetranscript.com/api/v1/signup/verify \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]", "otp": "123456"}'
# => { "success": true, "api_key": "sk_live_..." }Conecte via MCP
Streamable HTTP, então nada roda localmente. Funciona com Claude Desktop, Claude Code, Cursor, Windsurf, e qualquer outro cliente compatível com MCP. OAuth 2.1 com Dynamic Client Registration é suportado para clientes que se autenticam dessa forma.
{
"mcpServers": {
"getyoutubetranscript": {
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}| Ferramenta | O que faz | Custo |
|---|---|---|
get_youtube_transcript | Transcrição completa mais título, autor e miniatura | 1 crédito |
search_youtube | Busca vídeos ou canais, com paginação | 1 crédito |
get_channel_latest_videos | Metadados de um canal e uploads recentes | Grátis |
search_channel_videos | Busca dentro de um canal | 1 crédito |
list_channel_videos | Todos os vídeos que um canal enviou | 1 crédito |
list_playlist_videos | Todos os vídeos de uma playlist | 1 crédito |
Ou simplesmente chame a API REST
curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ" \
-H "Authorization: Bearer sk_live_..."A referência completa de endpoints, parâmetros e formatos de resposta está na documentação da API. Também há uma skill de agente para download e um guia de configuração de MCP passo a passo.
Sem cota do YouTube para gerenciar
A YouTube Data API oficial dá a cada projeto 10.000 unidades/dia, e apenas captions.download custa 200 unidades por chamada, além de OAuth. Esta API não faz proxy desse endpoint com sua chave, então não há teto diário para se preocupar — apenas a taxa de requisições do plano. Veja o guia de cotas para o detalhamento completo.
Prefere começar por um painel? Crie uma chave manualmente — 100 créditos grátis, sem cartão necessário.
Perguntas frequentes sobre integração de agentes
Um agente realmente consegue se cadastrar sozinho, sem um humano?
Sim. Faça um POST de um e-mail para /api/v1/signup para gerar um código de 6 dígitos, depois faça um POST do e-mail e do código para /api/v1/signup/verify e a resposta contém uma chave de API ativa. Sem visitar o painel, sem cartão, sem etapa humana. A chave começa com 100 créditos grátis.
Preciso do servidor MCP, ou posso simplesmente usar REST?
Qualquer um dos dois. MCP é a opção melhor quando um modelo precisa decidir quando buscar uma transcrição no meio de uma conversa, porque as ferramentas são autodescritivas e o cliente as descobre automaticamente. REST puro é a opção melhor dentro de um pipeline onde seu próprio código decide quando chamar.
Quanto custa rodar um agente nisso?
100 créditos grátis para começar, depois $5/mês por 1.000 créditos (ou $4,50/mês faturado anualmente). Um crédito é uma requisição bem-sucedida. Requisições com falha ou limitadas por taxa nunca são cobradas, então um loop de retentativas não consegue drenar um saldo silenciosamente.
Quais são os limites de taxa?
60 requisições/minuto no plano gratuito, 200 no mensal, 300 no anual, aplicados como uma janela fixa de 1 minuto por chave de API. Um 429 significa que você deve desacelerar, não que ficou sem créditos - veja o guia de limite de taxa para o backoff correto.
Isso consome minha cota da YouTube Data API?
Não. Não fazemos proxy de captions.download com sua chave, então não há um teto diário de 10.000 unidades para gerenciar. Você está limitado apenas pela taxa de requisições do seu plano.