免责声明 / 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)的开放平台业务调用 |
| 开放平台 OAuth2 | api.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_token | secrets/open-platform.json | BILI_CRED_FILE | 全部开放平台接口:bili_api_sign / bili_api_call / bili_upload_plan / bili_scopes / bili_oauth(除 help、status) |
主站 Cookie(SESSDATA / bili_jct 等) | secrets/cookies.json | BILI_COOKIE_FILE | bili_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)以保证可复现:
npm ci11. 第三方内容与支持渠道#
- 本项目可能包含指向第三方网站、文档或项目的链接。作者不对第三方内容的可用性、准确性或合法性负责。
- 本项目不是哔哩哔哩官方支持渠道。请勿就本项目向哔哩哔哩客服或开放平台提工单, 这会浪费双方时间。本项目的 Issue 区是唯一支持渠道,且为尽力而为、无 SLA。
12. 变更与终止#
- 作者可在不事先通知的情况下修改、中断或终止本项目(包括归档仓库、删除内容、更换许可证的未来版本)。
- 本文档(免责声明)可能随时更新,更新后即时生效,不另行通知。
- 你继续使用本项目,即视为接受更新后的条款。
13. 二次分发#
你若复制、修改、再分发本项目的代码:
- 必须保留本免责声明与 LICENSE(MIT)。
- 不得移除或弱化本文件中关于「接口来源为官方公开接口」「不内置凭据」「凭据缺失时功能不可用」的表述。 删掉这些表述后分发,会让下游用户误以为本项目自带可用凭据或提供官方未公开的能力。
- 不得使用「官方」「bilibili 官方」「哔哩哔哩官方」等字样描述你的分发版本, 也不得暗示获得哔哩哔哩或本项目作者的背书。
- 你自己分发版本的行为与后果,由你自己承担。
14. 适用人群#
本项目面向具备基本编程能力、能自行判断接口调用后果的开发者。 未满 18 周岁者请在监护人指导下使用。 本项目不针对未成年人设计,也不收集未成年人信息。
15. 如需下架(Takedown)#
如果你是权利人,认为本仓库的任何内容侵犯了你的合法权益(著作权、商标权、商业秘密等), 请开一个 Issue 说明具体文件与权利依据,或通过仓库所有者邮箱联系。承诺在合理期限内响应并处理。
如果你是使用者,遇到了 bug 或想请求新功能,同样欢迎开 Issue。 提交 Issue 时请务必隐去所有凭据、Cookie、access_token 与个人身份信息。