youtube-mcp

MCP local para extrair transcrições e análise de vídeos do YouTube.

Tools disponíveis

Instalação

cd "MCPs e Skills/youtube-mcp"
npm install

# Instalar yt-dlp (obrigatório para youtube_transcript, youtube_vision, youtube_whisper)
python3 -m pip install yt-dlp

# Instalar Whisper (apenas para youtube_whisper)
python3 -m pip install openai-whisper

# FFmpeg (necessário para Whisper)
winget install ffmpeg

Configuração no Claude Desktop

Adicione em claude_desktop_config.json:

"youtube-mcp": {
  "command": "node",
  "args": ["C:\\Users\\Eric Luciano\\OneDrive\\Documentos\\GitHub\\MCPs e Skills\\youtube-mcp\\index.js"],
  "env": {
    "GEMINI_API_KEY": "sua-chave-aqui"
  }
}

Obtenha sua GEMINI_API_KEY em: https://aistudio.google.com/apikey

Formatos de URL suportados

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://www.youtube.com/shorts/VIDEO_ID
• ID direto: VIDEO_ID (11 caracteres)

Notas técnicas

• youtube_transcript: usa yt-dlp --sub-format json3 que produz legendas limpas sem duplicatas. Fallback automático para inglês se o idioma solicitado não estiver disponível.
• youtube_info: usa youtubei.js para obter metadata (título, canal, duração, legendas disponíveis) sem autenticação.
• youtube_vision: baixa o vídeo em baixa qualidade, envia para a Google File API e analisa com Gemini 1.5 Pro.
• youtube_whisper: baixa apenas o áudio e transcreve localmente com OpenAI Whisper.