B站分身 Yaemikoreal/BilibiliPlayer

BilibiliPlayer ｜ 让 AI 直接操作B站

29 个 MCP 工具，一个跑在本机的 MCP Server —— 把B站变成智能体可调用的能力。
搜索 · 字幕 · 弹幕 · 评论 · 点赞 · 发动态 · 投稿 · 排行榜 · 私信 · 收藏夹

- 🔒 纯本地运行：MCP Server 只跑在你自己的机器上，登录凭证写在本地 bili_credential.json（已 .gitignore），不经过任何第三方服务器，也没有远程后端。
- 🧰 真接口，不是爬虫壳：29 个工具全部基于 bilibili-api-python，读写都走B站 Web API，登录沿用官方扫码流程。
- 🤖 智能体拿来就能干活：标准 MCP（stdio）接入 Claude Code / Cursor / Cline / OpenClaw；还附赠 DSH 插件「B站分身」——看板 + 操作台 + 值班章程，能让智能体自己运营一个小号。

⚡ 30 秒上手

git clone https://github.com/Yaemikoreal/BilibiliPlayer.git && cd BilibiliPlayer
python -m venv .venv && source .venv/bin/activate # Windows: .\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

在项目根目录新建 .mcp.json（把 /path/to 换成你的实际路径；Windows 写法见安装文档）：

{
"mcpServers": {
"bilibili-mcp": {
"command": "/path/to/BilibiliPlayer/.venv/bin/python",
"args": ["/path/to/BilibiliPlayer/mcp_server.py"]
}
}
}

重启客户端 → 对 AI 说 「登录B站」 → 用B站 App 扫码确认 → 开始使唤它。

完整安装（Windows / macOS / Linux）、Cursor / Cline / OpenClaw 配置、ffmpeg、MCP Inspector 调试、常见安装故障：docs/INSTALL.md

🧩 它能做什么

| | 能力 | 一句话 |
| 🔐 | 登录与账号 | 扫码登录、凭证校验，换号或过期一条 force=true 重来 |
| 🔍 | 采集与分析 | 搜索、评论、AI 字幕、弹幕、视频详情，还有一步到位的批量采集 |
| 📤 | 内容发布 | 发动态、图文长内容、单P / 多P 投稿，封面可自动截帧 |
| 📊 | 发现与榜单 | 热门、热搜、每周必看、分区排行榜、UP 主与收藏夹数据 |
| 💬 | 互动与消息 | 评论/楼中楼回复、点赞、私信、未读与 @/点赞通知 |

每个工具的参数、默认值与上限见下方 29 个工具全览。

🧰 29 个工具全览

全部注册在 mcp_server.py（FastMCP，stdio 传输），工具名与下方表格逐一对应。数量上限来自代码里的钳位逻辑，不是宣传口径。

🔐 登录认证（3） — 扫码、轮询、验活

| Tool | 作用 | 要点 |
| bili_login | 生成B站扫码登录二维码 | 返回 base64 图片 + 本地 PNG + 终端二维码 + 扫码 URL，180 秒有效；force=true 强制换号 |
| bili_login_check | 轮询扫码状态 | 手机确认后返回 done，凭证原子写入本机 |
| bili_check_credential | 校验当前凭证 | 返回 UID、用户名等登录状态 |

🔍 数据采集（6） — 搜索、评论、字幕、弹幕、详情、批采

| 工具 | 作用 | 要点 |
| bili_search | 搜索视频 | order：综合 / 播放量 / 最新 / 弹幕，最多 50 条 |
| bili_comments | 获取热门评论 | 按点赞排序、含子评论，最多 100 条 |
| bili_subtitle | 获取 AI 字幕 | 语音转文字全文，适合让模型总结视频 |
| bili_danmaku | 获取弹幕 | 最多 1000 条，按时间顺序分页取 |
| bili_video_info | 视频详情 | 播放量、评论数、收藏数、标签等 |
| bili_crawl | 批量采集 | 搜索 + 每个视频的评论 + 字幕，一次调用拿全 |

📤 内容发布（5） — 动态、图文、投稿

| 工具 | 作用 | 要点 |
| bili_send_dynamic | 发布图文动态 | 支持 @ 和表情、话题、定时发布，最多 9 张图 |
| bili_upload_video | 上传单P视频 | 标题/简介/分区/标签/封面/转载来源；未给封面时自动截第 3 秒，失败回退第 0 秒 |
| bili_upload_video_multi | 上传多P视频 | 多个分P合并为一个投稿，逐 P 指定标题 |
| bili_send_opus | 发布图文长内容 | 以动态形式发长图文（不是独立专栏） |
| bili_video_zones | 查询分区 ID | 投稿前查 tid |

📊 发现与榜单（7） — 热门、热搜、排行、UP 主

| 工具 | 作用 | 要点 |
| bili_hot_videos | 当前热门视频 | 分页，每页最多 50 |
| bili_hot_buzzwords | 热搜词 | 分页，做选题用 |
| bili_weekly_hot | 每周必看 | week=0 返回期数列表 |
| bili_rank | 分区排行榜 | 全站 + 24 个分区/分类，三日榜 / 七日榜 |
| bili_user_info | UP 主数据 | 粉丝数、等级、投稿数、总播放等 |
| bili_user_videos | UP 主投稿列表 | 分页 + 排序（最新/播放/收藏）+ 关键词过滤 |
| bili_followings | 我关注的 UP 主 | 分页 + 「最常访问」/ 最近关注排序 + 昵称过滤 |

💬 互动与消息（8） — 评论、点赞、收藏夹、私信、通知

| 工具 | 作用 | 要点 |
| bili_reply | 发表评论 / 回复评论 | 支持楼中楼：rpid 指定楼层，root 指定根评论 |
| bili_like | 点赞 / 取消点赞 | like=false 取消 |
| bili_favorite_lists | 收藏夹列表 | uid=0 表示自己的收藏夹 |
| bili_favorite_content | 收藏夹内容 | 分页 + 夹内关键词搜索 |
| bili_send_message | 发送私信 | 指定接收者 receiver_uid |
| bili_unread_messages | 未读消息数 | 私信 / @ / 回复 / 点赞分类计数 |
| bili_received_replies | 收到的回复 | 最近的评论回复通知 |
| bili_received_at_and_likes | @ 与点赞通知 | 最近的 @ 提及和点赞记录 |

🖥️ DSH 插件「B站分身」

dsh-plugin/ 是 DeepSeek Harness 插件：把上面 29 个工具挂载给 DSH 的智能体，再配一套值班章程，让它按配额自动运营一个小号——刷到 → 看 → 赞 → 评 → 被回复 → 我回，全程可审计。控制台按 DSH UI 规范重做为 7 页：概览 / 实时 / 活动 · 生命周期 / 日报 / 判重表 / 人设工作室 / 设置。

更多界面截图：实时 / 活动生命周期 / 判重表 / 人设工作室 / 日报 / 设置

| 实时（阶段轨 + 事件流） | 活动生命周期 |

| 人设工作室（8 页签） | 设置（DSH 设置卡） |

| 判重表 | 日报 |

截图数据来自真实快照（账本 / 人设卡 / 日报 / seen.md），界面按 DSH 设计规范：960px 页面容器、宿主 --dsw-* token、深浅主题跟随宿主、focus-visible / reduced-motion 齐全。

它多出来的一件事：除了全量 mcp__bili-fenshen__bili_* 工具，还注册两个宿主工具 bili_fenshen_status（状态与配额）、bili_fenshen_run（立刻跑一轮）。值班轮会拉起独立 headless 会话，只暴露最小工具白名单（BILI_MCP_TOOLS），上传、私信这类高权限工具在那一轮里根本不存在。

1) 先把 dsh-plugin/cordis.patch.yml 里的 command / args / cwd 三处路径改成你的项目位置
2) 安装并重启 DSH
dsh plugin --profile desktop add link:<项目路径>/dsh-plugin

装好后：重启 DSH → 左侧栏「B站分身」→ 右上角「重新扫码」→ 手机B站确认 → 点「跑一轮」。

账本（~/.dsh/bili-fenshen/ledger.jsonl）、配置字段与安全边界详见 dsh-plugin/README.md；领域术语（值班轮 / 章程 / 压审 / 活动生命周期）见 CONTEXT.md。

🏗️ 架构

flowchart LR
U["你 / Agent 会话"] -->|自然语言| C["MCP ClientClaude Code · Cursor · Cline · OpenClaw"]
U -->|值班调度| P["dsh-plugindsh-bili-fenshen看板 + 操作台 + 章程"]
C -->|stdio / JSON-RPC| S["mcp_server.pyFastMCP · 29 tools"]
P -->|白名单挂载| S
S --> L["bilibili-api-python"]
L -->|Web API| B[("B站")]
S -.->|只读本机| K["bili_credential.jsonSESSDATA 等，已 gitignore"]

技术栈：MCP（Model Context Protocol） · FastMCP · bilibili-api-python · Python 3.10+；插件侧是纯 ESM 的 Node.js 模块，没有第三方运行时依赖。

💬 自然语言用法

接入之后，不用记工具名，直接说人话：

- 「登录B站」——AI 展示二维码，扫码后自动保存凭证
- 「搜索B站上关于 AI Agent 的热门视频，按播放量排」
- 「把这条视频的字幕拿下来，总结成 5 条要点」
- 「看看这条视频的评论区，大家最在意什么」
- 「帮我回复这条评论，语气友好一点」
- 「批量采集『大模型评测』相关视频的评论和字幕」
- 「发一条B站动态，配这三张图，加个话题」
- 「把这个视频投到科技区，标题叫……」
- 「B站现在什么最火？给我全站和科技区榜单前 10」
- 「分析这个 UP 主的粉丝和投稿数据」
- 「我有多少未读私信和回复？」

涉及本地文件的参数（上传视频、封面、动态配图）请传本机绝对路径——MCP Server 就跑在你的机器上。

🔐 安全与免责

- 凭证不出本机：bili_credential.json 只含 sessdata、bili_jct、buvid3、dedeuserid，已在 .gitignore 中；路径可用 BILI_CRED_FILE 环境变量覆盖。不要提交、分享或上传这个文件，泄露处置见 SECURITY.md。
- 写操作是真实的：评论、点赞、私信、发动态、投稿都会真实作用于你的B站账号，请谨慎使用并遵守B站社区规则。
- 请控制频率：搜索、评论、弹幕等批量操作内置了请求间隔（0.3 / 0.5 / 1 秒），仍建议压低频率，避免触发风控。
- 最小授权：BILI_MCP_TOOLS 可把工具注册限制在白名单内；DSH 插件在值班轮里默认只开最小集，并用 BILI_FENSHEN_HOME 隔离插件数据目录。
- 自动化有风险：无人值守的点赞/评论可能被平台限制，建议只用小号，并自行承担账号风险。
- 本项目仅用于学习与研究，与哔哩哔哩官方无关。

📁 项目结构

BilibiliPlayer/
├── mcp_server.py # MCP Server 主文件（29 个工具，FastMCP / stdio） ├── bili_login.py # 命令行扫码登录（备用入口） ├── requirements.txt # Python 依赖（bilibili-api-python / aiohttp / mcp） ├── CONTEXT.md # 领域术语表：值班轮 / 章程 / 账本 / 活动……
├── docs/
│ ├── INSTALL.md # 完整安装与客户端配置 │ ├── demo/ # 控制台静态预览 + 截图 │ ├── superpowers/ # 控制台设计稿与实施方案 │ └── research/ # 人设与真人评论语料调研笔记 ├── .github/ # CI（Python 语法检查 + 插件单测）与 issue / PR 模板 ├── dsh-plugin/ # DSH 插件「B站分身」 │ ├── index.js # Host 半部：值班调度、路由、轮次生命周期 │ ├── client.js # Client 半部：看板 + 操作台 │ ├── cordis.patch.yml # bundle 挂载声明（MCP + Host 插件） │ ├── lib/ # 纯逻辑模块：账本 / 报告 / 活动 / 配置 / 回复 / 账号 / api 路由 │ ├── prompts/ # 值班章程 + 小号人设 │ ├── locale/ # 中英文案 │ └── test/ # node --test 单测与冒烟脚本 ├── SECURITY.md / CONTRIBUTING.md ├── LICENSE # MIT └── bili_credential.json # 登录后生成（已忽略，勿提交）

❓ 常见问题

提示「未登录B站」？ 调 bili_login 生成二维码 → 手机上确认 → 调 bili_login_check 轮询到 done。凭证会自动复用。

凭证过期了，bili_login 却返回 already_logged_in？ 登录前会先验凭证；若它仍然判断为已登录而你确认失效了，传 bili_login(force=true) 强制重新扫码。

返回 no_session？ 扫码会话只存在于内存，进程重启后就没了。重新调 bili_login 即可。

上传视频报「未找到 ffmpeg」？ 安装 ffmpeg 并加入 PATH，或直接传 cover_path 指定封面。安装方式见 docs/INSTALL.md。

接口空结果或报错？ 先用 bili_check_credential 验登录，再降低频率稍后重试；B站接口会有风控和偶发抖动。

客户端里一个工具都看不到？ 客户端需要支持 stdio 的 MCP Server；确认 command 指向同一个 venv 里的 Python 绝对路径、args 指向 mcp_server.py 绝对路径。可以用 npx @modelcontextprotocol/inspector 单独验证 Server 能否正常启动。

🤝 参与贡献

欢迎 issue 和 PR：新工具、B站接口变化适配、文案与文档都算贡献。动手前请读 CONTRIBUTING.md（开发环境、代码风格、测试命令、提交信息规范）；安全问题请走 SECURITY.md 的私下渠道。

python -m py_compile mcp_server.py bili_login.py # 语法检查
cd dsh-plugin && npm test # 插件单测（node --test）

致谢：数据层源自 adoresever/bilibili-mcp（MIT）；值班轮 / 发后复核 / 环境自愈等模式参考 dsh-bili-scroll（MIT）；B站接口封装来自 bilibili-api-python。

📄 License

MIT —— 可自由使用、修改、分发，请保留版权声明。

用 DeepSeek Harness 构建 · 给智能体一个真实的B站