catbus（猫巴士）- 一套命令操作 10 个平台的统一 CLI 命令行工具 Vibe 项目

产品简介

catbus（猫巴士）是一个开源的命令行工具，把小红书、抖音、TikTok、B 站、快手、微博、闲鱼、淘宝、京东、X 这 10 个中外主流平台的 Web 端能力装进同一套命令中。所有平台都使用统一的命令语法、同一种 JSON 输出、同一套登录态目录——换平台只需要换一个命令前缀，AI Agent 和自动化脚本只需学一次就能调用十个平台。

核心功能

• 统一命令语法：跨平台使用同一套命令名（item search / item detail / comment list 等）和参数风格，学习成本低，可被 Claude Code、Cursor、Codex 等 Agent 直接调用。
• 统一 JSON 输出信封：所有接口成功失败都返回 {ok, data, page, error} 结构，error.hint 直接给出下一步命令，便于程序化串联调用。
• 多账号隔离登录态：扫码、短信、Cookie 导入三种登录方式，凭证按 平台 × 端 × 账号 隔离存放在 ~/.catbus/（0700/0600 权限），不收集、不上传任何数据。
• 平台能力自描述：catbus platforms douyin 可列出该平台已实现的全部命令、登录要求、实现状态、上游支持程度，方便 Agent 动态发现能力。
• 浏览器级网络栈：与真 Chrome 一致的 TLS / HTTP2 指纹，上游签名 JS 原样在沙箱里运行；滑块、点选验证码使用本地 ONNX + OpenCV 自动识别。
• 逐步扩展的覆盖：当前已实现小红书、抖音、TikTok、B 站、快手、微博、闲鱼、淘宝、京东、X 共 10 个平台，路线图还包括 Instagram、YouTube、Facebook、知乎、微信公众号、得物、美团、大众点评等。

技术实现

catbus 采用注册表驱动架构：命令解析、四层 --help、catbus platforms、能力矩阵均由同一份注册表生成，不会出现文档与实际能力不一致的情况。每个平台的代码按 client / api / normalize / resolve 四层组织——client 管会话与签名，api 一一映射上游方法，normalize 把原始数据变成统一的类型，resolve 让 ID、链接、分享短链、me 都能当参数。

在正确性方面，catbus 在固定的随机数与时钟下与上游实现逐字节对拍——每个请求的 URL、header 顺序、cookie、body 和签名都与原版一致，目前已有 560+ 份对拍数据、940+ 个离线测试守在 CI 上；原生依赖全部带预编译包，覆盖 Windows、macOS、Linux 的 x64/arm64（含 musl），共 8 个目标系统在 CI 上逐一冒烟验证。运行依赖仅 Node 18+，无需 Python、编译器或任何系统级依赖。

快速上手

1. 安装：npm i -g catbus-cli（或 Docker / 源码安装，三选一）。
2. 环境检查：catbus doctor 自动校验 Node 版本、网络栈与可选依赖。
3. 登录平台：catbus bilibili auth login（或其他平台）扫码登录，凭证自动落到 ~/.catbus/。
4. 第一次搜索：catbus bilibili item search 猫 --limit 20 返回统一结构的 JSON 列表。
5. 给 Agent 用：npx skills add cv-cat/catbus 一条命令把技能装进 Claude Code / Cursor / Codex，技能按需加载——总纲只有一页，做哪类事才读对应子文件。
6. 查看能力清单：catbus platforms douyin | jq '.data.commands[] | select(.status=="implemented")' 列出该平台已实现的所有命令。

适用人群

• AI Agent 工程师：需要为 Claude Code、Cursor、Codex 等 Agent 提供稳定的多平台 Web 数据采集与发布能力。
• 自动化脚本作者：跨平台做内容运营、舆情监控、电商选品、用户增长时，避免每个平台写一套胶水代码。
• 数据分析师 / 研究员：批量抓取小红书、抖音、B 站等平台公开数据做选题研究、竞品监测、用户反馈分析。
• 跨境电商运营：统一管理闲鱼、淘宝、京东、X 等多平台账号，配合分平台脚本做批量操作。
• 个人开发者：不想为每个平台重写登录态管理和签名反爬，把精力放在自己的业务逻辑上。
• 测试与排障：通过 catbus doctor 与 error.hint 快速定位环境配置、网络指纹、风控触发等问题。

官方链接

• 仓库：https://github.com/cv-cat/catbus
• All-IN-ONE 聚合（CLI + SKILLS）：https://github.com/cv-cat/All-IN-ONE
• npm 包：https://www.npmjs.com/package/catbus-cli
• 文档站：仓库内 docs/ 目录（快速上手 / 登录配置 / 输出与错误处理 / 各平台说明 / 能力矩阵 / 示例脚本 / AGENTS.md）