yt-dlp

yt-dlp-mcp

Una implementación de servidor MCP que se integra con yt-dlp, proporcionando capacidades de descarga de contenido de video y audio desde YouTube y otras plataformas para LLMs.

Características

• Descarga de video: Guarda videos en la carpeta especificada con control de calidad
• Descarga de audio: Extrae y guarda audio en varios formatos (mp3, m4a, ogg, opus)
• Información de video: Obtén metadatos sobre videos sin descargarlos
• Enfocado en privacidad: Descarga directa sin seguimiento
• Integración MCP: Funciona con Claude Desktop y otros LLMs compatibles con MCP
• Salida flexible: Rutas de salida y formatos de archivo personalizables

Instalación

Requisitos previos

Instala yt-dlp según tu sistema operativo:

# macOS
brew install yt-dlp

# Linux
pip install yt-dlp

Con Claude Desktop

1. Abre tu archivo de configuración de Claude Desktop:

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

2. Agrega la configuración del servidor MCP:

{
  "mcpServers": {
    "yt-dlp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gtvar/yt-dlp-mcp"
      ]
    }
  }
}

3. Guarda el archivo y reinicia Claude Desktop

Documentación de herramientas

• get_video_info

  • Obtén metadatos del video sin descargarlo (título, duración, subidor, formatos disponibles)
  • Entradas:
    • url (cadena, obligatorio): URL del video

• download_video

  • Descarga video o extrae audio a la ubicación especificada con control de calidad
  • Entradas:
    • url (cadena, obligatorio): URL del video
    • quality_preference (cadena, opcional): Preferencia de calidad de video
    • video_container_preference (cadena, opcional): Formato de video preferido
    • audio_container_preference (cadena, opcional): Formato de audio preferido (mp3, m4a, ogg, opus)
    • output_path (cadena, opcional): Ruta de salida personalizada con plantilla de nombre de archivo
    • extract_audio_only (booleano, opcional): Extraer solo audio. Por defecto es falso

Ejemplos de uso

Pídele a tu LLM que:

"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=..."

Inicio manual

Si es necesario, inicia el servidor manualmente:

npx @gtvar/yt-dlp-mcp

Variables de entorno

• YTDLP_PATH - Ruta al ejecutable de yt-dlp (predeterminado: 'yt-dlp')
• YTDL_OUTPUT_DIR - Directorio de salida predeterminado (predeterminado: '/tmp')
• FFMPEG_PATH - Ruta al ejecutable de ffmpeg (opcional)

Requisitos

• Node.js 20+
• yt-dlp en el PATH del sistema
• Servicio LLM compatible con MCP (Claude Desktop, etc.)
• Opcional: ffmpeg para soporte de formatos adicionales

Licencia

MIT

Autor

gtvar