CLI
用于下载 X（Twitter）视频的命令行工具，以及 MCP 服务器所用的认证流程。
安装
需要 Node.js >= 24。无需全局安装——可直接用 npx 运行，或全局安装：
npm install -g @roudanio/x-downloader-cli直接下载需要 PATH 中有 yt-dlp；除非传入 -f best，还需要 ffmpeg。仅使用 MCP 服务器或 auth 命令时两者都不需要。
快速开始
直接下载使用你本地的 yt-dlp——无需账号：
x-downloader https://x.com/user/status/123456789下载参数
| -o, --output <dir> | 输出目录（默认 ~/Downloads） |
| -n, --filename <name> | 自定义输出文件名 |
| -f, --format <format> | yt-dlp 格式选择器（默认 bestvideo*+bestaudio/best） |
| -F, --list-formats | 列出可用格式后退出 |
| --cookies <file> | 传给 yt-dlp 的 cookies 文件 |
| --proxy <url> | 传给 yt-dlp 的代理 URL |
| --dry-run | 只打印解析后的 yt-dlp 命令，不实际执行 |
认证
auth login / auth logout / auth status 用于管理设备授权 token，MCP 服务器（x-downloader-mcp）用它调用网站 API。上面的直接下载命令从不使用该 token，也从不访问网站。
退出码
| 0 | 成功 |
| 1 | 一般错误（参数错误、认证失败、yt-dlp 报错退出） |
| 2 | 缺少依赖（找不到 yt-dlp，或默认格式所需的 ffmpeg 缺失） |
| other | 原样透传底层 yt-dlp 进程的退出码 |
机器可读输出
直接下载暂不支持——输出为纯文本。如需结构化响应，请直接使用 MCP 服务器或 REST API。