catbus：用统一命令与数据格式操作 10 个主流内容平台的命令行工具

跨平台抓取社交媒体与电商数据时，开发者往往需要同时维护十余套互不兼容的爬虫代码：小红书、抖音、TikTok、B 站、快手、微博、闲鱼、淘宝、京东与 X 的接口参数、加密签名以及登录凭证规范各不相同，稍有改动就会导致整条流水线崩溃。cv-cat 团队开源的 catbus（MIT 协议，TypeScript 编写，截至 2026-10-10 获得 268 星）旨在解决这一碎片化难题。项目基于纯 Node.js 构建，将 10 个中外主流平台的 Web 端能力抽象为一套统一的命令行语法与归一化 JSON 输出信封，既可以作为日常工程调试的 CLI 命令行工具，也能够作为外部 AI Agent 调用的标准化工具集。

核心功能

• 同义同名的高阶抽象语法：对所有平台的操作抽象出一致的资源名词与动词。在小红书、抖音、B 站或 X 上检索内容均使用统一的 item search <关键词> 指令，检索、详情、评论、作者主页与推荐流统一输出标准化 JSON 结构，避免了不同平台间字段名称千差万别的适配成本。
• 纯 Node.js 运行环境与零系统编译依赖：完全摆脱对 Python、C++ 编译器或系统底层动态库的依赖。项目自带跨平台预编译二进制产物，覆盖 Windows、macOS 与 Linux 的 x64 和 arm64 架构共计 8 种目标系统环境，支持一键安装开箱即用。
• 浏览器级网络协议栈与本地验证码识别：内置与真实 Chrome 保持一致的 TLS 和 HTTP/2 指纹特征；上游平台的 JavaScript 签名算法直接在隔离沙箱中运算执行；针对滑块拼图与点选验证码，集成由本地 ONNX 与 OpenCV 驱动的自动化识别推理引擎，无需外部付费打码服务。
• 本地凭证隔离与主动安全风控设计：登录支持扫码认证、短信校验与已有 Cookie 导入，所有凭证按平台、客户端与账号维度严格隔离保存在本地 ~/.catbus/ 目录中，项目不设外部遥测上报，不上传用户账号信息；写入与发布操作默认带显式确认提示，遭遇平台风控时明确返回 RISK_CONTROL 状态码，避免盲目重试导致封号。
• 面向 AI Agent 的自描述信封规范：标准输出全部为纯 JSON 字符串，所有成功与失败均包裹在统一的 { ok, data, page, error } 信封中；支持通过 catbus platforms <平台> 动态反射当前环境的能力矩阵；自带 Claude Code 技能描述与 llms.txt，支持通过 npx skills add cv-cat/catbus 直接接入智能体工程。

典型使用场景

• 全网社交舆情与竞品数据监测：配合 AnyCrawl 类抓取管线，用单一脚本定时轮询各大内容平台上的关键词热度、用户高频评论与商品评价，输出统一格式的数据集用于本地分析。
• 自媒体多平台发布与交互工作流：运营人员或内容分发机器人通过单一命令行完成素材查询与合规草稿投递，结合 cli-anything 这类智能体界面实现跨平台评论汇总与自动化提醒。
• 大模型外部工具集成：在 Coding Agent 或桌面智能体中作为标准化工具注入，让模型无需学习每个平台的逆向细节即可安全发起多渠道信息检索。

快速上手

确保系统具备 Node.js 22、24 或 26 环境，通过 npm 全局安装并运行环境诊断：

# 全局安装 catbus 命令行工具
npm i -g catbus-cli

# 执行环境检测
catbus doctor

# 扫码登录目标平台（以 B 站为例）
catbus bilibili auth login

# 检索内容并限制返回 20 条
catbus bilibili item search 猫 --limit 20

切换不同平台时只需将 bilibili 替换为 xhs、douyin 或 x，命令结构保持完全一致。

小结

catbus 适合需要高频与多个主流内容平台交互的数据工程师、自媒体技术人员与 Agent 开发者；它通过对齐上游对拍测试与标准化沙箱执行，显著降低了多平台爬虫工程的维护门槛。需要注意的是，项目目前正处于活跃迭代期，部分平台的深度写入与直播互动仍在演进中；各平台对非官方请求的风控规则各异，使用时应当严格遵守平台服务条款与当地数据合规要求，合理设置抓取频率以避免触发账号限制。