Bbili-open-mcpMCP
★

免责声明 / Disclaimer#

简体中文为主,关键条款附英文小标题。使用、复制、分发或修改本项目,即视为你已阅读并接受以下全部条款。 详尽的操作说明见 USAGE.md;面向 AI 的契约见 AGENTS.md。


1. 接口来源:全部为哔哩哔哩官方提供#

本项目调用的所有接口均为哔哩哔哩官方提供并公开的接口,不存在私有接口、破解接口或绕过鉴权的接口。具体来源:

来源地址本项目用它做什么
哔哩哔哩开放平台文档https://open.bilibili.com/doc/4、https://openhome.bilibili.com/doc/4/data/*.json 里的 170 篇文档 / 100 个端点规格,全部由 scripts/build-spec.mjs 从官方文档抓取生成
开放平台业务域名member.bilibili.com带 2.0 签名(HMAC-SHA256)的开放平台业务调用
开放平台 OAuth2api.bilibili.com/x/account-oauth2/v1/*code 换 token、refresh_token 续期
开放平台上传域名openupos.bilivideo.com视频分片上传
主站 Web 接口*.bilibili.com(api.bilibili.com、www.bilibili.com 等)以使用者自己的浏览器 Cookie 身份调用官方 Web 接口
直播长连官方直播间 WebSocket 协议(文档 #43–#46)bili_ws_protocol / examples/live_ws.py
消息推送官方 Webhook 推送规范bili_webhook / 验签实现

data/status-codes.json(118 个错误码)、data/mock.json(43 个沙盒 mock 接口)同样来自官方发布内容。

本项目只做「按官方规则把请求拼好、把响应读回来」这件事:不实现任何未公开的加密、 不伪造凭证、不破解客户端、不绕过验证码、不做风控对抗。请求头、签名算法、参数表都来自上述公开文档 与官方前端代码。


2. 与哔哩哔哩无关(Not affiliated with bilibili)#

本项目是第三方工具,与哔哩哔哩(上海幻电信息科技有限公司 / 上海宽娱数码科技有限公司) 没有隶属、赞助、合作或背书关系,未被哔哩哔哩审核或认可。

「哔哩哔哩」「bilibili」「小电视」及相关图形、名称为其各自权利人的商标或注册商标。 本项目对这些名称的使用仅为描述性指代(说明本工具对接的是哪家平台的公开接口), 不主张任何权利,也不意味着任何形式的授权。

本项目的代码以 MIT License 授权;该授权仅覆盖本项目自身的代码, 不覆盖哔哩哔哩的任何接口、文档、数据、商标或其他知识产权。


3. 凭据由使用者自备,缺失时功能受限#

本项目不内置、不收集、不上传任何凭据。两套凭据都由使用者自己放进本地文件:

凭据文件覆盖变量没有它 → 用不了
开放平台 client_id / app_secret / access_tokensecrets/open-platform.jsonBILI_CRED_FILE全部开放平台接口:bili_api_sign / bili_api_call / bili_upload_plan / bili_scopes / bili_oauth(除 help、status)
主站 Cookie(SESSDATA / bili_jct 等)secrets/cookies.jsonBILI_COOKIE_FILEbili_cookie / bili_web_call:登录态体检、导航栏、关系、黑名单、举报、投稿查询等一切主站 Web 调用

没有 BILI_COOKIE_FILE 和 BILI_CRED_FILE,上述功能一律不可用。 此时仍然可用的只有纯本地的部分:

  • bili_docs_search / bili_docs_list / bili_docs_get —— 检索本地已有的 170 篇文档规格
  • bili_quickstart / bili_error_lookup / bili_status_codes / bili_ws_protocol / bili_webhook / bili_scopes —— 本地知识查询
  • bili_codegen —— 生成调用代码(不发送请求)
  • bili_mock —— 打官方沙盒 mock(不需要任何凭据)
  • bili_oauth {action:"help"|"status"} —— 只看说明与凭据体检
  • bili_api_sign / bili_api_call {dryRun:true} —— 只演示签名结构与将要发出的请求

拿凭据的方式:

  • 开放平台:登录 https://open.bilibili.com → 实名认证 + 开发者入驻 → 应用管理 → 创建应用 → 拿 Client ID / Secret,再跑 npm run login 换 access_token
  • 主站 Cookie:浏览器登录 bilibili.com 后导出,再 bili_cookie {action:"import"}

两个文件所在目录已在 .gitignore 中排除,不要把 secrets/ 提交到任何仓库。


4. 账号安全与凭据泄露#

  • SESSDATA 等同于账号登录凭证。泄露它基本等于交出账号。 app_secret、access_token、refresh_token 同理。
  • 本项目默认对所有凭据做脱敏输出(SESSDATA 显示为 abcdef…wxyz [len=124]), 只有显式传 reveal:true 才输出原值。不要随手开这个开关。
  • 请勿在聊天记录、Issue、截图、录屏、日志、CI 日志中粘贴真实凭据。 本仓库的 Issue 区是公开的。
  • 凭据文件以明文存放在本地。请自行确保磁盘加密、文件权限与备份安全。
  • 若不慎泄露:立刻在哔哩哔哩账号安全设置里退出所有设备并改密码, 开放平台凭据则在控制台重置 Secret / 撤销授权。本项目作者无法代你处理。

5. 使用者责任(User Responsibility)#

  • 使用者应遵守哔哩哔哩用户协议、 社区公约、 开放平台开发者协议、相关接口文档中的调用约束,以及所在地法律法规。
  • 请自行控制请求频率。 官方明确将「短时间内大量操作 API」列为滥用行为。 滥用会导致调用者自己的账号被限流、取消权限或封停 (常见返回 -352 / -509 / 12019)。本工具不做自动限速,节流责任在调用方。
  • 本项目提供的接口调用能力,可用于读取你自己的数据、管理你自己的账号、以你自己的身份提交内容。 用这些接口做什么,责任完全在使用者,与作者无关。
  • 不得将本项目用于:批量注册/养号、刷量刷赞刷播放、爬取他人隐私数据、恶意举报骚扰、 发布违法或侵权内容、规避平台风控、或其他违反平台协议与法律的行为。
  • 你若通过本项目接入第三方 AI 服务(Claude / Cursor / 各类 Agent), 你输入工具的内容可能被该第三方服务接收。是否发送凭据、发送哪些数据,由你判断并承担后果。 本项目的凭据默认只从环境变量与本地文件读取,不会主动外发(见第 9 条)。

6. 无担保(No Warranty)#

本项目按「现状」(AS IS)提供,不附带任何明示或暗示的担保,包括但不限于 适销性、特定用途适用性、不侵权、无错误、不中断的担保。

哔哩哔哩的接口、文档、鉴权方式、风控策略随时可能变更、下线或收紧, 本项目不做兼容性承诺,也不承诺及时跟进。

在无担保的最大范围内,作者与贡献者不对因使用或无法使用本项目而造成的任何 直接、间接、附带、特殊、惩罚性或后果性损失承担责任,包括但不限于: 数据丢失、账号限流或封停、内容被删除、业务中断、收益损失、第三方索赔。


7. 数据准确性不保证#

data/ 下的文档规格、参数表、错误码、mock 地址是某一时点从官方文档抓取的快照, 可能存在:抓取遗漏、解析偏差、官方文档自身笔误、以及抓取之后官方已更新。

一切以官方文档与实际接口返回为准。 本项目的结构化数据是检索与生成代码的辅助, 不构成接口规格的权威来源。发现不一致请以官方为准,并欢迎提 Issue。

工具生成的内容(bili_codegen 的代码、bili_upload_plan 的分片表、 bili_webhook 的验签代码等)是骨架,不是可直接上生产的交付物: 其中有 TODO 与占位值,边界条件、错误处理、重试、幂等、并发安全都需要你自己补齐并测试。


8. 不构成法律、合规或安全建议#

本项目及其文档中的任何内容(包括关于频率控制、数据获取范围、凭据处理的表述) 不构成法律意见、合规意见或安全审计结论。

接口能调用 ≠ 你的使用方式合法合规。数据抓取范围、用户授权、个人信息处理、 内容合规、商业化用途等问题,请咨询你自己的法律与合规顾问。


9. 隐私与数据(Privacy)#

  • 本项目是本地 MCP 服务,只在你的机器上运行。它不含任何遥测、埋点、统计上报或自动更新机制。
  • 除了你主动触发的哔哩哔哩官方接口调用,本服务不会向你未指定的第三方地址发送任何数据。
  • 你的凭据、Cookie、以及接口返回的数据只存在于本地(内存与 secrets/ 目录)。
  • 但请注意:当你通过 AI 客户端使用本服务时,你发给 AI 的内容与工具返回值会经过该客户端与模型提供方。 这不属于本项目的控制范围。
  • 接口返回的个人信息(昵称、uid、头像、私信等):请仅用于合法目的,勿留存、勿二次分发。

10. 第三方依赖与供应链#

本项目依赖 @modelcontextprotocol/sdk 与 zod(见 package.json)。 这些依赖各有其作者与许可证,不在本项目作者的控制范围内。 依赖的安全性与许可证合规性由使用者自行评估。

建议安装时使用 lockfile(仓库内已提供 package-lock.json)以保证可复现:

bash
npm ci

11. 第三方内容与支持渠道#

  • 本项目可能包含指向第三方网站、文档或项目的链接。作者不对第三方内容的可用性、准确性或合法性负责。
  • 本项目不是哔哩哔哩官方支持渠道。请勿就本项目向哔哩哔哩客服或开放平台提工单, 这会浪费双方时间。本项目的 Issue 区是唯一支持渠道,且为尽力而为、无 SLA。

12. 变更与终止#

  • 作者可在不事先通知的情况下修改、中断或终止本项目(包括归档仓库、删除内容、更换许可证的未来版本)。
  • 本文档(免责声明)可能随时更新,更新后即时生效,不另行通知。
  • 你继续使用本项目,即视为接受更新后的条款。

13. 二次分发#

你若复制、修改、再分发本项目的代码:

  • 必须保留本免责声明与 LICENSE(MIT)。
  • 不得移除或弱化本文件中关于「接口来源为官方公开接口」「不内置凭据」「凭据缺失时功能不可用」的表述。 删掉这些表述后分发,会让下游用户误以为本项目自带可用凭据或提供官方未公开的能力。
  • 不得使用「官方」「bilibili 官方」「哔哩哔哩官方」等字样描述你的分发版本, 也不得暗示获得哔哩哔哩或本项目作者的背书。
  • 你自己分发版本的行为与后果,由你自己承担。

14. 适用人群#

本项目面向具备基本编程能力、能自行判断接口调用后果的开发者。 未满 18 周岁者请在监护人指导下使用。 本项目不针对未成年人设计,也不收集未成年人信息。


15. 如需下架(Takedown)#

如果你是权利人,认为本仓库的任何内容侵犯了你的合法权益(著作权、商标权、商业秘密等), 请开一个 Issue 说明具体文件与权利依据,或通过仓库所有者邮箱联系。承诺在合理期限内响应并处理。

如果你是使用者,遇到了 bug 或想请求新功能,同样欢迎开 Issue。 提交 Issue 时请务必隐去所有凭据、Cookie、access_token 与个人身份信息。


完整操作说明:USAGE.md · 面向 AI 的契约:AGENTS.md
📄
这是 DISCLAIMER.md 的站点渲染版,原文在仓库根目录;在 GitHub 上查看 Markdown 源码。