Which integrations are available for this server?

Integrates with Google's Gemini Vision API to perform visual analysis and content understanding of YouTube videos. Provides tools for extracting video metadata, automatic captions, and transcripts from YouTube videos, including support for shorts.

How do I use youtube-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@youtube-mcp summarize the transcript for https://www.youtube.com/watch?v=dQw4w9WgXcQ" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

youtube-mcp

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

Tools disponíveis

Tool	Método	Dependências
`youtube_transcript`	Legendas via yt-dlp (formato json3)	`python3 -m pip install yt-dlp`
`youtube_info`	Metadata via youtubei.js	Nenhuma extra
`youtube_vision`	Análise visual via Gemini 1.5 Pro	yt-dlp + GEMINI_API_KEY
`youtube_whisper`	Transcrição local via Whisper	yt-dlp + whisper (pip) + FFmpeg

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.