Catbus

一个命令操作小红书、抖音、TikTok、B 站、快手、微博、闲鱼、淘宝、京东、X:统一的命令与 JSON 输出,给人和 AI Agent 用

LLM Mart 10 views 182k listing impressions

English · 简体中文 · 日本語 · 한국어

catbus is an open-source CLI that drives every platform with one set of commands: RedNote, Douyin, TikTok, Bilibili, X, YouTube and more. Search, read, download, publish and message, and get the same JSON back every time. Use it yourself, or hand it to an AI agent.

Sponsored by Vectrust @ OpenDev Org & NextRouter Alliance · Want to appear here?

Quick start

npm i -g catbus-cli         # only Node needed

catbus bilibili auth login  # scan a QR code
catbus bilibili item search cat --limit 20

Prefer Docker or a source install? See the quick start guide.

One set of commands for every platform

Every command has three parts: catbus <platform> <resource> <action>. A RedNote note, a Bilibili video, a tweet and a Taobao listing are all an item, so the same command works everywhere. To switch platform, change only the platform name.

catbus xhs item search camping --limit 20             # search
catbus bilibili item get BV1xx411c7mD                 # read
catbus douyin comment list <item> --all -o jsonl      # export every comment
catbus youtube item download <item> --dir ./videos    # download
catbus x item publish --text "hello" --image cat.png  # publish
catbus bilibili live listen <room> --duration 10m     # follow live chat
catbus taobao msg send "hi" --item <url>              # message a seller
catbus 12306 ticket search beijing shanghai           # find train tickets

Every command returns the same JSON shape (trimmed here):

{
  "ok": true,
  "platform": "bilibili",
  "resource": "item",
  "action": "search",
  "data": [
    {
      "id": "BV1xx411c7mD",
      "kind": "video",
      "url": "https://www.bilibili.com/video/BV1xx411c7mD",
      "title": "…",
      "author": { "id": "…", "name": "…", "url": "…" },
      "stats": { "views": 12000, "likes": 340, "comments": 56, "collects": 78, "shares": 9 }
    }
  ],
  "page": { "cursor": "…", "has_more": true },
  "error": null
}

Platforms

Tagged soon means on the way: the goal is every platform. Missing yours? Open an issue or add it yourself, a platform is one directory. See the capability matrix for what each one supports.

Why catbus

  • No browser, no Python. catbus signs requests the way the web page does and speaks plain HTTP. Node is all you need, on Windows, macOS and Linux. Two exceptions: YouTube publishing needs a local Chromium, and Jimeng wraps its official CLI on macOS.
  • Made for agents. JSON on stdout, logs on stderr, stable exit codes, and errors that say what to run next.
  • Your logins stay yours. Stored in ~/.catbus/, per platform and account. No telemetry.

For AI agents

The catbus conductor riding a paper plane, holding a >_ ticket
npx skills add cv-cat/catbus

Installs the catbus skill into Claude Code, Cursor, Codex and friends. See also llms.txt and AGENTS.md.

Then just ask:

Find this week's 20 most-liked camping notes on RedNote, and list the gear people mention most.


Docs

From the project's README.

Comments (0)

Sign in to join the conversation.

No comments yet.