10 KiB
Jackwener 系列 CLI 工具深度剖析
jackwener 开发的系列 CLI 工具(小红书、Discord、Twitter/X、Telegram、B站)遵循统一设计理念,为主流社交/内容平台提供终端级操作能力,无需依赖官方API或图形界面,兼顾实用性与扩展性。以下是各工具的详细分析:
一、通用特性与核心设计
1. 统一意义
-
打破平台壁垒:将分散在不同App/网页的社交/内容操作集中到终端,支持批量处理、自动化脚本集成,提升效率。
-
AI Agent 友好:通过标准化输出(YAML/JSON)和 SKILL.md 配置,无缝对接AI工具,实现智能检索、自动互动等高级场景。
-
隐私与控制:本地缓存数据(部分工具)、无第三方数据中转,避免隐私泄露;支持代理和反检测机制,降低账号风险。
-
轻量化替代:无需安装臃肿App,适合服务器、远程终端等无GUI环境,或追求高效操作的技术用户。
2. 通用原理
-
认证机制:优先提取浏览器Cookie(支持Chrome、Firefox等主流浏览器),辅以二维码登录或环境变量配置,模拟真实用户登录状态。
-
API 逆向:解析目标平台Web/APP的API接口,还原请求签名(如小红书的x-s签名、Twitter的TLS指纹伪装)和数据格式,实现无官方SDK的操作。
-
反检测策略:通过高斯抖动延迟、固定浏览器指纹、会话级身份持久化等技术,模拟人类操作行为,规避平台风控。
-
结构化输出:统一采用
ok/schema_version/data/error信封格式,非交互模式默认输出YAML(更省Token),支持JSON格式适配脚本。
二、各工具具体分析
1. xiaohongshu-cli(小红书)
核心意义
填补小红书无官方CLI工具的空白,支持从内容消费(搜索、阅读)到创作(发笔记、互动)的全流程终端操作,适合内容创作者批量管理账号或研究者采集数据。
核心原理
-
基于逆向工程还原小红书API,支持笔记、用户、话题等核心资源的CRUD操作。
-
反风控机制:模拟macOS Chrome浏览器指纹、请求签名动态生成、验证码自动冷却,降低IP封禁风险。
-
短索引缓存:将搜索/热门列表结果缓存至本地,支持通过序号快速操作(如
xhs read 1读取第一条结果)。
核心作用
-
内容消费:关键词/用户/话题搜索、分类热门浏览、评论/子评论查看。
-
账号互动:点赞、收藏、评论、关注/取关,支持批量操作(通过短索引)。
-
创作管理:发布图文笔记、查看/删除自有笔记、监控通知(点赞/关注/@)。
-
数据导出:结构化输出笔记/评论数据,支持JSON/YAML格式用于分析。
基础用法
# 安装(推荐uv工具)
uv tool install xiaohongshu-cli
# 登录(自动提取浏览器Cookie)
xhs login
# 或二维码登录:xhs login --qrcode
# 搜索与阅读
xhs search "美食" --sort popular # 搜索热门美食笔记
xhs read 1 # 阅读第一条搜索结果
xhs comments 1 --all --json # 导出所有评论(JSON格式)
# 互动操作
xhs like 1 # 给第一条结果点赞
xhs comment 1 -c "好赞!" # 发表评论
# 创作者操作
xhs post --title "旅行攻略" --body "正文" --images img1.jpg # 发布图文笔记
2. discord-cli(Discord)
核心意义
专为Discord设计的本地优先工具,解决官方客户端检索不便、数据导出困难的问题,适合社区管理员批量管理消息或用户备份聊天记录。
核心原理
-
基于Discord HTTP API,通过本地用户Token认证,将聊天记录同步至SQLite数据库。
-
本地优先设计:查询操作优先读取本地缓存,支持增量同步和近实时监听(
tg listen --persist),减少网络请求。
核心作用
-
数据同步:批量同步指定频道/服务器的聊天记录,支持增量更新。
-
本地检索:按关键词、时间、发送者筛选消息,支持正则搜索。
-
数据导出:将聊天记录导出为文本/JSON/YAML格式,便于备份或分析。
-
基础管理:查看服务器成员、频道信息,监控聊天活跃度(timeline/top命令)。
基础用法
# 安装
uv tool install kabi-discord-cli
# 认证(提取本地Token并保存)
discord auth --save
# 同步服务器消息(首次同步)
discord dc sync-all -n 500
# 本地查询
discord search "rust" -c general # 搜索general频道的"rust"相关消息
discord today --json # 查看今日消息(JSON格式)
# 导出数据
discord export "技术交流" -f yaml -o chat.yaml # 导出频道消息至YAML文件
3. twitter-cli(Twitter/X)
核心意义
无需官方API密钥即可操作Twitter/X,支持推文读写、账号管理全流程,适合用户快速浏览 timeline 或开发者自动化发推。
核心原理
-
基于Cookie认证(支持多浏览器提取)和TLS指纹伪装(
curl_cffi),模拟浏览器请求行为。 -
内置评分筛选:可通过配置文件设置点赞、转发、回复权重,自动筛选高价值推文。
核心作用
-
内容消费:浏览For You/Following时间线、搜索推文(支持Top/Latest/图文筛选)、查看用户主页。
-
内容创作:发布推文/回复/引用推文,支持最多4张图片附件。
-
账号管理:点赞、转推、书签操作,批量管理关注列表。
-
长文处理:提取Twitter Article并导出为Markdown格式。
基础用法
# 安装
uv tool install twitter-cli
# 浏览时间线
twitter feed -t following # 查看关注对象的推文
twitter feed --filter # 启用高价值推文筛选
# 搜索与查看
twitter search "AI agent" -t Latest --max 50 # 搜索最新相关推文
twitter show 2 --full-text # 查看第二条结果的完整内容
# 发布推文
twitter post "Hello from CLI!" --image photo.jpg # 带图发推
4. tg-cli(Telegram)
核心意义
基于Telethon的本地优先工具,解决Telegram官方客户端搜索功能有限、数据备份不便的问题,适合重度用户管理聊天记录或自动化消息处理。
核心原理
-
基于MTProto协议(非Bot API),使用个人账号认证,将对话框同步至本地SQLite数据库。
-
支持定时同步(cron/systemd)和近实时监听,确保本地缓存与云端一致。
核心作用
-
聊天同步:批量同步指定聊天/频道的消息,支持按聊天数量限制同步频率。
-
高级检索:按关键词、正则、时间窗口筛选消息,支持多条件组合查询。
-
数据导出:导出聊天记录为多种格式,支持按时间范围筛选。
-
基础互动:发送消息至指定聊天,适合自动化通知场景。
基础用法
# 安装
uv tool install kabi-tg-cli
# 首次登录(默认使用Telegram Desktop凭证)
tg chats
# 刷新本地缓存
tg refresh
# 本地查询
tg search "Rust|Golang" --regex --hours 72 # 搜索72小时内相关消息
tg today --sync-first # 查看今日消息(先同步最新数据)
# 定时同步(systemd示例)
cp examples/systemd/tg-refresh.service ~/.config/systemd/user/
systemctl --user enable --now tg-refresh.timer
5. bilibili-cli(B站)
核心意义
B站全功能终端工具,覆盖视频消费、创作管理、互动操作,适合UP主批量管理作品或用户快速检索视频资源。
核心原理
-
逆向B站API,支持视频、动态、收藏夹等核心资源的操作,认证方式包括Cookie提取和二维码登录。
-
音频提取:基于
av库解析视频音频,切分为ASR-ready的WAV片段,支持自定义片段时长。
核心作用
-
视频消费:查看视频详情、字幕(支持SRT导出)、AI总结、热门评论。
-
创作管理:发布文字动态、删除动态、查看作品数据(播放/点赞数)。
-
互动操作:点赞、投币、一键三连,批量管理关注列表和收藏夹。
-
音频提取:下载视频音频并切分片段,用于语音识别或二次创作。
基础用法
# 安装(含音频提取功能)
uv tool install "bilibili-cli[audio]"
# 登录(二维码登录)
bili login
# 视频操作
bili video BV1ABcsztEcY --subtitle # 查看视频字幕
bili audio BV1ABcsztEcY --segment 60 # 提取音频(每段60秒)
# 互动操作
bili triple BV1ABcsztEcY # 一键三连
bili favorite 123456 # 收藏视频
# 创作操作
bili dynamic-post "抽个奖,明天开奖" # 发布文字动态
三、系列工具共性与差异
共性
-
安装方式统一:均支持uv/pipx安装,部分支持源码编译,环境隔离性好。
-
认证逻辑一致:优先提取浏览器Cookie,辅以二维码/Token认证,无需手动配置密钥。
-
输出格式标准化:均支持JSON/YAML/rich格式,非交互模式默认YAML,适配AI Agent和脚本。
-
反风控设计:均包含请求延迟、指纹伪装等机制,降低账号封禁风险。
差异
| 工具 | 核心定位 | 独特功能 | 数据存储方式 |
|---|---|---|---|
| xiaohongshu-cli | 内容创作与互动 | 短索引快速操作、分类热门浏览 | 本地缓存(索引/ Cookie) |
| discord-cli | 聊天记录同步与导出 | 服务器成员管理、活跃度统计 | SQLite数据库 |
| twitter-cli | 推文读写与筛选 | 高价值推文评分、长文导出 | 本地缓存(配置/ Cookie) |
| tg-cli | 聊天记录本地管理 | 近实时监听、定时同步 | SQLite数据库 |
| bilibili-cli | 视频消费与创作 | 音频提取、字幕导出、AI总结 | 本地缓存(Cookie) |
四、使用建议
-
环境依赖:优先使用uv工具安装,避免依赖冲突;定期升级(
uv tool upgrade <工具名>)以适配平台API变更。 -
账号安全:避免高频次批量操作,建议使用代理(部分工具支持
XXX_PROXY环境变量);敏感账号优先使用二维码登录。 -
数据管理:本地缓存文件默认存储在
~/.xxx-cli/目录,定期备份重要数据(如discord/tg的SQLite数据库)。 -
AI集成:通过
--yaml格式输出数据,配合SKILL.md配置,可快速对接Claude等AI Agent,实现智能检索或自动化操作。
是否需要针对某款工具的高级功能(如批量操作脚本、AI集成配置)提供更详细的教程?
(注:文档部分内容可能由 AI 生成)