yt-dlp

Baixe vídeo e áudio do YouTube e de outras plataformas usando a ferramenta yt-dlp.

GitHub
1
Experimente este MCPPatrocinado

Documentação

yt-dlp-mcp

Uma implementação de servidor MCP que se integra ao yt-dlp, fornecendo capacidades de download de conteúdo de vídeo e áudio do YouTube e outras plataformas para LLMs.

Recursos

  • Download de Vídeo: Salve vídeos na pasta especificada com controle de qualidade
  • Download de Áudio: Extraia e salve áudio em vários formatos (mp3, m4a, ogg, opus)
  • Informações do Vídeo: Obtenha metadados sobre vídeos sem baixar
  • Foco em Privacidade: Download direto sem rastreamento
  • Integração MCP: Funciona com Claude Desktop e outros LLMs compatíveis com MCP
  • Saída Flexível: Caminhos de saída e formatos de arquivo personalizáveis

Instalação

Pré-requisitos

Instale o yt-dlp com base no seu sistema operacional:


# macOS
brew install yt-dlp

# Linux
pip install yt-dlp

Com Claude Desktop

  1. Abra o arquivo de configuração do Claude Desktop:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  2. Adicione a configuração do servidor MCP:

{
  "mcpServers": {
    "yt-dlp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gtvar/yt-dlp-mcp"
      ]
    }
  }
}
  1. Salve o arquivo e reinicie o Claude Desktop

Documentação das Ferramentas

  • get_video_info

    • Obtenha metadados do vídeo sem baixar (título, duração, uploader, formatos disponíveis)
    • Entradas:
      • url (string, obrigatório): URL do vídeo

  • download_video

    • Baixe vídeo ou extraia áudio para o local especificado com controle de qualidade
    • Entradas:
      • url (string, obrigatório): URL do vídeo
      • quality_preference (string, opcional): Preferência de qualidade do vídeo
      • video_container_preference (string, opcional): Formato de vídeo preferido
      • audio_container_preference (string, opcional): Formato de áudio preferido (mp3, m4a, ogg, opus)
      • output_path (string, opcional): Caminho de saída personalizado com modelo de nome de arquivo
      • extract_audio_only (boolean, opcional): Extrair apenas áudio. Padrão é falso

Exemplos de Uso

Peça ao seu LLM para:

"Get information about this video: https://youtube.com/watch?v=..."
"Download this YouTube video: https://youtube.com/watch?v=..."
"Extract audio from this video in mp3 format: https://youtube.com/watch?v=..."
"Download video with custom quality settings: https://youtube.com/watch?v=..."
"Save this video to a specific folder: https://youtube.com/watch?v=..."

Início Manual

Se necessário, inicie o servidor manualmente:

npx @gtvar/yt-dlp-mcp

Variáveis de Ambiente

  • YTDLP_PATH - Caminho para o executável yt-dlp (padrão: 'yt-dlp')
  • YTDL_OUTPUT_DIR - Diretório de saída padrão (padrão: '/tmp')
  • FFMPEG_PATH - Caminho para o executável ffmpeg (opcional)

Requisitos

  • Node.js 20+
  • yt-dlp no PATH do sistema
  • Serviço LLM compatível com MCP (Claude Desktop, etc.)
  • Opcional: ffmpeg para suporte adicional de formatos

Licença

MIT

Autor

gtvar