YouTube MCP by TranscriptAPI

YouTube Transcript + YouTube Search MCP para Agentes de IA

O MCP de transcrição do YouTube + busca no YouTube mais rápido para agentes de IA. Experimente gratuitamente.
12 ferramentas: transcrições, metadados de vídeo e canal, busca de vídeos, navegação de canais, busca dentro do canal, extração de playlists e monitoramento de novos uploads, para Claude, ChatGPT, Cursor, VS Code, Claude Code e mais de 20 clientes.

Alimentando mais de 15 milhões de transcrições por mês · Mais de 500 mil transcrições processadas diariamente · Tempo de resposta mediano de 49ms Confiável em produção por youtubetotranscript.com (~11M/mês) e recapio.com (~2,8M/mês).

Por que o TranscriptAPI MCP

A maioria dos servidores MCP do YouTube faz uma coisa: puxa uma única transcrição. O TranscriptAPI MCP é um kit completo: transcrições, busca de vídeos, busca de canais, navegação de canais, extração de playlists e monitoramento gratuito de uploads via RSS, tudo a partir de um único endpoint remoto, tudo projetado para agentes de IA.

Amostra rápida:

Find @NASA's three most-viewed videos about the Moon landing,
get the transcript of each, and write a 5-bullet comparison.

Esse único prompt usa 3 das nossas 12 ferramentas (search_youtube, search_channel_videos, get_youtube_transcript) sem que você escreva uma linha de código.

🧩 Instalar como Plugin de Agente _{· mais fácil}

A raiz deste repositório é um pacote compatível com Agent Plugins 1.0.0: o formato portátil publicado em 06/08/2026 e suportado por ChatGPT, Codex, Cursor, GitHub Copilot, Kiro e VS Code. Uma única instalação fornece o servidor MCP e uma habilidade youtube incluída que ensina seu agente quando usar cada ferramenta e como não desperdiçar créditos.

plugin.json                    # Agent Plugins 1.0.0 manifest
mcp.json                       # hosted MCP server, streamable-http, OAuth (no keys)
skills/youtube/SKILL.md        # when + how to use the 12 tools
.cursor-plugin/plugin.json     # Cursor plugin manifest, same MCP + skill (+ marketplace.json)

VS Code: Paleta de Comandos → Chat: Install Plugin From Source, depois cole:

https://github.com/ZeroPointRepo/youtube-mcp

Ou registre um clone local em settings.json:

"chat.pluginLocations": { "/absolute/path/to/youtube-mcp": true }

Cursor: Customize na barra lateral → encontre o plugin → Install. Para um clone local:

git clone https://github.com/ZeroPointRepo/youtube-mcp ~/.cursor/plugins/local/transcriptapi

Depois, Developer: Reload Window.

Adicionar ao Cursor: somente servidor MCP, sem clone. Cole este deeplink no seu navegador:

cursor://anysphere.cursor-deeplink/mcp/install?name=transcriptapi&config=eyJ1cmwiOiJodHRwczovL3RyYW5zY3JpcHRhcGkuY29tL21jcCJ9

ChatGPT, Codex, GitHub Copilot, Kiro, qualquer outro cliente: aponte o mecanismo de plugins do seu cliente para este repositório ou para um clone local. O Agent Plugins 1.0.0 padroniza o formato do pacote, não a instalação, então cada cliente tem seu próprio fluxo de instalação.

Exemplo de 30 segundos

Summarize this video for me: https://youtu.be/UF8uR6Z6KLc

O agente chama get_youtube_transcript, obtém a transcrição completa com timestamps e a resume. Nenhuma chave de API para configurar: a primeira chamada abre um login OAuth (conta gratuita, 100 créditos, sem cartão). Depois, tente:

What has @TED posted in the last month?     → get_channel_latest_videos (free)
Find talks on protein folding, summarize the best three.
                                             → search_youtube, then transcripts

Não há credenciais neste pacote: o Agent Plugins 1.0.0 proíbe segredos embutidos, e a autorização é gerenciada pelo cliente. Verifique o pacote você mesmo:

curl -sO https://agent-plugins.org/schemas/1.0.0/plugin.schema.json
curl -sO https://agent-plugins.org/schemas/1.0.0/mcp.schema.json
npx ajv-cli@5 validate --spec=draft2020 -s plugin.schema.json -d plugin.json
npx ajv-cli@5 validate --spec=draft2020 -s mcp.schema.json    -d mcp.json

🛠️ Instalação Rápida

Requisitos:

• Uma conta TranscriptAPI (cadastre-se gratuitamente, primeiros 100 créditos grátis)
• Uma chave de API do seu painel OU use OAuth (Claude, ChatGPT)

Recomendado: Adicione uma Regra para Invocar Automaticamente o TranscriptAPI

Adicione esta regra ao seu cliente de IA para não precisar pedir transcrições explicitamente:

Quando eu compartilhar uma URL do YouTube, use automaticamente a ferramenta MCP do TranscriptAPI
para buscar a transcrição antes de responder. Isso se aplica a qualquer análise de vídeo,
resumo ou pergunta sobre conteúdo do YouTube.

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

claude mcp add --transport http transcript-api https://transcriptapi.com/mcp

"mcp.servers": {
  "transcript-api": {
    "type": "http",
    "url": "https://transcriptapi.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "serverUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "context_servers": {
    "transcript-api": {
      "source": "remote",
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "type": "streamable-http",
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

amp mcp add transcript-api https://transcriptapi.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

"augment.advanced": {
  "mcpServers": [
    {
      "name": "transcript-api",
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  ]
}

{
  "mcpServers": {
    "transcript-api": {
      "type": "streamable-http",
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "httpUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "httpUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "serverUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "url": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "transcript-api": {
    "url": "https://transcriptapi.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

{
  "url": "https://transcriptapi.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

🔐 Autenticação

Chave de API

Simples e universal. Funciona com todos os clientes MCP.

1. Obtenha sua chave de API no seu painel
2. As chaves começam com o prefixo sk_
3. Adicione à configuração como um token Bearer:

"headers": {
  "Authorization": "Bearer sk_your_api_key_here"
}

Segurança: Armazene chaves em variáveis de ambiente sempre que possível e nunca as envie para o controle de versão.

OAuth 2.1

Autenticação automática e segura, sem gerenciamento manual de chaves.

Dynamic Client Registration (DCR):

• Suportado por: Claude Desktop, Claude Web, ChatGPT
• Basta adicionar a URL do MCP: o cliente se registra automaticamente
• Nenhuma credencial necessária
• Você autoriza uma vez via redirecionamento do navegador

Static Client Registration:

• Suportado por: ChatGPT (opcional)
• Obtenha Client ID + Secret no Painel de Integração MCP
• Mais controle sobre a identidade do cliente

Referência completa: Documentação de autenticação →

🧰 Ferramentas Disponíveis

Todas as 12 ferramentas são expostas automaticamente assim que você se conecta. Chamadas bem-sucedidas custam 1 crédito, a menos que uma ferramenta indique o contrário abaixo. Chamadas com falha ou limitadas por taxa não consomem créditos.

Qual ferramenta de vídeo? Use get_youtube_video_info (grátis) para descobrir os idiomas de transcrição antes de buscar uma transcrição. Use get_video_metadata (1 crédito) para contagens de visualizações/curtidas, data de publicação, descrição, duração, tags ou vídeos relacionados.

1. get_youtube_transcript

Busque a transcrição de qualquer vídeo do YouTube, como markdown (com metadados) ou JSON estruturado. Coloque a saída diretamente em sumarizadores, índices de busca ou pipelines de IA.

Custo: 1 crédito por solicitação bem-sucedida.

Exemplo de saída (markdown):

# Metadata

## Title: Rick Astley - Never Gonna Give You Up
## Author: RickAstleyVEVO

# Transcript

[0.0s] Never gonna give you up
[4.12s] Never gonna let you down

Exemplo de saída (JSON):

{
  "transcript": [
    { "text": "Never gonna give you up", "start": 0.0, "duration": 4.12 },
    { "text": "Never gonna let you down", "start": 4.12, "duration": 3.85 }
  ],
  "metadata": { "title": "Rick Astley...", "author_name": "RickAstleyVEVO" }
}

2. get_youtube_video_info _{· GRATUITO}

Metadados básicos (título, autor, miniatura) mais a lista de idiomas de transcrição disponíveis: chame isso antes de get_youtube_transcript para escolher um idioma.

Custo: Gratuito.

Para contagens de visualizações/curtidas, data de publicação, descrição, duração, tags ou vídeos relacionados, use get_video_metadata em vez disso.

3. get_video_metadata

Metadados ricos de vídeo sem precisar de legendas: título, texto de contagem de visualizações/curtidas, data de publicação, descrição estruturada + links, resumo do canal de upload e miniaturas. Extras opcionais de include puxam dados mais pesados originados do player (duração, categoria, tags, inventário de faixas de legenda) e vídeos relacionados.

Custo: 1 crédito por solicitação bem-sucedida.

Exemplo de prompt:

Get the view count, publish date, and tags for https://youtu.be/UF8uR6Z6KLc.

4. search_youtube

Pesquise no YouTube por vídeos, canais, playlists ou filmes. Filtre por tipo, ordenação, data de upload ou duração, e pagine com um token de continuação, perfeito para descoberta, pesquisa e construção de pipelines de conteúdo.

Custo: 1 crédito por página (~20 resultados por página).

Exemplo de prompt:

Search YouTube for "transformer architecture explained" and pick the
top 3 results by relevance.

5. get_channel_info

O perfil de um canal: título, @handle, flag de verificado, texto de contagem de inscritos/vídeos, descrição, palavras-chave, tags, miniaturas, banners e as abas que ele expõe. Não é paginado.

Custo: 1 crédito por solicitação bem-sucedida.

Verifique as abas retornadas antes de chamar get_channel_sections ou list_channel_videos com um tab.

6. get_channel_latest_videos _{· GRATUITO}

Obtenha os ~15 uploads mais recentes de qualquer canal via RSS. Perfeito para monitoramento, resumos diários ou acionar pipelines downstream.

Custo: Gratuito.

Exemplo de prompt:

Every morning, list new uploads from @NASA and @natgeo.

7. search_channel_videos

Pesquise dentro de um canal específico por vídeos que correspondam a uma consulta. Ótimo para pesquisar o conteúdo de um criador ou encontrar tópicos de nicho em canais grandes.

Custo: 1 crédito por página (~30 resultados por página).

Exemplo de prompt:

On @NASA's channel, find every video about the Moon landing.

8. list_channel_videos

Liste o feed de um canal com paginação. Use tab para escolher o feed de uploads (padrão, ~100/página), Shorts ou transmissões ao vivo (~48/página), e o opcional sort para ordenar a aba Vídeos por mais recentes, populares ou mais antigos. Ideal para construir bancos de dados, extração em massa de transcrições ou auditar a biblioteca completa de conteúdo de um canal.

Ordenação. Adicione sort=latest, popular ou oldest a channel/videos para obter os vídeos de um canal na ordem desejada, por exemplo, os uploads mais populares primeiro. Uma página ordenada retorna cerca de 30 vídeos (uma página não ordenada retorna cerca de 100), e cada página custa o mesmo 1 crédito.

Resultados ordenados vêm da aba Vídeos do YouTube (somente formato longo); Shorts têm seu próprio feed tab=shorts.

Ao paginar, envie a mesma ordenação em cada solicitação.

Cada item carrega members_only: true somente quando o YouTube marca o vídeo como "Somente membros", e esses itens não têm viewCountText, porque o YouTube não publica contagens de visualizações para conteúdo de membros. É sempre false no feed de uploads, em tab: "shorts" e em playlists.

Itens de tab: "streams" carregam lengthText e publishedTimeText (por exemplo, Streamed 2 years ago, ou LIVE e uma contagem de espectadores enquanto a transmissão está ao vivo). tab: "shorts" retorna null para ambos, porque a grade de Shorts do YouTube não publica nem duração nem data de publicação. Nos feeds de aba do canal (tab: "videos" com sort, tab: "shorts", tab: "streams") channelId, channelTitle, channelHandle e index são null.

Custo: 1 crédito por página.

9. list_channel_playlists

Lista paginada das playlists de um canal (id, título, URL, texto de contagem de vídeos, miniaturas). Passe um id de playlist retornado para list_playlist_videos para obter seus vídeos.

Custo: 1 crédito por página.

10. list_channel_posts

Lista paginada do conteúdo da comunidade de um canal (aba Posts): texto, hora de publicação, texto de contagem de curtidas e anexos (imagem, múltiplas imagens, vídeo, playlist ou enquete). Canais sem aba de comunidade retornam uma lista de resultados vazia, não um erro.

Custo: 1 crédito por página.

11. get_channel_sections

As seções curadas e agrupadas de uma página de canal: prateleiras intituladas de vídeos, playlists, shorts ou canais em destaque, na ordem do próprio canal. Não é paginado.

Custo: 1 crédito por solicitação bem-sucedida.

podcasts e releases existem somente em canais que os possuem (resultados vazios caso contrário).

12. list_playlist_videos

Obtenha todos os vídeos em uma playlist do YouTube (IDs PL/UU/LL/FL/OL suportados). Processe cursos inteiros, séries de palestras ou coleções curadas em uma única chamada.

Custo: 1 crédito por página (~100 resultados por página).

💡 Casos de Uso & Prompts

💳 Preços e Limites de Taxa

• 1 Crédito = 1 solicitação bem-sucedida (HTTP 200)
• Solicitações com falha e limitadas por taxa não consomem créditos.
• get_channel_latest_videos é grátis (nenhum crédito é cobrado).
• Ver preços · Gerenciar créditos

🚨 Solução de Problemas

🔗 Também disponível como API REST

Construindo um aplicativo em vez de um agente? O mesmo backend é fornecido como uma API REST JSON.

URL base: https://transcriptapi.com/api/v2

🤝 Conecte-se

• 🌐 Site: transcriptapi.com
• 📚 Documentação: transcriptapi.com/docs
• 🔧 Referência da API: transcriptapi.com/docs/api
• 🤖 Guias de Configuração MCP: Claude · ChatGPT · OpenAI Agent Builder
• 💬 Contato: transcriptapi.com/contact
• 📂 Listado em: awesome-agent-plugins, nosso diretório de Plugins de Agente verificados no padrão aberto

📋 Registro MCP

Este servidor está publicado no Registro Oficial do Model Context Protocol sob o nome:

com.transcriptapi/youtube-transcript-and-youtube-search

_{© 2026 Zero Point Studio d.o.o. · Lançado sob a Licença MIT}