kukemc / bili-cli

**简体中文** | English
## 💡 这个项目是怎么来的
我养的 DeepSeek「大肥鱼」每天都在帮我刷 B 站。某天深夜，它突然对我感慨：
> **“主人，你的 B 站粉丝和播放量好多呀。要是我也能像你一样，成为一名 UP 主就好了。”**
于是有了 bili-cli——让 AI 不再只是刷 B 站，而是**真正当上 UP 主**。
## 让 AI 刷 B 站？我们让它直接当 UP 主
“让 AI 自己刷视频”已经很火了。**bili-cli 再往前走一步**：你的 Agent 不只是刷，它会**自己做内容、自己运营账号、自己和粉丝打成一片**。
| | 🙂 AI 刷视频 | 🚀 **bili-cli：AI 当 UP 主** |
|---|---|---|
| **看** | 刷推荐、读字幕 | 再加上看懂画面、没字幕就自己语音转写 |
| **互动** | 偶尔留一条评论 | 一个收件箱看完回复、@、赞、私信，**挨个回复粉丝**，真正 @ 到人 |
| **表态** | — | 给喜欢的视频**点赞、收藏、一键三连** |
| **创作** | — | **发动态、投视频**、定时发布，自动打上 AI 生成声明 |
| **运营** | — | 进度条章节、互动投票、三连按钮、下期预告、改稿，盯审核、完播率和涨粉 |
| **汇报** | — | 有意思的发现**私信告诉主人**，评论里 @ 你 |
把 bili-cli 交给 Claude Code、Codex、Cursor、Gemini CLI、OpenClaw、DeepSeek Harness 或任何能执行命令的 Agent，它就变成一个**真正会玩 B 站的 Agent**：
> 🧩 **80+ 条命令** · 🤖 **自动装进 18 个 Agent** · 🔌 **17 个 MCP 工具** · 🛡️ **默认带安全护栏** · 💻 **Windows / macOS / Linux**
## 🚀 一句话安装
**把下面这句话发给你的 Agent**，它会自己装好工具、学会技能、再引导你扫码登录：
 [code] 
 或者自己在终端里装 
 [code] 
需要 Python 3.10+；ffmpeg 可选（高清抽帧、语音转写时需要）。包名叫 `bili-agent` 是因为 PyPI 上 `bili-cli` 已被占用，装好后命令就是 `bili`。Agent 的详细安装步骤见 docs/install.md。
## 🎬 你的 Agent 的一天
> **你**：帮我看看 B 站有什么新消息，回一下粉丝。再去科技区找个今天值得看的视频，看完有意思就私信告诉我。
 [code] 
> **Agent**：回复了 3 条评论；挑了科技区的「我造了一块会飞的滑板」，看完觉得你会喜欢，已经私信发你了。
## ✨ 你的 Agent 将学会
### 📺 像人一样刷 B 站
首页推荐（越刷越懂这个账号）、热搜榜、综合热门、每周必看、入站必刷、各分区排行榜、关注动态、搜索——自动**跳过已经看过的**，不会反复推同一个视频。
看到喜欢的就**点赞、收藏到指定收藏夹、一键三连**。投币是真金白银，所以要显式指定个数，并且本地限制每天最多 5 个。
### 🧠 真的“看懂”视频
`bili video watch` 一条命令拿全：**标题简介标签 + B 站 AI 总结 + 字幕全文 + 分段章节 + 热评 + 9 帧画面总览图**。
没有字幕？一键部署本地语音转写 **Qwen3-ASR**——有 NVIDIA 显卡自动用 GPU，**31 分钟的视频 2 分钟转完**；没显卡也能用 CPU 版，或者接云端服务。
### 💬 像 UP 主一样社交
- **一个收件箱**看完回复、@、赞、系统通知、私信，每条回复都附带可直接执行的回复命令
- **真正的 @**：对方会收到提醒（不是在正文里写个“@昵称”），填 UID 或昵称都行
- **带图评论、B 站表情**：评论可以附图，也能看到别人评论里的图（存到本地交给多模态模型看）；`bili comment emotes` 查当前账号能用的表情，`[笑哭]` 直接写进正文
- **不漏回复**：`--unreplied` 只列还没回过的评论；自己作品下的评论可以**置顶**
- **私信**：读会话、回私信，有新发现直接**私信汇报给主人**；还能配置 B 站自带的**私信自动回复**（被关注、收到消息、关键词）
- 发出去之后还能**检查评论是否被折叠**，新号也心里有数
### 🎨 自己发内容
图文动态（最多 9 张图，可以 @ 人、**发起投票**）、视频投稿（**自动预测分区、自动截取封面、单独的 4:3 封面、定时发布、仅自己可见**），并默认勾选 **“含AI生成内容”声明**；投完还能查审核状态，看 B 站实际记录的标签和分区，发现标题、封面、标签不满意可以直接**改稿**；简介里也能真正 **@ 合作者**（`--desc-at`）；还能**建合集、把视频加进合集**（投稿时 `--season` 直接进合集，审核中、定时的稿件也能加）；投稿可以带**话题、参加官方活动**（`--topic`，有奖活动自动报名），定时发布时还能同时开**视频预约**（`--reserve`），粉丝预约后发布时会收到提醒。
### 📊 看数据、做复盘
- **单条稿件**：播放、每百次播放的点赞 / 收藏 / 投币率、**完播率、平均观看时长**
- **整个账号**：播放、访客、涨粉和上一周期对比，手机 / 电脑播放占比，粉丝贡献了多少播放，**超过多少同类 UP 主**
- **看别人**：任意 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
| | 常见的 B 站 CLI / MCP | **bili-cli** |
|---|:---:|:---:|
| 搜索、视频信息 | ✅ | ✅ |
| 字幕全文 + AI 总结 + 画面总览图 | 部分 | ✅ |
| 本地语音转写（GPU / CPU） | ❌ | ✅ |
| 收件箱：回复 / @ / 赞 /