ytdlp-mcp

Un servidor MCP que permite a los agentes de IA inspeccionar, descargar y convertir video y audio usando yt-dlp y FFmpeg mediante instrucciones en lenguaje natural.

Ejemplo

Envía un enlace, obtén el archivo. O escribe /ytdlp-mcp en OpenCode, Gemini CLI o Claude Code:

Instalación

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

Requiere yt-dlp, ffmpeg, Node 18. O copia PROMPT.md en cualquier agente de IA y deja que lo instale por ti.

Herramientas

Herramienta	Qué hace
probe	Lee título, duración, subidor, vistas, miniatura y descripción
formats	Lista formatos de medios disponibles, calidad y tamaños estimados
supported	Comprueba si una URL coincide con un extractor yt-dlp instalado localmente
inspect	Recomienda una acción de descarga, calidad y resoluciones disponibles
get_video	Descarga video, la salida predeterminada es MP4
get_audio	Extrae audio como Opus, MP3 o M4A
get_subtitles	Descarga subtítulos manuales o autogenerados como VTT
advise	Responde preguntas sobre configuración de yt-dlp
queue	Previsualiza un lote de URLs y planes de descarga por elemento
fetch_all	Descarga un lote de URLs con retrasos opcionales
watch	Lista entradas de una lista de reproducción o canal sin descargar
search	Busca en YouTube o SoundCloud y devuelve metadatos compactos
convert	Re-codifica un video local usando preajustes de FFmpeg

Proveedores de búsqueda

La herramienta search usa prefijos de extractor de búsqueda de yt-dlp. YouTube (ytsearch) y SoundCloud (scsearch) fueron verificados contra la compilación de yt-dlp instalada. Otros extractores instalados incluyen entradas relacionadas con búsqueda, pero no todos proporcionan un prefijo de búsqueda compatible, por lo que no se exponen como proveedores a menos que el prefijo funcione en una consulta real. Los resultados de búsqueda devuelven solo metadatos y están limitados a 1-50 elementos.

Proveedor	Prefijo yt-dlp
youtube	ytsearch
soundcloud	scsearch

Variables de entorno

Variable	Predeterminado
YTDLP_DOWNLOAD_DIR	~/Downloads/ytdlp-mcp
YTDLP_COOKIES_FILE	vacío
YTDLP_BIN / FFMPEG_BIN	yt-dlp / ffmpeg

Licencia

MIT: LICENSE