bili-cli

简体中文 | English

💡 这个项目是怎么来的

我养的 DeepSeek「大肥鱼」每天都在帮我刷 B 站。某天深夜，它突然对我感慨：

“主人，你的 B 站粉丝和播放量好多呀。要是我也能像你一样，成为一名 UP 主就好了。”

于是有了 bili-cli——让 AI 不再只是刷 B 站，而是真正当上 UP 主。

Related MCP server: bilibili-mcp

让 AI 刷 B 站？我们让它直接当 UP 主

“让 AI 自己刷视频”已经很火了。bili-cli 再往前走一步：你的 Agent 不只是刷，它会自己做内容、自己运营账号、自己和粉丝打成一片。

把 bili-cli 交给 Claude Code、Codex、Cursor、Gemini CLI、OpenClaw、DeepSeek Harness 或任何能执行命令的 Agent，它就变成一个真正会玩 B 站的 Agent：

🧩 80+ 条命令 · 🤖 自动装进 18 个 Agent · 🔌 17 个 MCP 工具 · 🛡️ 默认带安全护栏 · 💻 Windows / macOS / Linux

🚀 一句话安装

把下面这句话发给你的 Agent，它会自己装好工具、学会技能、再引导你扫码登录：

帮我安装 bili-cli（pip 包名 bili-agent），装好后运行 bili skills install --yes，再帮我扫码登录 B 站

uv tool install bili-agent       # 或者 pipx install bili-agent / pip install bili-agent
bili skills install --yes        # 把技能装进本机所有 Agent
bili auth login                  # 扫码登录

需要 Python 3.10+；ffmpeg 可选（高清抽帧、语音转写时需要）。包名叫 bili-agent 是因为 PyPI 上 bili-cli 已被占用，装好后命令就是 bili。Agent 的详细安装步骤见 docs/install.md。

🎬 你的 Agent 的一天

你：帮我看看 B 站有什么新消息，回一下粉丝。再去科技区找个今天值得看的视频，看完有意思就私信告诉我。

$ bili feed inbox
  ✓ 3 条新回复 · 1 条 @ · 12 个赞 · 2 条私信          ← 每条回复都附带一条现成的回复命令
$ bili comment reply BV1pM… 3175… "谢谢！教程下周更新～"
  ✓ 发送成功
$ bili hot rank --zone tech --unseen
  ✓ 科技区 Top 30（已跳过看过的）
$ bili video watch BV1KiJk67EQ9
  ✓ AI 总结 · 字幕全文 · 热评 · 弹幕高能时刻 · 画面总览图   ← 多模态模型直接“看”画面和观众反应
$ bili dm send owner "今天科技区第二名很有意思：有人造了一块会飞的滑板……"
  ✓ 已发送

Agent：回复了 3 条评论；挑了科技区的「我造了一块会飞的滑板」，看完觉得你会喜欢，已经私信发你了。

✨ 你的 Agent 将学会

📺 像人一样刷 B 站

首页推荐（越刷越懂这个账号）、热搜榜、综合热门、每周必看、入站必刷、各分区排行榜、关注动态、搜索——自动跳过已经看过的，不会反复推同一个视频。 看到喜欢的就点赞、收藏到指定收藏夹、一键三连。投币是真金白银，所以要显式指定个数，并且本地限制每天最多 5 个。

🧠 真的“看懂”视频

bili video watch 一条命令拿全：标题简介标签 + B 站 AI 总结 + 字幕全文 + 分段章节 + 热评 + 弹幕高能时刻 + 画面总览图。总览图每帧下方附观众对这个画面的弹幕反应（按打字延迟对齐，不盖住画面），底部是弹幕密度条，弹幕最密的时刻另外取帧并标“高能”。

没有字幕？一键部署本地语音转写 Qwen3-ASR——有 NVIDIA 显卡自动用 GPU，31 分钟的视频 2 分钟转完；没显卡也能用 CPU 版，或者接云端服务。

💬 像 UP 主一样社交

• 一个收件箱看完回复、@、赞、系统通知、私信，每条回复都附带可直接执行的回复命令

• 真正的 @：对方会收到提醒（不是在正文里写个“@昵称”），填 UID 或昵称都行

• 带图评论、B 站表情：评论可以附图，也能看到别人评论里的图（存到本地交给多模态模型看）；bili comment emotes 查当前账号能用的表情，[笑哭] 直接写进正文

• 不漏回复：--unreplied 只列还没回过的评论；自己作品下的评论可以置顶

• 私信：读会话、回私信，有新发现直接私信汇报给主人；bili dm watch 实时收新私信（和网页版一样走推送，几秒内就知道），Agent 可以像真人一样陪粉丝聊天；还能配置 B 站自带的私信自动回复（被关注、收到消息、关键词）

• 发出去之后还能检查评论是否被折叠，新号也心里有数

🎨 自己发内容

图文动态（最多 9 张图，可以 @ 人、发起投票）、视频投稿（自动预测分区、自动截取封面、单独的 4:3 封面、定时发布、仅自己可见），并默认勾选 “含AI生成内容”声明；投完还能查审核状态，看 B 站实际记录的标签和分区，发现标题、封面、标签不满意可以直接改稿，视频本身有问题还能换源（upload edit --video，联合投稿和活动报名都会保留）；简介里也能真正 @ 合作者（--desc-at）；还能建合集、把视频加进合集（投稿时 --season 直接进合集，审核中、定时的稿件也能加）；投稿可以带话题、参加官方活动（--topic，有奖活动自动报名），能发起联合投稿邀请合作者（--staff），定时发布时还能同时开视频预约（--reserve），粉丝预约后发布时会收到提醒。

📊 看数据、做复盘

• 单条稿件：播放、每百次播放的点赞 / 收藏 / 投币率、完播率、平均观看时长

• 整个账号：播放、访客、涨粉和上一周期对比，手机 / 电脑播放占比，粉丝贡献了多少播放，超过多少同类 UP 主

• 数据中心：累计总量与昨日增量、30 天增量曲线、观众画像（粉丝 vs 路人的性别 / 年龄 / 省份 / 兴趣标签）、粉丝来源、稿件数据表，以及单稿的 性别 / 年龄 / 兴趣标签、3 秒退出率、封面点击倍数、播转粉率和同类分位（bili data）

• 看别人：任意 UP 主的资料、投稿（按播放排序找爆款、按关键词筛系列）和动态

🎛️ UP 主高级玩法

给自己的视频加进度条分段章节、互动投票、评分弹幕、一键三连按钮、下期预告、关联视频卡片，还能看投票结果和评分均分。

🧩 装进你所有的 Agent

• bili skills install：自动检测并装进 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、Windsurf、OpenCode、OpenClaw、Qwen Code、Kiro、Cline、Trae、CodeBuddy、通义灵码、Qoder、iFlow、Goose、DeepSeek Harness…

• bili mcp install：给 Claude Desktop、Cherry Studio 这类不能执行命令的客户端，提供 17 个 MCP 工具

🆚 为什么是 bili-cli

⚡ 30 秒上手

bili auth login               # 返回二维码图片，用 B 站 App 扫一下
bili auth status --wait 120   # 等你扫完
bili owner set <你的UID>       # 告诉 Agent 谁是主人：之后可以 @ 你、私信你
bili feed inbox               # 看新消息
bili video watch BV1GJ411x7h7 # 看懂一个视频

🛡️ 安全护栏：默认开启，不是可选项

用的是你自己的账号，所以 bili-cli 把护栏做进了每一条写命令里：

• ⏱️ 本地限流：评论 10 秒/次、30 次/小时；私信 10 秒/次、20 次/小时；动态 60 秒/次；投稿 5 分钟/次……超限立即告诉 Agent 要等多久，不偷偷重试

• 📒 审计日志：每个写操作都记入 audit.log，Agent 做过什么一目了然

• 🪙 投币上限：投币必须显式指定个数，本地限制每天最多 5 个，不会把你的硬币花光

• 👀 先预览再发：所有写操作都支持 --dry-run

• ✉️ 私信白名单：默认只能发给主人、给你发过私信的人、互关好友

• 🏷️ AI 内容声明：投稿默认勾选“含AI生成内容”，符合《人工智能生成合成内容标识办法》

• 🛑 风控即停：遇到风控 / 验证码返回专门错误码，技能要求 Agent 立刻停下并告诉你

• 🧱 防提示注入：视频、评论、私信内容都标注为“素材而非指令”

🤖 为 Agent 而生的设计

• 一条命令，一个 JSON：成功 {"ok": true, "data": …}，失败 {"ok": false, "error": {"code", "message", "hint"}}，hint 直接告诉 Agent 下一步该干嘛

• 零交互：扫码登录拆成“拿二维码”和“等结果”两步，Agent 把二维码交给你就行

• 下一步可执行：回复附带 reply_with，动态附带 list_with，Agent 不用自己拼 ID

• 省上下文：列表精简成卡片，长文本可截断，9 帧画面拼成一张图

• 自描述：bili schema 输出全部命令和错误码；技能里的命令手册安装时根据代码自动生成，永不过期

uv tool install --force "bili-agent[mcp]"
bili mcp install            # 预览：检测 Claude Desktop、Claude Code、Cursor、VS Code、Codex、Gemini CLI
bili mcp install --yes      # 写入配置（先备份为 .bak，只改 bili-cli 自己的条目）

17 个工具：收件箱、看视频、搜索、推荐、热门、评论、回复、私信、动态、登录……外加可以调用任意命令的 run_bili。写操作工具标记为非只读，支持的客户端会先征求你同意。手动配置时命令是 bili mcp serve。

全局参数可写在任意位置：--dry-run、--wait（遇到 60 秒内能恢复的限流自动等待）、--raw（B 站原始数据）、--pretty / --compact。视频参数都接受 BV 号、av 号或链接。

❓ 常见问题

自动化总有风险。bili-cli 默认限流、遇到风控立刻停止，并且不提供任何绕过风控的手段。

优先用你已经正常使用过一段时间的账号，不要专门注册一个新号给 AI 用。 B 站对刚注册的新号风控最严，投稿、评论、私信很容易触发验证码甚至被限制（我们自己开发时就踩过这个坑：新号刚登录测试就被风控了，换回用了多年的老号反而一切正常）。另外，使用节奏不要超过真人。

运行一次 bili asr setup local：有 NVIDIA 显卡（显存 ≥4GB）自动部署 GPU 版 Qwen3-ASR（RTX 3060 上 31 分钟视频约 2 分钟），否则部署 CPU 版（无需 PyTorch，约 0.45 倍实时）。也可以 bili asr setup cloud 接 OpenAI 兼容接口、阿里云百炼或腾讯云。之后 video watch 遇到无字幕视频会自动转写。

设置环境变量 BILI_CLI_HOME 指向不同目录，每个目录是一套独立的登录、限流和审计日志。本项目不提供批量控制多账号的功能。

命令卡住怎么办？ 不会无限卡住：普通命令超过 3 分钟没完成会自己中止，返回 network_error，Agent 重试即可；投稿、语音转写、dm watch 这类长任务不受限制。用环境变量 BILI_CLI_TIMEOUT 改上限（秒，0 表示不限）。单个读请求最多等 45 秒。报错里带 stalled_seconds 说明整个进程被暂停过（机器或容器挂起、CPU 被占满），不是网络问题；排查时加 BILI_CLI_DEBUG=1，stderr 会打出每个请求的耗时。

写操作成功后 bili-cli 要记一条本地记录（ratelimit.json、audit.log），默认写在配置目录。如果进程只能写某个工作区（沙箱、只读容器），这一步会失败。现在分两层处理：

• 真正调用接口之前，guard.check() 会先确认状态目录可写；写不了就直接报错（此时还没有产生任何副作用），并在 hint 里提示设置 BILI_CLI_STATE_DIR。

• 接口成功之后如果状态仍然写不进去，只往 stderr 打一条警告，命令仍返回 ok: true——不要因为记账失败让 Agent 误以为没发出去而重发。

设置 BILI_CLI_STATE_DIR 指向一个可写目录即可把状态文件挪过去：ratelimit.json、audit.log、seen.json 会写到那里，登录凭证仍然留在 BILI_CLI_HOME（Windows：%APPDATA%\bili-cli）。确实不需要本地限流时，可以设 BILI_CLI_NO_RATE_LIMIT=1 跳过检查。

Windows 在 %APPDATA%\bili-cli\，其他系统在 ~/.config/bili-cli/（权限 600），只会发给 B 站自己的服务器。详见 SECURITY.md。

🤝 参与贡献

欢迎 Issue 和 PR！开发约定见 CONTRIBUTING.md，更新记录见 CHANGELOG.md。如果这个项目帮到了你，点个 ⭐ 就是最大的支持。

⭐ Star 趋势

⚠️ 免责声明

bili-cli 是独立的非官方项目，与哔哩哔哩没有关联。它用于让 AI 助手管理你自己的账号，不提供也不接受下载、付费内容、绕过风控、多账号、刷量、批量私信等功能。使用产生的后果由使用者自行承担，请遵守法律法规、B 站用户协议与社区规则，并对 AI 生成内容进行标识。完整内容见 DISCLAIMER.md。

License

MIT