Catbus（猫巴士）

catbus（猫巴士）是一款面向开发者与AI Agent的命令行工具，目标把国内外各大平台五花八门的接口、签名机制、登录体系、数据格式全部封装，提供统一命令语法。一套命令、同结构JSON、统一登录目录，切换平台仅需要替换平台名称关键词。

目前已经支持10个平台：小红书、抖音、TikTok、B站、快手、微博、闲鱼、淘宝、京东、X。

后续还将接入Instagram、YouTube、Facebook、知乎、微信公众号、今日头条、得物、拼多多、美团、大众点评。

核心使用示例

catbus xhs      item search 露营 --sort latest
catbus douyin   item search 露营 --sort latest
catbus bilibili item search 露营 --sort latest
catbus x        item search camping --sort latest

四条几乎一致的指令，分别检索不同平台，返回格式统一的JSON。在catbus抽象层里，笔记、短视频、稿件、推文统一命名为item；搜索统一叫search，点赞统一叫like。开发者只需要学习一次语法，即可操作全部平台。

核心特性

同义同名抽象

相同语义的操作在全平台使用一致命令、参数与输出结构。底层依然识别各平台原生术语，同时引导开发者使用统一抽象词汇。

部署简单，仅依赖Node
无需Python、编译器，所有原生依赖附带预编译包，支持Windows、macOS、Linux的x64/arm64（含musl），共8类目标系统，CI持续冒烟测试。

原生面向AI Agent设计

标准输出仅输出JSON，退出码稳定；报错信息附带可直接执行的后续指令，自带llms.txt与Agent技能描述。可一键将catbus能力接入Claude Code、Cursor、Codex等智能体。

返回结果统一信封结构 { ok, data, page, error }，所有输出携带ID与链接，方便任务链式接力；高危操作要求增加 -y 确认，发布内容默认可设为仅自己可见，触发风控直接抛出RISK_CONTROL，不会静默重试。

本地凭证存储，不上传数据

支持扫码、短信、Cookie导入。账号凭证隔离存放在本机 ~/.catbus/ 目录，权限严格限制；多账号自由切换，无遥测、不会收集上传用户任何数据。

精准请求模拟

请求URL、请求头顺序、Cookie、请求体、签名逻辑，在固定随机数与时钟条件下和真实网页端逐字节对齐；拥有560+份对拍样本、940+离线测试用例保障迭代质量。内置浏览器级网络指纹，沙箱执行平台签名JS；滑块、点选验证码依靠本地ONNX与OpenCV识别。

架构设计

由注册表驱动，命令解析、帮助文档、能力矩阵全部由同一份注册表自动生成，保证信息一致。
采用模块化分层：client负责会话与签名，api层一一映射上游接口，normalize模块把平台原始数据归一化为统一结构，resolve支持ID、链接、短链、me别名作为参数。架构预留App/PC端扩展能力，非JS体系平台可通过provider协议接入。

快速上手

npm i -g catbus-cli
catbus doctor                 # 环境自检
catbus bilibili auth login    # 扫码登录B站
catbus bilibili item search 猫 --limit 20

同时支持Docker部署与源码编译安装。