catbus/README.zh-TW.md at master

okooooooo/catbus

0 Fork 0

Files

T

cv-cat 2493b08b4b 发布 0.1.0：安装说明改成 npm i -g catbus-cli，README 加 npm 徽章，CHANGELOG 写上发布日期

2026-10-06 23:48:35 +08:00

9.7 KiB

Raw Permalink Blame History

一個指令，開往 10 個平台。
小紅書 · 抖音 · TikTok · 嗶哩嗶哩 · 快手 · 微博 · 閒魚 · 淘寶 · 京東 · X
_{即將上車：Instagram · YouTube · Facebook · 知乎 · 微信公眾號 · 今日頭條 · 得物 · 拼多多 · 美團 · 大眾點評}

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

快速上手 · 能力矩陣 · 各平台 · 範例 · 給 Agent 用

每個平台都有自己的一套 API、簽章、登入方式和資料格式。catbus 把它們裝進同一輛車：同一套指令、同一種 JSON、同一個登入狀態目錄。換平台，只需要換一個詞。

✨ catbus 是什麼

catbus（貓巴士）是一個命令列工具，用統一的語法呼叫 10 個中國大陸及國際主流平台的 web 端功能：搜尋、詳細資料、留言、使用者、推薦動態、下載、發佈、私訊、直播彈幕……

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。筆記、作品、影片、推文一律叫 item，搜尋一律叫 search，按讚一律叫 like。學一次，十個平台都會用。

🚀 為什麼選 catbus

🧭 同義同名

意義相同的功能，在所有平台上都用同一個指令、同一組參數、同一種輸出。就算用了平台原生的叫法（note、aweme、tweet……）也沒關係，catbus 會告訴你該用哪個詞。

📦 只需要 Node

不需要 Python、編譯器或任何系統相依套件。原生相依套件全部附有預先編譯的版本，涵蓋 Windows、macOS、Linux 的 x64 / arm64（含 musl），8 個目標系統都在 CI 上逐一進行冒煙測試。

🤖 為 AI Agent 而生

stdout 只有 JSON，結束代碼穩定，錯誤訊息裡直接附上下一步該執行的指令；catbus platforms 會輸出完整的功能清單。內建 Agent 技能與 llms.txt。

🔐 登入狀態只留在你的電腦上

QR Code 掃描、簡訊、cookie 匯入都支援，憑證依 平台 × 端 × 帳號 隔離存放在 ~/.catbus/（0700 / 0600），多帳號隨時切換。不蒐集、不上傳任何資料，也沒有遙測。

🧪 與上游逐位元組一致

每個請求的 URL、header 順序、cookie、body 和簽章，都在固定的亂數與時鐘下和上游實作逐位元組比對。560+ 份比對資料、940+ 個離線測試，守住每一次修改。

🛡️ 瀏覽器等級的網路堆疊

與真正的 Chrome 一致的 TLS / HTTP2 指紋，上游簽章 JS 原封不動地在沙盒中執行，滑塊、點選驗證碼則用本機的 ONNX 與 OpenCV 自動辨識。

📊 一些數字

🚌 平台	⌨️ 已實作指令	🧪 比對資料	✅ 離線測試	💻 目標系統
10	300+	560+	940+	8

🏗️ 架構

一個註冊表驅動一切：指令解析、四層 --help、catbus platforms、能力矩陣都由同一份註冊表產生，永遠不會互相矛盾。
一個平台，一組檔案：client 負責工作階段與簽章，api 與上游方法一一對應，normalize 把原始資料轉成統一的型別，resolve 讓 ID、連結、分享短網址、me 都能當作參數。
可擴充：規範為 app / pc 端預留了位置；非 JS 的上游將透過 provider 協定接入。

🤖 為 AI Agent 而生

catbus 從第一天起，就是依照「被程式呼叫」來設計的：

catbus platforms douyin | jq '.data.commands[] | select(.status=="implemented") | .resource + " " + .action'

自我描述：每個平台、每條指令的登入需求、實作狀態、上游支援程度，一條指令就能查到。
可預期：成功和失敗都是同一種信封 { ok, data, page, error }；error.hint 直接給出下一步的指令。
能接力：所有輸出物件都帶有 id 和 url，上一條指令的結果可以直接餵給下一條。
有分寸：危險操作必須明確加上 -y，發佈時可以設為僅自己可見，遇到風控會明確回報 RISK_CONTROL，不會偷偷重試。

一行指令把 catbus 技能裝進 Claude Code、Cursor、Codex 等 Agent：

npx skills add cv-cat/catbus

技能按需載入：總綱只有一頁，碰到哪個平台、做哪類事（採集、發布、直播私訊、排錯）才讀對應的子檔案，並且內建安全紅線——登入交給你、寫入操作先確認、發布預設僅自己可見、遇到風控就停。

⚡ 30 秒上車

npm i -g catbus-cli

catbus doctor                 # 檢查環境
catbus bilibili auth login    # 掃描 QR Code 登入
catbus bilibili item search 猫 --limit 20

也可以用 Docker 或從原始碼安裝，完整步驟請見快速上手。

📚 文件

以下文件目前僅提供簡體中文版。


🚀 快速上手	從安裝到匯出第一批資料
🔑 登入 · ⚙️ 設定 · 🐳 Docker	掃碼 / cookie、多帳號、代理伺服器、容器
📤 輸出與錯誤處理	信封、正規化型別、分頁、結束代碼
🧭 各平台說明 · 🗂️ 能力矩陣	每個平台支援什麼、參數怎麼傳
🧪 範例腳本	跨平台搜尋、匯出留言、備份作品、錄製直播彈幕
📐 AGENTS.md	catbus 的規範本身
❓ 常見問題	為什麼要登入、遇到風控怎麼辦……