DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Yaemikoreal /

Yaemikoreal/BilibiliPlayer

Topic repository only

Bilibili MCP Server (28 tools) + DSH plugin「B站分身」— let AI agents actually use Bilibili: search, subtitles, comments, likes, dynamics. Local-first, credentials stay on your machine.

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@f6abb5c0

BilibiliPlayer — 让 AI 直接操作B站

BilibiliPlayer | 让 AI 直接操作B站

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

Python 3.10+ MCP 29 tools CI
DSH plugin MIT PRs welcome

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

⚡ 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) — 搜索、评论、字幕、弹幕、详情、批采
Tool 作用 要点
bili_search 搜索视频 order:综合 / 播放量 / 最新 / 弹幕,最多 50 条
bili_comments 获取热门评论 按点赞排序、含子评论,最多 100 条
bili_subtitle 获取 AI 字幕 语音转文字全文,适合让模型总结视频
bili_danmaku 获取弹幕 最多 1000 条,按时间顺序分页取
bili_video_info 视频详情 播放量、评论数、收藏数、标签等
bili_crawl 批量采集 搜索 + 每个视频的评论 + 字幕,一次调用拿全
📤 内容发布(5) — 动态、图文、投稿
Tool 作用 要点
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 主
Tool 作用 要点
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) — 评论、点赞、收藏夹、私信、通知
Tool 作用 要点
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 的 Agent,再配一套值班章程,让它按配额自动运营一个小号——刷到 → 看 → 赞 → 评 → 被回复 → 我回,全程可审计。控制台按 DSH UI 规范重做为 7 页:概览 / 实时 / 活动 · 生命周期 / 日报 / 判重表 / 人设工作室 / 设置。

B站分身控制台 v3:概览(值班/账号/配额/存在感/最近活动/人设/本地检查)

更多界面截图:实时 / 活动生命周期 / 判重表 / 人设工作室 / 日报 / 设置
实时(阶段轨 + 事件流) 活动生命周期
实时页:4 阶段轨、工具/配额统计、按类别筛选的事件流 活动页:按视频/时间线、类型筛选、生命周期卡
人设工作室(8 页签) 设置(DSH 设置卡)
人设工作室:卡片/编译预览/质量/语料库/见闻库/状态/版本/沙盒 设置:宿主设置卡、stacked 字段、显式保存条
判重表 日报
判重表:39 条视频、18 条值班备注折叠 日报:列表 + Markdown 渲染

截图数据来自真实快照(账本 / 人设卡 / 日报 / 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 Client<br/>Claude Code · Cursor · Cline · OpenClaw"]
    U -->|值班调度| P["dsh-plugin<br/>dsh-bili-fenshen<br/>看板 + 操作台 + 章程"]
    C -->|stdio / JSON-RPC| S["mcp_server.py<br/>FastMCP · 29 tools"]
    P -->|白名单挂载| S
    S --> L["bilibili-api-python"]
    L -->|Web API| B[("B站")]
    S -.->|只读本机| K["bili_credential.json<br/>SESSDATA 等,已 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 构建 · 给 Agent 一个真实的B站

—/ 5

No ratings yet

Manifest verification required

Commit f6abb5c0ef91

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout