YouTube MCP

Conecte assistentes de IA ao YouTube — buscas, transcrições, metadados e muito mais.

GitHub

Experimente este MCPPatrocinado

Documentação

YouTube MCP

Conecte assistentes de IA ao YouTube: pesquisa, transcrições, metadados e muito mais.

Downloads

O que ele pode fazer?

Depois de conectado, sua IA pode:

Extrair transcrições limpas e palavra por palavra dos vídeos. Nenhuma credencial necessária.
Pesquisar no YouTube por palavra-chave, intervalo de datas, duração, qualidade e região.
Buscar vídeos em alta para qualquer país e categoria.
Recuperar estatísticas de vídeo, metadados, comentários, legendas e detalhes do canal.
Consultar canais por @handle (ex.: @MrBeast).
Acessar suas próprias inscrições, membros e níveis de assinatura via OAuth.

Começando

O servidor suporta três níveis de acesso. Escolha o que melhor se adequa ao seu caso de uso.

Modo Convidado (Sem Configuração)

Funciona imediatamente. A ferramenta get_video_transcript usa yt-dlp para extrair transcrições sem nenhuma credencial de API.

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": ["-y", "@mrsknetwork/ytmcp@latest"]
    }
  }
}

Chave de API (Recomendado)

Desbloqueia todas as ferramentas de dados públicos. Melhor para pesquisa, metadados, comentários, vídeos em alta e transcrições.

1. Obtenha uma Chave de API do Google

Abra o Google Cloud Console.
Ative a YouTube Data API v3 para o seu projeto.
Vá para Credenciais e crie uma Chave de API.

2. Adicione à configuração do seu cliente MCP ou ao arquivo .env

Passe GOOGLE_API_KEY via env na configuração do seu cliente MCP, ou coloque GOOGLE_API_KEY=YOUR_KEY dentro de um arquivo .env no diretório do projeto.

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": ["-y", "@mrsknetwork/ytmcp@latest"],
      "env": {
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY"
      }
    }
  }
}

OAuth 2.0

Necessário para inscrições privadas, assinaturas e atividade da conta.

1. Crie um Cliente OAuth 2.0

Abra o Google Cloud Console.
Ative a YouTube Data API v3 para o seu projeto.
Vá para Credenciais > Criar Credenciais > ID do Cliente OAuth 2.0.
Defina o tipo de aplicativo como Aplicativo Web.
Adicione esta URI de redirecionamento exata: http://localhost:31415/oauth2callback.
Vá para Tela de Consentimento OAuth > Usuários de Teste e adicione seu endereço do Gmail.

2. Adicione à configuração do seu cliente MCP

As credenciais são passadas com segurança por meio de variáveis de ambiente na configuração do MCP. Elas nunca são armazenadas em arquivos.

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": ["-y", "@mrsknetwork/ytmcp@latest"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

3. Login na primeira vez

Na sua primeira chamada de ferramenta, a IA compartilhará um link de login. Clique nele, autorize o aplicativo no seu navegador e depois avise a IA que você concluiu. Sua sessão é salva. Você não precisará fazer login novamente, a menos que revogue o acesso.

4. Sair

Peça à sua IA para chamar revoke_oauth_token para sair e excluir suas credenciais armazenadas a qualquer momento.

Ferramentas Disponíveis

Ferramenta	Autenticação	Descrição
`get_video_transcript`	Nenhuma	Baixa uma transcrição completa da fala usando yt-dlp. Especifique `language_code` (ex.: `en`, `es`) e se prefere legendas manuais ou geradas automaticamente. Retorna metadados da fonte com o texto.
`search_content`	Chave de API	Pesquisa no YouTube por vídeos, canais ou playlists. Filtre por `order`, `published_after`, `published_before`, `video_duration`, `video_definition` e `region_code`. Suporta paginação.
`get_video_metadata`	Chave de API	Busca título, descrição, tags, duração e estatísticas (visualizações, curtidas, comentários) de um ou mais vídeos por ID.
`get_channel_metadata`	Chave de API	Busca o perfil do canal, contagem de inscritos, contagem de vídeos e ID da playlist de uploads. Aceita um ID de canal ou `@handle`.
`list_trending_videos`	Chave de API	Busca os vídeos mais populares no YouTube para um determinado `region_code` e `category_id` opcional. Suporta paginação.
`list_playlists`	Chave de API	Lista playlists de um canal ou busca playlists específicas por ID. Retorna título, descrição e contagem de itens.
`list_playlist_items`	Chave de API	Lista todos os vídeos dentro de uma playlist em ordem. Retorna título, posição e ID do vídeo para cada entrada.
`list_video_comments`	Chave de API	Busca os principais tópicos de comentários de um vídeo ou canal. Filtre por palavra-chave com `search_terms`. Suporta paginação.
`list_comment_replies`	Chave de API	Busca respostas a um tópico de comentário específico por `parent_comment_id`. Suporta paginação.
`list_video_captions`	Chave de API	Lista as faixas de legenda disponíveis para um vídeo, incluindo código do idioma e tipo (manual ou gerado automaticamente).
`list_video_categories`	Chave de API	Lista os nomes e IDs das categorias de vídeo do YouTube para uma determinada região. Use os IDs com `search_content` ou `list_trending_videos`.
`list_channel_activities`	Chave de API	Busca o feed de atividades recentes de um canal, incluindo uploads e adições de playlists.
`list_channel_sections`	Chave de API	Lista as seções de prateleira exibidas na página de um canal, em ordem.
`list_supported_languages`	Chave de API	Lista todos os idiomas suportados pelo YouTube, com códigos de idioma e nomes localizados.
`list_supported_regions`	Chave de API	Lista todas as regiões suportadas pelo YouTube, com códigos e nomes de região.
`list_subscriptions`	Chave de API / OAuth	Lista inscrições públicas de um canal por `channel_id` (Chave de API) ou suas próprias inscrições com `mine=true` (OAuth).
`list_channel_members`	OAuth	Lista os membros pagantes atuais do seu canal. Requer um programa de assinaturas ativo.
`list_membership_levels`	OAuth	Lista os nomes e níveis dos planos de assinatura configurados para o seu canal.
`revoke_oauth_token`	OAuth	Sai e exclui permanentemente suas credenciais do Google armazenadas no servidor.

Compilando a partir do Código-Fonte

Instruções para executar o servidor localmente.

git clone https://github.com/mrsknetwork/ytmcp.git
cd ytmcp
npm install
npm run build
cp .env.example .env # Set GOOGLE_API_KEY inside .env
node build/server/index.js

Licença

Licenciado sob a Licença MIT.