ytdlp-mcp

Um servidor MCP que permite que agentes de IA inspecionem, baixem e convertam vídeo e áudio usando yt-dlp e FFmpeg por meio de instruções em linguagem natural.

Exemplo

Envie um link, receba o arquivo. Ou digite /ytdlp-mcp no OpenCode, Gemini CLI ou Claude Code:

Instalação

git clone https://github.com/fanyzp/ytdlp-mcp.git && cd ytdlp-mcp && npm run setup

Requer yt-dlp, ffmpeg, Node 18. Ou copie PROMPT.md para qualquer agente de IA e deixe que ele instale para você.

Ferramentas

Ferramenta	O que faz
probe	Lê título, duração, uploader, visualizações, miniatura e descrição
formats	Lista formatos de mídia disponíveis, qualidade e tamanhos estimados
supported	Verifica se uma URL corresponde a um extrator yt-dlp instalado localmente
inspect	Recomenda uma ação de download, qualidade e resoluções disponíveis
get_video	Baixa vídeo, a saída padrão é MP4
get_audio	Extrai áudio como Opus, MP3 ou M4A
get_subtitles	Baixa legendas manuais ou geradas automaticamente como VTT
advise	Responde perguntas sobre configuração do yt-dlp
queue	Pré-visualiza um lote de URLs e planos de download por item
fetch_all	Baixa um lote de URLs com atrasos opcionais
watch	Lista entradas de uma playlist ou canal sem baixar
search	Pesquisa no YouTube ou SoundCloud e retorna metadados compactos
convert	Re-codifica um vídeo local usando predefinições do FFmpeg

Provedores de pesquisa

A ferramenta search usa prefixos de extrator de pesquisa do yt-dlp. YouTube (ytsearch) e SoundCloud (scsearch) foram verificados contra a versão instalada do yt-dlp. Outros extratores instalados incluem entradas relacionadas a pesquisa, mas nem todos fornecem um prefixo de pesquisa suportado, então não são expostos como provedores, a menos que o prefixo funcione em uma consulta real. Os resultados de pesquisa retornam apenas metadados e são limitados a 1-50 itens.

Provedor	Prefixo yt-dlp
youtube	ytsearch
soundcloud	scsearch

Variáveis de ambiente

Variável	Padrão
YTDLP_DOWNLOAD_DIR	~/Downloads/ytdlp-mcp
YTDLP_COOKIES_FILE	vazio
YTDLP_BIN / FFMPEG_BIN	yt-dlp / ffmpeg

Licença

MIT: LICENSE