YouTube

Servidor MCP do YouTube

Um servidor Model Context Protocol (MCP) que permite que o Claude Desktop (e outros aplicativos) interaja com o YouTube, fornecendo funcionalidades de busca e transcrição.

Recursos

• Buscar vídeos no YouTube: Busque vídeos com contagens de resultados personalizáveis
• Obter transcrições de vídeos: Extraia transcrições de vídeos do YouTube usando URLs ou IDs de vídeo
• Integração pronta para IA: Integra-se perfeitamente ao Claude Desktop para análise de conteúdo do YouTube

Ferramentas Disponíveis

1. search_youtube_videos

• Objetivo: Buscar vídeos no YouTube com base em uma consulta
• Parâmetros:
  • search_term (string): A consulta de busca
  • num_videos (int): Número de vídeos a retornar (padrão: 5, máximo: 50)
• Retorna: Lista de informações de vídeo, incluindo títulos, canais, descrições, URLs e metadados

2. get_youtube_transcript

• Objetivo: Extrair transcrição de um vídeo do YouTube
• Parâmetros:
  • video_url_or_title (string): URL do vídeo do YouTube ou ID do vídeo
• Retorna: Transcrição completa com carimbos de data/hora e metadados

3. analyze_youtube_content_prompt

• Objetivo: Modelo de prompt de IA para análise abrangente de conteúdo do YouTube
• Parâmetros:
  • search_term (string): Tópico a analisar
  • num_videos (int): Número de vídeos a analisar

Configuração

1. Instalar Dependências

# Create virtual environment
python3 -m venv .venv

# Activate virtual environment
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

2. Obter Chave da API do YouTube

1. Vá para Google Cloud Console
2. Crie um novo projeto ou selecione um existente
3. Ative a YouTube Data API v3
4. Crie credenciais (Chave de API)
5. Copie a chave da API

3. Configurar Ambiente

# Copy example environment file
cp .env.example .env

# Edit .env and add your YouTube API key
YOUTUBE_API_KEY=your_actual_api_key_here

4. Testar o Servidor

# Activate virtual environment
source .venv/bin/activate

# Run the server
python youtube_server.py

Integração com o Claude Desktop

Adicione esta configuração às configurações MCP do seu Claude Desktop:

{
  "mcpServers": {
        "youtube": {
            "command": "local/path/to/uv",
            "args": [
                "run",
                "--directory",
                "/Path/to/your/project",
                "youtube_server.py"
            ],
            "env": {
                "YOUTUBE_API_KEY": "your_key_here"
            }
  }
}

Exemplos de Uso

Depois de integrado ao Claude Desktop, você pode:

• "Buscar vídeos sobre aprendizado de máquina e obter transcrições"
• "Encontrar os vídeos mais recentes sobre mudanças climáticas e analisar seu conteúdo"
• "Obter a transcrição deste vídeo do YouTube: https://www.youtube.com/watch?v=..."
• "Comparar diferentes perspectivas sobre ética em IA a partir de vídeos do YouTube"

Tratamento de Erros

• Chave de API ausente: O servidor emitirá um aviso e a funcionalidade de busca será limitada
• IDs de vídeo inválidos: Mensagens de erro claras para solicitações de transcrição
• Limites da API: Respeita as cotas e limites de taxa da API do YouTube
• Transcrições ausentes: Lida com vídeos sem legendas disponíveis

Dependências

• fastmcp: Estrutura do servidor MCP
• google-api-python-client: Acesso à API de dados do YouTube
• youtube-transcript-api: Extração de transcrições

Licença

Este projeto é de código aberto e está disponível sob termos de licenciamento padrão.