YouTube Data

YouTube MCP Server

Uma implementação de servidor Model Context Protocol (MCP) que utiliza a YouTube Data API. Ela permite que modelos de linguagem de IA interajam com conteúdo do YouTube por meio de uma interface padronizada.

Principais Recursos

Informações de Vídeo

• Recupere informações detalhadas do vídeo (título, descrição, duração, estatísticas)
• Pesquise vídeos por palavras-chave
• Obtenha vídeos relacionados com base em um vídeo específico
• Calcule e analise taxas de engajamento de vídeos

Gerenciamento de Transcrições/Legendas

• Recupere legendas de vídeo com suporte a vários idiomas
• Especifique preferências de idioma para transcrições
• Acesse legendas com carimbo de tempo para referência precisa de conteúdo

Análise de Canais

• Visualize estatísticas detalhadas do canal (inscritos, visualizações, número de vídeos)
• Obtenha os vídeos de melhor desempenho de um canal
• Analise métricas de crescimento e engajamento do canal

Análise de Tendências

• Visualize vídeos em alta por região e categoria
• Compare métricas de desempenho entre vários vídeos
• Descubra conteúdo popular em categorias específicas

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas MCP:

Nome da Ferramenta	Descrição	Parâmetros Obrigatórios
getVideoDetails	Obtenha informações detalhadas sobre vários vídeos do YouTube, incluindo metadados, estatísticas e detalhes de conteúdo	videoIds (array)
searchVideos	Pesquise vídeos com base em uma string de consulta	query, maxResults (opcional)
getTranscripts	Recupere transcrições de vários vídeos	videoIds (array), lang (opcional)
getRelatedVideos	Obtenha vídeos relacionados a um vídeo específico com base no algoritmo de recomendação do YouTube	videoId, maxResults (opcional)
getChannelStatistics	Recupere métricas detalhadas de vários canais, incluindo número de inscritos, visualizações e número de vídeos	channelIds (array)
getChannelTopVideos	Obtenha os vídeos mais assistidos de um canal específico	channelId, maxResults (opcional)
getVideoEngagementRatio	Calcule métricas de engajamento para vários vídeos (visualizações, curtidas, comentários e taxa de engajamento)	videoIds (array)
getTrendingVideos	Obtenha vídeos populares atuais por região e categoria	regionCode (opcional), categoryId (opcional), maxResults (opcional)
compareVideos	Compare estatísticas entre vários vídeos	videoIds (array)

Instalação

Instalação Automática via Smithery

Instale automaticamente o YouTube MCP Server para Claude Desktop via Smithery:

npx -y @smithery/cli install @icraft2170/youtube-data-mcp-server --client claude

Instalação Manual

# Install from npm
npm install youtube-data-mcp-server

# Or clone repository
git clone https://github.com/icraft2170/youtube-data-mcp-server.git
cd youtube-data-mcp-server
npm install

Configuração de Ambiente

Defina as seguintes variáveis de ambiente:

• YOUTUBE_API_KEY: chave da YouTube Data API (obrigatória)
• YOUTUBE_TRANSCRIPT_LANG: idioma padrão de legendas (opcional, padrão: 'ko')

Configuração do Cliente MCP

Adicione o seguinte ao seu arquivo de configuração do Claude Desktop:

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "youtube-data-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "YOUR_API_KEY_HERE",
        "YOUTUBE_TRANSCRIPT_LANG": "ko"
      }
    }
  }
}

Configuração da API do YouTube

1. Acesse o Google Cloud Console
2. Crie um novo projeto ou selecione um existente
3. Ative a YouTube Data API v3
4. Crie credenciais de API (chave de API)
5. Use a chave de API gerada na sua configuração de ambiente

Desenvolvimento

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

Configuração de Rede

O servidor expõe as seguintes portas para comunicação:

• HTTP: 3000
• gRPC: 3001

Requisitos do Sistema

• Node.js 18.0.0 ou superior

Considerações de Segurança

• Mantenha sempre sua chave de API segura e nunca a envie para sistemas de controle de versão
• Gerencie sua chave de API por meio de variáveis de ambiente ou arquivos de configuração
• Defina limites de uso para sua chave de API para evitar uso não autorizado

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.