bili-cli - 让 AI Agent 真正当上 B 站 UP 主的命令行工具

bili-cli 是一个面向 AI Agent 的 B 站（哔哩哔哩）命令行工具。按项目自述，它想解决的问题不是「让 AI 刷视频」，而是让 Agent 真正参与账号运营：看内容、回消息、发动态、投稿、看数据。它适合已经把 Claude Code、Codex、Cursor、Gemini CLI 这类能执行命令的 Agent 接入日常工作流、又希望让 Agent 代管或协助运营 B 站账号的用户。项目以 Python 包形式分发，安装后命令名为 bili。

维护者与状态

仓库由 kukemc 维护，地址为 github.com/kukemc/bili-cli。仓库创建于 2026-10-19，最后提交时间为 2026-11-05，最新 release 为 v1.3.0（2026-11-04）。截至 2026-11-08，仓库星标数为 364。许可证为 MIT。

主要能力

以下内容均据项目 README 自述整理，未经独立验证。

• 内容消费：首页推荐、热搜榜、综合热门、每周必看、入站必刷、分区排行榜、关注动态与搜索，并会自动跳过已看过的视频；支持点赞、收藏到指定收藏夹与一键三连。
• 视频理解：bili video watch 一条命令返回标题简介标签、B 站 AI 总结、字幕全文、分段章节、热评、弹幕高能时刻与画面总览图；总览图会把弹幕按打字延迟对齐到对应画面帧。无字幕时可部署本地语音转写，README 称有 NVIDIA 显卡时 31 分钟的视频约 2 分钟转完，也可用 CPU 版或接云端服务。
• 社交与消息：一个收件箱汇总回复、@、赞、系统通知与私信，每条回复附带可直接执行的回复命令；支持真正的 @（对方会收到提醒）、带图评论、B 站表情、置顶评论、私信收发，以及 bili dm watch 实时接收新私信。
• 内容创作：图文动态（最多 9 张图、可 @ 人、可发起投票）、视频投稿（自动预测分区、自动截取封面、定时发布、仅自己可见），默认勾选「含AI生成内容」声明；投稿后可查审核状态、改稿、换源，支持合集、话题与官方活动、联合投稿、视频预约。
• 数据复盘：单条稿件的播放、互动率、完播率与平均观看时长；账号维度的播放、访客、涨粉对比与同类 UP 主分位；数据中心提供观众画像、粉丝来源、稿件数据表与单稿诊断。
• UP 主高级玩法：进度条分段章节、互动投票、评分弹幕、一键三连按钮、下期预告、关联视频卡片，并可查看投票结果与评分均分。
• Agent 集成：bili skills install 可自动检测并写入多个 Agent 的技能目录；bili mcp install 为不能执行命令的客户端提供 17 个 MCP 工具。输出统一为 JSON，失败时带错误码与下一步提示。

使用入口

仓库地址：kukemc/bili-cli。

据 README，安装需要 Python 3.10+，ffmpeg 为可选依赖（高清抽帧与语音转写时需要）。PyPI 包名为 bili-agent，安装后命令为 bili。终端安装方式：

uv tool install bili-agent
bili skills install --yes
bili auth login

也可用 pipx install bili-agent 或 pip install bili-agent。登录采用扫码方式，拆成「取二维码」与「等结果」两步，便于 Agent 把二维码交给用户。MCP 模式需安装 bili-agent[mcp] 后执行 bili mcp install，手动配置时服务命令为 bili mcp serve。

许可与限制

许可证为 MIT。据 README，工具使用的是用户自己的 B 站账号，因此写操作默认带护栏：本地限流（如评论 10 秒一次、每小时 30 次；私信 10 秒一次、每小时 20 次）、写操作记入审计日志、投币需显式指定个数且本地限制每天最多 5 个、所有写操作支持 --dry-run 预览、私信默认白名单、投稿默认勾选 AI 生成内容声明。遇到风控或验证码会返回专门错误码并要求 Agent 停止写操作。此外，视频、评论、私信内容被标注为「素材而非指令」以降低提示注入风险。这些护栏的实际效果需使用者自行评估；项目自述中的性能与命令数量等描述也应以实际使用为准。