zzh-editor/Media-downloader

¿Qué hace Media-downloader?

Skill de agente para descarga de materiales multiplataforma — basado en yt-dlp + gallery-dl, compatible con cientos de sitios como YouTube, Bilibili, Vimeo, ArtStation y más.

Descripción

Este skill permite a un agente de IA descargar contenido multimedia (videos, imágenes, audios) desde una amplia variedad de plataformas web usando herramientas CLI robustas. Soporta descargas individuales, listas de reproducción, extracción de metadatos y conversión de formatos.

Plataformas compatibles

• Video: YouTube, Vimeo, Bilibili, Twitch, Dailymotion, TikTok, Twitter/X, Instagram, Reddit, Facebook, etc.
• Imágenes/Galerías: ArtStation, DeviantArt, Flickr, Imgur, Pixiv, Instagram, Twitter/X, etc.
• Audio: Bandcamp, SoundCloud, Mixcloud, etc.
• Más: Cientos de sitios adicionales soportados por yt-dlp y gallery-dl.

Requisitos

• Python 3.8 o superior.
• yt-dlp y gallery-dl instalados globalmente o en un entorno virtual.
• Conexión a internet.
• (Opcional) ffmpeg para procesamiento y conversión de formatos.

Instalación

# Instalar dependencias
pip install yt-dlp gallery-dl

# Verificar instalación
yt-dlp --version
gallery-dl --version

Uso básico

Descargar un video

yt-dlp "https://www.youtube.com/watch?v=ejemplo"

Descargar imágenes de una galería

gallery-dl "https://www.artstation.com/artwork/ejemplo"

Descargar con opciones avanzadas (por ejemplo, solo audio)

yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=ejemplo"

Especificar directorio de salida

yt-dlp -o "~/Descargas/%(title)s.%(ext)s" "https://www.youtube.com/watch?v=ejemplo"

Integración con agentes

Este skill está diseñado para ser usado por agentes como Claude Code, Cursor, Codex, etc. El agente puede:

• Recibir una URL y un tipo de contenido (video, imagen, audio, galería).
• Elegir automáticamente la herramienta adecuada (yt-dlp o gallery-dl).
• Ejecutar la descarga con parámetros óptimos.
• Devolver la ruta del archivo descargado o un resumen del resultado.

Ejemplo de interacción con el agente

Usuario: Descarga el video de YouTube en https://www.youtube.com/watch?v=dQw4w9WgXcQ y conviértelo a MP3. Agente: Ejecutando yt-dlp -x --audio-format mp3 -o "~/Descargas/%(title)s.%(ext)s" "https://www.youtube.com/watch?v=dQw4w9WgXcQ". Hecho. El archivo se ha descargado como ~/Descargas/Rick Astley - Never Gonna Give You Up (Official Music Video).mp3.

Variables de entorno

Variable	Descripción
MEDIA_DOWNLOAD_DIR	Directorio de descarga personalizado (por defecto: ./downloads)
YT_DLP_EXTRA_ARGS	Argumentos adicionales para yt-dlp
GALLERY_DL_EXTRA_ARGS	Argumentos adicionales para gallery-dl

Notas

• Respeta los términos de servicio y derechos de autor de cada plataforma.
• Algunos sitios pueden requerir cookies o autenticación (por ejemplo, sitios con inicio de sesión).
• Para descargas masivas, considera usar listas de reproducción o archivos de texto con URLs.

Solución de problemas

1. Error de dependencia faltante: Asegúrate de que ffmpeg esté instalado si usas conversión de formatos.
2. Descarga bloqueada: Algunos sitios pueden tener restricciones regionales o de contenido. Usa proxies o VPN si es necesario.
3. Actualización de herramientas: Ejecuta pip install --upgrade yt-dlp gallery-dl para obtener las últimas versiones.

Licencia

Este skill se distribuye bajo la misma licencia que yt-dlp y gallery-dl.