X Likes Downloader (Rust版本)
一个用 Rust 编写的 X（Twitter）点赞推文媒体下载器：既是面向人类用户的 CLI，也是可被多 host AI Agent（Claude Code / Codex CLI / OpenClaw / 未来 Hermes、Cursor）驱动的自动化工具。所有凭据本地化保存，不依赖第三方 API key 或外部抓取服务。
v2.0 → v2.1 迁移指引（packaging breaking）
v2.1 把 host adapter 从单 skill/ 目录拆分为 packaging/ 多 host 容器：
| 影响对象 | 变化 |
|---|
| v2.0 OpenClaw 用户 | ClawHub 注册的 URL 必须从 <repo>/skill 改为 <repo>/packaging/openclaw/x_likes。binary 行为不变 |
| 新 Claude Code 用户 | 走自建 marketplace：claude plugin marketplace add https://github.com/HerbertGao/x_likes_downloader && claude plugin install x_likes@x_likes_downloader |
| 新 Codex CLI 用户 | codex plugin marketplace add https://github.com/HerbertGao/x_likes_downloader；codex 0.128 无独立 plugin install，需手动在 ~/.codex/config.toml 加 [plugins."x_likes@x_likes_downloader"] enabled = true 启用 |
cargo install / GHA release | 不变 |
详见 packaging/README.md 与各 host adapter README。
功能特性
- 🔐 支持 X 内部 API，无需第三方服务
- 📥 自动下载点赞推文中的图片和视频
- 🔄 支持断点续传，避免重复下载
- 📁 自动文件整理和分类
- 🚀 异步下载，支持进度显示
- 🌐 支持 HTTP 代理
- 📊 详细的下载统计信息
- 🤖 Agent MCP server 模式（v2）：暴露
list_likes / download_media / auth_status / setup_from_curl 四个 MCP 工具，原生支持 progress notification
安装
前置要求
- Rust 1.85+（v2.0 起，rmcp 1.x 是 edition 2024 crate；schemars 1.2.x 声明 rust-version 1.74，整体取最高）
- 有效的X账号和登录状态
方法一：下载预编译版本（推荐）
从 GitHub Releases 下载对应平台的预编译版本：
- macOS ARM64 (Apple Silicon):
x_likes_downloader_macos_arm64
- macOS x86_64 (Intel):
x_likes_downloader_macos_x86_64
- Linux x86_64:
x_likes_downloader_linux_x86_64
- Linux ARM64:
x_likes_downloader_linux_arm64
- Windows x86_64:
x_likes_downloader_windows_x86_64.exe
- Windows ARM64:
x_likes_downloader_windows_arm64.exe
下载后解压并运行：
# macOS/Linux
chmod +x x_likes_downloader
./x_likes_downloader --help
# Windows
x_likes_downloader.exe --help
方法二：从源码编译
# 克隆项目
git clone <repository-url>
cd x_likes_downloader
# 编译当前平台版本
cargo build --release
# 安装到系统
cargo install --path .
使用方法
1. 初始化配置
首先需要从浏览器中获取X的API请求信息：
- 打开X网站并登录
- 打开开发者工具（F12）
- 进入Network标签页
- 刷新页面，找到任意一个API请求
- 右键点击请求 -> Copy -> Copy as cURL
- 将cURL命令保存到
curl_command.txt 文件中
然后运行初始化命令：
# 使用默认的curl_command.txt文件
x_likes_downloader setup
# 或指定自定义文件
x_likes_downloader setup --curl-file my_curl.txt
2. 下载媒体文件
# 开始下载
x_likes_downloader download
3. 整理文件（可选）
# 使用默认目录
x_likes_downloader organize
# 或指定自定义目录
x_likes_downloader organize --source-dir downloads --target-dir organized
作为 Agent MCP server 使用（v2.1+）
本项目内置 MCP server（Model Context Protocol），让 AI Agent 通过自然语言操作你自己的 X 点赞列表：
Host 适配状态
通过自建 marketplace 安装
仓库根 .claude-plugin/marketplace.json 与 .agents/plugins/marketplace.json 是自托管 marketplace，无需上架第三方。
# Claude Code
claude plugin marketplace add https://github.com/HerbertGao/x_likes_downloader
claude plugin install x_likes@x_likes_downloader # 注意 @<marketplace> 限定
# Codex CLI（需 codex CLI ≥ 0.128）
codex plugin marketplace add https://github.com/HerbertGao/x_likes_downloader
# codex 0.128 无独立 plugin install；编辑 ~/.codex/config.toml 加：
# [plugins."x_likes@x_likes_downloader"]
# enabled = true
Plugin 不打包 binary——先确保 x_likes_downloader 在 PATH 中（cargo install / brew tap / GHA release binary 任选）。详细见 packaging/skill/x_likes/README.md。
三类用户路径
