Agent skill

Catbus

by cv-cat in cv-cat/catbus

用 catbus CLI 读取或操作小红书(RedNote)、抖音、TikTok、B 站(Bilibili)、快手、微博、闲鱼、淘宝、京东、X(Twitter)这 10 个平台:搜索、详情、评论、用户、推荐流、下载、发布、点赞关注、私信、直播弹幕,输出统一的 JSON。用户要查询、采集、导出、监听或操作这些平台上的内容和账号时使用。

MITAuto-check passedData & Analytics

Install Catbus

skills CLI
$ npx skills add cv-cat/catbus --skill catbus -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cv-cat/catbus catbus --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cv-cat/catbus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/catbus .claude/skills/catbus && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
catbus
GitHub stars
247
Token cost
~986 tokens
SKILL.md length
238 words
Files
16
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

用 catbus CLI 读取或操作小红书(RedNote)、抖音、TikTok、B 站(Bilibili)、快手、微博、闲鱼、淘宝、京东、X(Twitter)这 10 个平台:搜索、详情、评论、用户、推荐流、下载、发布、点赞关注、私信、直播弹幕,输出统一的 JSON。用户要查询、采集、导出、监听或操作这些平台上的内容和账号时使用。

  • Works in 6 steps: 登录交给用户。扫码要用户的手机,短信、密码、cookie 要用户本人提供。把… → 写操作先确认。发布、评论、点赞、关注、私信、删除会真实改变用户的账号。用户没有明确… → 发布默认仅自己可见(--visibility… → …
  • Data & Analytics work in your project
  • SKILL.md covers 按任务读对应的文件, 平台, 命令语法 and 先查能力,再调用, plus 2 more sections
  • Calls npm

What it does

Catbus is an agent skill from cv-cat/catbus. 用 catbus CLI 读取或操作小红书(RedNote)、抖音、TikTok、B 站(Bilibili)、快手、微博、闲鱼、淘宝、京东、X(Twitter)这 10 个平台:搜索、详情、评论、用户、推荐流、下载、发布、点赞关注、私信、直播弹幕,输出统一的 JSON。用户要查询、采集、导出、监听或操作这些平台上的内容和账号时使用。

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files (for example `platforms/bilibili.md`, `platforms/douyin.md` and `platforms/jd.md`).

It sits in Data & Analytics. It works with Xiaohongshu, TikTok, Bilibili and X (Twitter). The repository describes itself as: 一个命令操作小红书、抖音、TikTok、B 站、快手、微博、闲鱼、淘宝、京东、X:统一的命令与 JSON 输出,给人和 AI Agent 用. The licence is MIT.

When your agent uses it

  • Data & Analytics work in your project

Example prompts

  • “/catbus”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. 登录交给用户。扫码要用户的手机,短信、密码、cookie 要用户本人提供。把 hint 里的登录命令给用户,让他在自己的终端执行;不要索要或保存密码、验证码、cookie,不要读取、打印或修改 ~/.catbus/ 里的凭证文件。
  2. 写操作先确认。发布、评论、点赞、关注、私信、删除会真实改变用户的账号。用户没有明确要求就不做;危险操作只在用户同意这一次之后才加 -y。
  3. 发布默认仅自己可见(--visibility private),除非用户明确要公开。平台只支持公开时(闲鱼、X、B 站动态),先告诉用户会公开发出去。
  4. 不主动联系真人:不给别人发私信、评论、@、关注,除非用户给出了对象和内容。不批量发送。
  5. 风控就停:RISK_CONTROL 不要循环重试,连续请求同一平台时留出间隔,不并发。
  6. 照实汇报:结果为空、字段为 null、命令不支持,都照实告诉用户,不编造数据。

What it can do on your machine

Read from SKILL.md and the folder at commit e637cb4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Catbus loads about 986 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 238 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~986

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cv-cat/catbus at commit e637cb4, republished under its MIT licence (© cv-cat). 238 words, ~986 tokens.

Download SKILL.mdSave it as .claude/skills/catbus/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
catbus
description
用 catbus CLI 读取或操作小红书(RedNote)、抖音、TikTok、B 站(Bilibili)、快手、微博、闲鱼、淘宝、京东、X(Twitter)这 10 个平台:搜索、详情、评论、用户、推荐流、下载、发布、点赞关注、私信、直播弹幕,输出统一的 JSON。用户要查询、采集、导出、监听或操作这些平台上的内容和账号时使用。

catbus

catbus(猫巴士)是一个命令行工具,用同一套命令、同一种 JSON 调用 10 个平台的 web 端接口。stdout 只有 JSON,日志、提示、二维码都在 stderr。

先确认它能用:catbus version、catbus doctor。找不到 catbus 命令时告诉用户安装(npm 包 catbus-cli,或从源码 npm link),不要自己去装。

按任务读对应的文件

这个文件只放总纲。动手前,按任务再读一两个文件,不需要全读:

任务读
涉及某个平台platforms/<id>.md:能做什么、做不到什么、参数怎么传、有哪些坑
搜索、采集、导出、翻页、下载、跨平台对比workflows/collect.md
发布、评论、点赞、收藏、关注、删除等写操作workflows/write.md
直播弹幕监听、私信workflows/live-msg.md
命令报错:未登录、风控、不支持、网络workflows/errors.md
查某条命令的参数、选项、输出字段reference/commands.md

平台

平台id别名item 是登录文件
小红书xhsxiaohongshu rednote笔记cookie(扫码常被拦)platforms/xhs.md
抖音douyindy作品扫码platforms/douyin.md
TikToktiktoktt视频cookie / 会话 JSONplatforms/tiktok.md
B 站bilibilibili b稿件扫码platforms/bilibili.md
快手kuaishouks作品扫码platforms/kuaishou.md
微博weibowb微博cookieplatforms/weibo.md
闲鱼xianyugoofish xy闲置商品扫码platforms/xianyu.md
淘宝taobaotb商品cookieplatforms/taobao.md
京东jdjingdong商品 SKU扫码platforms/jd.md
Xxtwitter推文cookieplatforms/x.md

还不支持:Instagram、YouTube、Facebook、知乎、微信公众号、今日头条、得物、拼多多、美团、大众点评正在开发,现在执行会报「未知的平台」(USAGE)。用户问到时直接说还不支持,不要尝试调用,也不要拿别的平台凑数。

命令语法

catbus <platform> <resource> <action> [参数...] [选项...]
  • resource / action 用规范词,所有平台同名:笔记、视频、推文、商品一律叫 item,搜索叫 search,收藏夹叫 folder,私信叫 msg。note、video、tweet 这类原生叫法会报 UNSUPPORTED,hint 里给出规范词。
  • 参数接受 ID、URL(包括分享短链)、平台自然标识(B 站 BV 号、X 用户名);用户参数还可以是 me。输出对象都带 id 和 url,直接当下一条命令的参数,小红书一定要传 url。
  • 以 - 开头的位置参数放在 -- 之后。选项可以出现在任意位置。
  • -e app|pc 都还没实现(NOT_IMPLEMENTED),只用默认的 web 端。

先查能力,再调用

平台之间差别很大,调用前先查,不要猜:

bash
catbus platforms xhs              # JSON:每条命令的 status(implemented / planned)、auth、note
catbus xhs item search --help     # 参数、选项、筛选取值、登录要求、输出类型
  • status 为 planned 的命令会报 NOT_IMPLEMENTED,不要调用;note 写着限制(例如「只支持 me」),调用前看一眼。
  • 筛选取值(--sort --type --time)每个平台不同,以 --help 为准。
  • 平台文件里的「能做 / 做不到」是摘要,与 catbus platforms 冲突时以后者为准。

信封与退出码

stdout 恰好一个信封(-o jsonl 时每行一条 data,摘要信封在 stderr 最后一行):

json
{ "ok": true, "platform": "bilibili", "resource": "item", "action": "get", "account": "default",
  "data": {}, "page": null, "error": null }

失败时 ok 为 false、error 为 {code, message, hint, detail}。先读 error.hint,它是下一步该执行的命令或做法。

退出码code一句话
0—成功
2USAGE / UNSUPPORTED / CONFIRM_REQUIRED参数错 / 平台没有 / 危险操作没确认
3AUTH_REQUIRED / AUTH_EXPIRED让用户登录
4NOT_IMPLEMENTED规划中,别重试
5RISK_CONTROL风控,停下,别重试
6NETWORK网络 / 代理
7UPSTREAM平台业务错误,原始码在 detail
1ERROR其他

每种错误怎么处理见 workflows/errors.md。

红线

这些规则在任何任务里都成立:

  1. 登录交给用户。扫码要用户的手机,短信、密码、cookie 要用户本人提供。把 hint 里的登录命令给用户,让他在自己的终端执行;不要索要或保存密码、验证码、cookie,不要读取、打印或修改 ~/.catbus/ 里的凭证文件。
  2. 写操作先确认。发布、评论、点赞、关注、私信、删除会真实改变用户的账号。用户没有明确要求就不做;危险操作只在用户同意这一次之后才加 -y。
  3. 发布默认仅自己可见(--visibility private),除非用户明确要公开。平台只支持公开时(闲鱼、X、B 站动态),先告诉用户会公开发出去。
  4. 不主动联系真人:不给别人发私信、评论、@、关注,除非用户给出了对象和内容。不批量发送。
  5. 风控就停:RISK_CONTROL 不要循环重试,连续请求同一平台时留出间隔,不并发。
  6. 照实汇报:结果为空、字段为 null、命令不支持,都照实告诉用户,不编造数据。

© cv-cat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 15 other files in .agents/skills/catbus of cv-cat/catbus.

  • SKILL.md
  • platforms/bilibili.md
  • platforms/douyin.md
  • platforms/jd.md
  • platforms/kuaishou.md
  • platforms/taobao.md
  • platforms/tiktok.md
  • platforms/weibo.md
  • platforms/x.md
  • platforms/xhs.md
  • platforms/xianyu.md
  • reference/commands.md
  • workflows/collect.md
  • workflows/errors.md
  • workflows/live-msg.md
  • workflows/write.md

Open the folder on GitHubat commit e637cb4

Compare with similar skills

Catbus next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Catbus compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Catbus this skillcv-cat/catbus247—~986Automated safety check: PassMIT
Media Crawlertsingyuai/growth-lab2k—~731Automated safety check: PassApache-2.0
Social Cover DirectorJamailar/Beav1.8k—~1.7kAutomated safety check: WarnCustom licence
Ra Video DownloadPluviobyte/rnskill1.6k—~861Automated safety check: NotesCustom licence
Video Publishgodot-fun/gai182—~2.6kAutomated safety check: PassMIT
Opinions Crawlerinfometa/workbuddyskills346—~2.2kAutomated safety check: PassNone

Similar skills

  • Media Crawler

    tsingyuai/growth-lab

    Install, authenticate, configure, operate, and troubleshoot the external MediaCrawler client shared by Douyin, Kuaishou, Bilibili, Weibo, Tieba, and Zhihu collectors.

    2k GitHub stars~731 tokensUpdated 10 days ago
    Data & AnalyticsAuto-check passed
  • A skill your agent uses when the user wants to plan or generate a social media cover image for a Xiaohongshu note, Douyin/TikTok photo post, Reels/Shorts cover, WeChat/Video Account post…

    1.8k GitHub stars~1.7k tokensUpdated today
    Media & CreativeAuto-check: warnings
  • Ra Video Download

    Pluviobyte/rnskill

    Download source video or audio from Douyin, YouTube, Bilibili, Twitter/X, Xiaohongshu, and other yt-dlp-supported URLs into the content-creation workspace.

    1.6k GitHub stars~861 tokensUpdated 18 days ago
    Media & CreativeAuto-check: notes
  • Video Publish

    godot-fun/gai

    From user materials, generates multi-platform video publish pack: Zhihu Chinese article, Reddit English post, 3 landscape + 3 portrait Google image-gen cover prompts, and title/description/tags for…

    182 GitHub stars~2.6k tokensUpdated today
    Media & CreativeAuto-check passed
  • Opinions Crawler

    infometa/workbuddyskills

    基于 OpenCLI 的舆情数据抓取技能。覆盖国内外主流社媒(搜索、用户信息、帖子/视频列表、视频详情及互动量、评论、弹幕等)和商店平台数据爬取。当用户需要抓取舆情数据、采集社媒内容、获取商店评分评论、或者需要安装和配置 OpenCLI 时使用。

    346 GitHub stars~2.2k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Social Distribute

    npc-live/clawfirm

    一键多平台视频分发。读取各平台 content-rules,一次 LLM 调用生成全平台文案, 再用 browsershortcut 并行填表。支持:抖音、TikTok、B站、小红书、YouTube、LinkedIn、微信视频号。

    156 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Catbus

What does Catbus do?

用 catbus CLI 读取或操作小红书(RedNote)、抖音、TikTok、B 站(Bilibili)、快手、微博、闲鱼、淘宝、京东、X(Twitter)这 10 个平台:搜索、详情、评论、用户、推荐流、下载、发布、点赞关注、私信、直播弹幕,输出统一的 JSON。用户要查询、采集、导出、监听或操作这些平台上的内容和账号时使用。. Catbus is an agent skill from cv-cat/catbus.

When should I use Catbus?

Catbus fits situations like: data & Analytics work in your project.

How do I install Catbus in Claude Code?

Run `npx skills add cv-cat/catbus --skill catbus -a claude-code`. Or copy the skill folder (.agents/skills/catbus in cv-cat/catbus) into .claude/skills/catbus in your project. Claude Code loads it when a task matches its description.

How do I install Catbus in Codex?

Run `npx skills add cv-cat/catbus --skill catbus -a codex`. Or copy the skill folder (.agents/skills/catbus in cv-cat/catbus) into .agents/skills/catbus in your project. Codex loads it when a task matches its description.

Can I use Catbus in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cv-cat/catbus --skill catbus -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/catbus, .gemini/skills/catbus, .github/skills/catbus and .opencode/skills/catbus in your project.

What does Catbus need to run?

Going by SKILL.md and its folder, Catbus needs the command-line tools its instructions call (npm).

Does Catbus access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Catbus safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Catbus use?

Catbus is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Catbus use?

About 986 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Catbus?

Skills that share tags, products or a category with Catbus: Media Crawler (tsingyuai/growth-lab, 2k stars), Social Cover Director (Jamailar/Beav, 1.8k stars), Ra Video Download (Pluviobyte/rnskill, 1.6k stars) and Video Publish (godot-fun/gai, 182 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Catbus?

cv-cat (a GitHub user) maintains it in cv-cat/catbus, which has 247 GitHub stars. The repository was last updated on October 7, 2026.

Source: cv-cat/catbus on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.