19 个 MCP 工具

bili_quickstart

返回哔哩哔哩开放平台的核心约定：主机、OAuth2 换 token/刷新、2.0 签名算法、通用返回结构、错误码分段、视频投稿技术限制。第一次使用或需要写对接代码前先调它。

无参数

bili_docs_list

按目录或类型列出开放平台文档。folder 支持包含匹配（如 "视频稿件"、"直播"、"消息推送"）；type 可选 api / guide / event / protocol / multi-api。返回每条含 ref(#num)、标题、METHOD 路径、所在目录。

bili_docs_search

在 170 篇开放平台文档里搜索接口名、字段名、错误信息、协议细节。先按标题/目录/摘要命中，再回退全文。返回 ref(#num) 可用于 bili_api_spec / bili_docs_get。

bili_docs_get

按 ref（#num / id / 标题 / 文件名 / 接口URL）返回文档完整 Markdown。协议、长连、Webhook 等非接口文档用它。maxChars 默认 40000。

bili_api_spec

返回某个接口的方法、完整 URL、scope、url/body 参数（类型+是否必填+说明）、响应字段、请求与响应样例。这是写调用代码前该看的工具。

bili_api_sign

按开放平台规则生成 Authorization 与 x-bili-* 头，并输出可直接粘贴的 curl。凭据可用参数传入，否则读环境变量 BILI_CLIENT_ID / BILI_APP_SECRET / BILI_ACCESS_TOKEN。body 传对象会自动 JSON 序列化（GET 请忽略）。

bili_api_call

给 ref（#num/标题/URL）或直接 url，自动签名并发起真实请求。query/body 传对象。dryRun=true 时只返回将要发出的请求与 curl，不发送。凭据读 BILI_CLIENT_ID / BILI_APP_SECRET / BILI_ACCESS_TOKEN。

bili_error_lookup

查开放平台错误码含义。支持 4002 / 127007 这种完整码，也支持 4 位前缀模糊（如 1230 列出所有视频稿件码）。

bili_endpoints

按 method / scope / host / 路径关键词过滤端点，返回 #ref、METHOD、PATH、scope。适合「所有需要 SHOP_ORDER_INFO 的 POST 接口」这类问题，比全文搜索更准。默认最多 40 条。source:"web" 时改列开放平台文档里没有的「隐藏能力」（主站 Web，如举报 / 拉黑 / 动态 / 评论 / 直播），source:"all" 两边一起列。默认最多 40 条。

bili_scopes

不带参数：列出全部 scope 及覆盖的端点数。带 scope：列出该 scope 下所有端点。带 ref：返回该接口需要的 scope 及每个 scope 下的其它接口。用于确认应用该申请哪些权限。

bili_api_prepare

把 query/body 按文档类型做转换（int→数字、bool→布尔、[]x→数组），检查必填是否缺失、是否多传了文档没有的字段，并给出最终 URL/body 与签发 curl 的下一步。写代码前用它避免类型错误。

bili_codegen

按接口规格生成可运行代码骨架，含完整 2.0 签名实现、该接口的全部参数（必填直接写入、可选注释掉）、返回码处理。lang 支持 python / node / curl / java / php / go。比手写签名可靠。

bili_upload_plan

给文件大小，算出该用单文件还是分片、分几片、每片范围、part_number 起止，并输出完整调用顺序（init → upload → complete → 提交）与可直接粘的 curl。

bili_oauth

action=help 讲清整条链路；authorize-url 拼出授权页链接；status 看 clientId/secret/token 各自有没有、从哪来；exchange 用 code 换 access_token；refresh 续期（refresh_token 只能用一次）。换到的 token 会自动写入 secrets/open-platform.json。凭据取自参数、BILI_CLIENT_ID/BILI_APP_SECRET 或该文件。

bili_webhook

action=list 列出 41 个推送事件（按模块分组）；action=detail 看某个事件的内容字段；action=verify-code 生成验签 + verify_webhooks 应答代码（python/node）。验签用 SHA1(secret + 原始 body)，必须用原始字节。

bili_ws_protocol

返回直播间 WebSocket 长连协议（建连流程、16 字节包头、Operation 表、zlib 多包解析），可选生成内联 Python 客户端。对应文档 #43–#46。

bili_mock

action=list 列出 43 个 mock 接口（按模块）；action=map 把正式接口换算成 mock 地址（两者路径不总一致）；action=call 真实调用 mock（同样走 2.0 签名，凭据不足时用 dryRun）。

bili_cookie

管理主站 www.bilibili.com 的浏览器 Cookie（与开放平台 client_id/secret 是两套体系）。action=status 列关键 cookie 与过期时间；whoami 验证登录态；import 收下 EditThisCookie 数组 / {name:value} / "k=v; k=v"；set / clear / export。默认脱敏，reveal:true 才显示原值。

bili_web_call

用 Cookie 罐调主站/主 API 的 Web 接口（不是开放平台的那套签名接口）。自动带 Cookie、UA、Referer；POST 若给 form 则按 x-www-form-urlencoded 并自动补 csrf=bili_jct。路径含 /wbi/、/polymer/ 等会自动做 wbi 签名（w_rid+wts），可显式 wbi:true/false 覆盖。dryRun 只看请求。