XZXZZX-Ai/bilibili-mcp

Bilibili MCP 是一个本地 MCP server，让 AI Agent 读取 Bilibili 内容。你可以读取字幕与评论、按主题搜索视频、按名称或关键词查找并了解 UP 主，也可以遍历自己账号的收藏夹。即使视频没有字幕，通过 setup 安装本地 ASR 模型后也能读到它的文字内容。
English ·
客户端配置指南 ·
工具参考 ·
本地 ASR（可选） ·
更新日志 ·
最新 Release
搜索候选 → 本地 MCP → 字幕定位 · 章节 · 评论 · 收藏夹
它能做什么
- **读字幕与评论**：读取字幕全文，或用关键词搜索原话——每条命中附带上下文、时间点和可直接跳转的 B 站时刻链接；阅读按热度（默认）或时间排序的评论与回复。热门模式优先保留含视频时间点的评论；时间模式保留最新主评论的上游顺序。
- **读单个视频**：查看标题、作者、播放量等元数据，以及分 P 结构和章节。
- **找到视频**：按主题搜索 B 站，得到按平台综合排序、带标题、UP 主、时长和 BVID 的候选列表。
- **找到 UP 主**：搜索 UP 主候选，确认你真正想了解的账号。
- **了解一个 UP 主**：查看他的主页概况、视频、合集、系列与动态，快速了解主要创作方向。
- **浏览收藏夹**：遍历当前登录账号创建、且 Bilibili 当前可见的全部收藏夹，逐页读取其中的视频。
- **无字幕时本地转录**：对确认没有字幕的视频，可显式选择用本机 ASR（faster-whisper）转录，得到与字幕相同结构的转录结果。默认关闭，可在 setup 时选择下载 ASR 模型，详见本地 ASR（可选）。
快速开始
让 Agent 辅助安装（推荐）
把以下提示词完整复制给 Agent：它会完成自己擅长的事（确认客户端、写入 server 配置、检查登录状态），所有涉及 Cookie 的环节都会暂停，交由你本人在本地终端完成。
手动安装
**前置条件：**Node.js 20+
不想用 Agent 辅助时，按下面四步完成同样的流程：
1. **确认环境** — 在终端运行 node --version 和 npx --version，确保 Node.js 为 v20 或更高版本。
2. **添加服务** — 在 MCP 客户端中新增 stdio server：command 设为 npx，args 设为 -y, @xzxzzx/bilibili-mcp@latest。具体操作见客户端配置指南。
3. **本地配置** — 在终端运行 npx -y @xzxzzx/bilibili-mcp@latest setup 配置凭证，再运行 npx -y @xzxzzx/bilibili-mcp@latest check 确认凭证已加载。npx -y @xzxzzx/bilibili-mcp@latest doctor --json 可获取不含秘密的本机配置状态。
输入不回显，Cookie 只进入本地隐藏提示符，不要粘贴到 Agent 聊天或客户端配置里。凭证字段怎么找：见从浏览器获取凭证字段。setup 还会询问是否安装可选的本地 ASR 模型（默认否），见本地 ASR（可选）。
4. **验证登录** — 重连客户端后，让 Agent 调用 MCP 工具 check_bilibili_credentials 确认 configured: true 且 logged_in: true。doctor --json 只检查本机状态，不能代替这一步的实时登录验证。验证成功后，再让 Agent 调用一次 search_bilibili_videos（任选主题），能返回视频列表即安装完成。
凭证保存在 ~/.bilibili-mcp/config.json（Windows：%USERPROFILE%\.bilibili-mcp\config.json），不保证操作系统级加密。登录失败时的排查路径见客户端配置指南。
扫码登录（推荐）
运行 setup 后，按回车选择扫码登录，用手机 **B站 App** 扫描终端里的二维码，再在手机上确认即可。无需从浏览器复制 Cookie，更简单方便。
**无法扫码？** 在登录方式菜单选择“手动 Cookie”，按照手动 Cookie 配置教程获取凭证并在本地终端输入。
使用示例
读取视频的字幕与评论
Agent 返回带时间戳的字幕文本，以及热门评论与回复；含时间戳的评论会被优先保留。
按主题搜索视频
Agent 返回 5 个候选，各带标题、UP 主、时长和 BVID。选中候选后，把 BVID 直接交给转录、元数据、章节或评论工具。
快速了解一个 UP 主
Agent 会先让你确认正确的 UP 主，再分批读取不同类型的内容。需要查看更多时，它会继续翻页；选中的视频还可以交给字幕、元数据、章节或评论工具深入查看。
在转录中定位原话和时刻
每条命中附带原文上下文、时间点和可直达的 B 站时刻链接。
> [!NOTE]
> **已验证的验收链路：**搜索视频 → 选择 BV1Eb411u7Fw 的 P4 → 在字幕中搜索 函数 → 返回上下文与可直达的 ?p=4&t=1.12 证据链接。Bilibili 可能移除或变更该示例视频。
遍历全部收藏夹
每次 MCP 调用最多读取一个 20 条的上游页面；Agent 使用返回的 next_cursor 继续调用，直到该字段不再出现。最终按收藏夹输出成功读取的标题与 BVID 列表，以及被跳过的条目计数。
给没有字幕的视频做本地转录
前提是已经通过 setup 安装了模型且 doctor --json 报告 asr.status: ready，否则会返回 ASR_NOT_READY 并附带安装指引。原生字幕始终优先：只有确认没有可用字幕时才会启动一次本地转录，结果返回 data_source: "asr"，并复用与字幕相同的时间戳、区间过滤、关键词搜索和时刻链接。详见本地 ASR。
AI 识别字幕（ai-*）与人工字幕的区分
Bilibili 会把部分视频的 AI 识别字幕标为 ai-zh、ai-en、ai-ja 等 ai-* 语言。为避免与人工字幕混淆，选中任意 ai-* 字幕时，get_video_transcript 与 get_video_info 的结果返回 data_source: "ai_subtitle"（不是 "subtitle"；本地 ASR 仍是 "asr"）。
- ai_subtitle 是 Bilibili 的 AI 转录，可能不准确，不能当作人工校验过的引用。
- exclude_ai_subtitles: true（两个工具都有，默认 false）：过滤全部 AI 字幕（ai-zh、ai-en 等），优先返回剩余的人工字幕；仅剩 AI 字幕时视为无字幕，get_video_transcript 可配合 fallback_to_asr / fallback_to_description，get_video_info 返回简介。
- force_asr: true（仅 get_video_transcript，默认 false）：绕过字幕元数据与内容选择，直接用本地 ASR 转录当前这一 P；无需同时开启 fallback_to_asr，且优先于 exclude_ai_subtitles。
- 每个选中的 ai-* 都会无条件双读并做确定性完整性评估，通过后才返回正文：跨读取稳定性（两次读取的正文不一致即不可用，适用于所有 ai-*）、语言（仅针对 ai-zh：≥80 Unicode 字母且 Han 占比 <10% 视为不匹配；其他 ai-* 语言不因非中文正文被拒绝）；不通过时 fallback_to_asr: true 调用本地 ASR，否则遵循 fallback_to_description；video-info 返回简介且不缓存。同语言但语义不符（稳定却离题的正文）是已接受的限制，可用 force_asr 或 exclude_ai_subtitles 控制；人工字幕保持单读，第二次读取的传输、超时、认证或解析失败照常作为错误返回。