Bilibili MCP

两个入口，一条证据链

• 从我的收藏夹开始：首次调用无需 Folder ID；Agent 每次读取一个最多 20 条的上游页面，并把返回的 next_cursor 原样用于下一次调用，直到响应不再包含它。

• 从一个主题开始：按关键词返回最多 10 个普通视频候选，不自动抓取候选的字幕或评论。

• 拿到 BVID 之后：继续读取字幕、元数据、章节或热门评论；关键词命中可返回直达播放时刻的 timestamp_url。

Related MCP server: MCP Video Extraction Plus

先让 Agent 帮你接入

Agent 安装提示词、全部客户端配置位置、CLI / JSON / TOML 示例、Cookie 配置与登录验证，都集中在唯一完整入口：

打开 Agent / 客户端安装指南 →

安装完成后，可以直接测试收藏夹遍历：

读取我当前登录账号创建的全部收藏夹。每次拿到 next_cursor 就继续调用，
直到响应不再包含 next_cursor；按收藏夹列出视频标题和 BVID，不要生成笔记。

10 个工具，分成三层

发现入口

search_bilibili_videos · list_bilibili_favorite_videos

从主题或当前账号的全部收藏夹获得 BVID。

内容证据

get_video_transcript · get_video_info · get_video_metadata · get_video_chapters · get_video_comments

读取字幕、时间定位、视频信息、章节和观众反馈。

本机助手

get_credential_setup_instructions · check_bilibili_credentials · check_mcp_update

安全配置凭证、确认登录并检查版本。

完整参数、JSON 示例、结构化错误和请求控制见工具参考。

设计重点

• Bilibili 原生：保留多 P、平台章节、热门评论和收藏夹成员关系，不把项目扩成通用下载器。

• 证据优先：字幕支持语言偏好、时间戳、时间区间与关键词上下文；命中项可以直接打开对应播放时刻。

• 按需调用：收藏夹工具只返回 Folder 上下文和视频条目，不自动生成笔记，也不预取字幕、评论或章节。

• 凭证留在本机：状态工具不会返回 SESSDATA、bili_jct、DedeUserID 或完整 Cookie。

行为边界

• “全部收藏夹”指当前登录账号创建、且 Bilibili API 当前可见的 Folder；遍历是实时 best-effort，不是快照。

• 每次收藏夹调用最多读取一个 20 条上游页面。Agent 必须持续跟随 next_cursor；失效或无法安全规范化的条目会计入 skipped_count。

• 视频搜索和收藏夹发现都要求有效登录凭证，不提供匿名降级。

• get_video_transcript 默认在无字幕时返回 SUBTITLE_UNAVAILABLE；只有显式设置 fallback_to_description: true 才会退回简介，时间定位与关键词搜索不会静默退回简介。

• 章节只使用 Bilibili 创作者或平台数据；项目不会绕过付费、会员、地区、私密、下架或其他访问限制。

• 所有请求由用户本机发起；本项目是第三方工具，不是 Bilibili 官方服务。

开发

源码开发环境的安装步骤也集中在完整安装指南：从源码开发。

MCP stdio 协议使用 stdout；调试日志必须写到 stderr。测试和日志中不要使用真实 Cookie。

安全与许可

• 请遵守 Bilibili 用户协议、接口访问规则和当地法律法规，不要用于大规模抓取、商业剥削、绕过权限或其他滥用场景。

• 高频调用、异常访问模式或 Cookie 泄露可能触发限流、风控或账号异常，相关风险由使用者承担。

• 本项目仅向 Bilibili 官方接口发送 Bilibili 凭证，不会把 Cookie 上传到第三方服务；本地配置文件不承诺系统级加密。

• 本项目基于 GNU General Public License v3.0 开源。

反馈

遇到问题或有功能建议，请提交 GitHub Issue；一般讨论可前往 GitHub Discussions。