CLI
Ferramenta de linha de comando para baixar vídeos do X (Twitter) e o fluxo de autenticação usado pelo servidor MCP.
Instalação
Requer Node.js >= 24. Não precisa de instalação global — execute direto com npx ou instale globalmente:
npm install -g @roudanio/x-downloader-cliyt-dlp no seu PATH para downloads diretos e também ffmpeg, a menos que você use -f best. Nenhum dos dois é necessário só para o servidor MCP ou os comandos auth.
Início rápido
Downloads diretos usam o seu yt-dlp local — sem necessidade de conta:
x-downloader https://x.com/user/status/123456789Opções de download
| -o, --output <dir> | Diretório de saída (padrão ~/Downloads) |
| -n, --filename <name> | Nome de arquivo de saída personalizado |
| -f, --format <format> | Seletor de formato do yt-dlp (padrão bestvideo*+bestaudio/best) |
| -F, --list-formats | Lista os formatos disponíveis e sai |
| --cookies <file> | Arquivo de cookies a repassar ao yt-dlp |
| --proxy <url> | URL de proxy a repassar ao yt-dlp |
| --dry-run | Exibe o comando yt-dlp resolvido em vez de executá-lo |
Autenticação
auth login / auth logout / auth status gerenciam um token de autorização de dispositivo que o servidor MCP (x-downloader-mcp) usa para chamar a API do site. O comando de download direto acima nunca usa esse token nem chama o site.
Códigos de saída
| 0 | Sucesso |
| 1 | Erro genérico (argumentos inválidos, falha de autenticação, yt-dlp terminou com erro) |
| 2 | Dependência ausente (yt-dlp não encontrado ou ffmpeg ausente para o formato padrão) |
| other | Repassado diretamente do processo yt-dlp subjacente |
Saída legível por máquina
Ainda não disponível para downloads diretos — a saída é texto simples. Use o servidor MCP ou a API REST diretamente se precisar de respostas estruturadas.