CLI
Herramienta de línea de comandos para descargar videos de X (Twitter) y el flujo de autenticación que usa el servidor MCP.
Instalación
Requiere Node.js >= 24. No hace falta instalarla globalmente: ejecútala directamente con npx o instálala de forma global:
npm install -g @roudanio/x-downloader-cliyt-dlp en tu PATH para descargas directas, y también ffmpeg salvo que uses -f best. Ninguno de los dos es necesario solo para el servidor MCP o los comandos auth.
Inicio rápido
Las descargas directas usan tu yt-dlp local, sin necesidad de cuenta:
x-downloader https://x.com/user/status/123456789Opciones de descarga
| -o, --output <dir> | Directorio de salida (por defecto ~/Downloads) |
| -n, --filename <name> | Nombre de archivo de salida personalizado |
| -f, --format <format> | Selector de formato de yt-dlp (por defecto bestvideo*+bestaudio/best) |
| -F, --list-formats | Lista los formatos disponibles y sale |
| --cookies <file> | Archivo de cookies que se pasa a yt-dlp |
| --proxy <url> | URL de proxy que se pasa a yt-dlp |
| --dry-run | Muestra el comando yt-dlp resuelto en lugar de ejecutarlo |
Autenticación
auth login / auth logout / auth status gestionan un token de autorización de dispositivo que el servidor MCP (x-downloader-mcp) usa para llamar a la API del sitio. El comando de descarga directa de arriba nunca usa este token ni llama al sitio web.
Códigos de salida
| 0 | Éxito |
| 1 | Error genérico (argumentos no válidos, fallo de autenticación, yt-dlp terminó con error) |
| 2 | Dependencia ausente (no se encontró yt-dlp, o falta ffmpeg para el formato por defecto) |
| other | Se transmite tal cual desde el proceso yt-dlp subyacente |
Salida legible por máquinas
Aún no disponible para descargas directas: la salida es texto plano. Usa el servidor MCP o la API REST directamente si necesitas respuestas estructuradas.