🎬 BiliBili_VideoRead_MCP

让 AI 也能看 B 站 把 B 站视频嚼碎了喂给你的 AI：字幕、弹幕、评论、元数据一键萃取，输出结构化 Markdown 供 LLM 消化。

你的 AI 助手（Claude、ChatGPT、Cherry Studio…）不用再对 B 站链接干瞪眼了。丢个 BV 号进去，字幕、弹幕、评论、标题、UP 主、播放量自动到位，AI 读完就能给你总结、提炼、翻译、二次创作——投币的事交给人类，看视频的事交给 AI ⚡

🚫 告别 F12 手抄 Cookie：本项目用 B 站官方扫码登录，终端打码、手机一扫即自动登录；约 30 天过期后重扫一次，全程免维护、无需重启会话。

请给个 ⭐ Star 支持一下，作者会更有动力更新和维护！

🤝 友情链接 / SUPPORT

• 🎯 OpenCode Go — opencode 轻量订阅（$10/月）：
• ☁️ 良心云 — 高性价比稳定机场：

通过邀请码注册，作者能获得返利，维护更新更有动力 🫡

---

✨ 功能介绍

---

🚀 快速开始

1. 安装

pip install -e .
# 或者用 uv：
uv pip install -e .

2. 扫码登录（一次性，10 秒搞定）

python -m videoread_mcp login

终端会打印二维码，手机打开 B 站 App → 右上角扫一扫，几秒后自动保存登录态：

✅ 登录成功：你的昵称（mid=123456）
凭证已保存到 C:\Users\\AppData\Roaming\videoread\auth.json

• 凭证存在你本机的用户目录（Windows: %APPDATA%\videoread\auth.json，Unix: ~/.config/videoread/auth.json），不会写进项目或 .mcp.json
• SESSDATA 约 30 天过期，过期后重新跑一次 login 扫码即可
• 常用命令：python -m videoread_mcp status 查登录态与剩余天数，logout 登出

3. 接入 MCP 客户端

以 Claude / Cherry Studio 为例，无需任何环境变量：

{
  "mcpServers": {
    "videoread": {
      "command": "python",
      "args": ["-m", "videoread_mcp"]
    }
  }
}

💡 本机建议用绝对路径指向项目 venv：C:\...\BiliBili_VideoRead_MCP\.venv\Scripts\python.exe

4. 开用

配置完成 → 重启客户端 → 对话里直接丢链接：

帮我总结下这个视频讲了啥：[https://www.bilibili.com/video/BV1GJ411x7h7] 顺便看看评论区都在说啥

AI 自动调 extract_bilibili_video / extract_bilibili_comments，秒出内容。

---

🛠️ MCP 工具

extract_bilibili_video

返回：视频信息表 + 分 P 列表 + 简介 + 字幕全文。

extract_bilibili_danmaku

返回：[MM:SS] 内容 弹幕列表（完整弹幕，按时间序）。

extract_bilibili_comments

返回：昵称（Lv.X）｜点赞 · 时间 · 回复数｜内容 评论列表。需要登录态。

---

🏗️ 项目结构

BiliBili_VideoRead_MCP/
├── pyproject.toml
├── src/videoread_mcp/
│   ├── __main__.py    # python -m videoread_mcp [login|status|logout|server]
│   ├── server.py      # MCP 工具注册与调度
│   ├── cli.py         # login/status/logout 子命令
│   ├── auth.py        # 扫码登录 + 凭证存取（env 覆盖优先）
│   ├── extractor.py   # 元数据 + 字幕（view → wbi/v2 → subtitle）
│   ├── danmaku.py     # 弹幕（seg.so 分段 + 零依赖 protobuf 解析）
│   ├── comments.py    # 评论（x/v2/reply）
│   ├── wbi.py         # WBI 签名
│   └── formatter.py   # Markdown 格式化
└── tests/             # 纯单元测试，无网络

🔧 技术栈

零 yt-dlp、零 protobuf、零 cryptography — 弹幕用零依赖手写 protobuf wire 解析，登录走 B 站官方 passport 接口，不依赖任何已关停的第三方库。

---

🛡️ 免责声明（叠甲区，认真看）

本项目作者深知"工具无罪、乱用有责"，以下免责声明有多层就叠几层，请逐条阅读：

1. 非官方出品：本项目与哔哩哔哩（B 站）官方没有任何关系，非官方发布，B 站不背书、不负责。所有商标、名称归其各自所有者所有。
2. 仅限个人学习交流：本项目仅供学习 HTTP / MCP / 数据处理等技术的个人学习用途。禁止任何形式的商业用途、牟利行为、大规模批量爬取、攻击或滥用 B 站服务。
3. 法律风险自负：B 站接口及服务条款可能随时变更，且 B 站已对同类逆向项目（如 bilibili-api）采取过法律行动。本项目基于公开接口实现，不保证长期可用，因使用本项目导致的任何纠纷、封号、法律责任均由使用者自行承担。
4. 账号安全：SESSDATA 是 B 站账号的最高权限凭证，本项目仅将其保存在你本机用户目录。严禁公开分享扫码二维码截图、auth.json 或 Cookie 内容，泄露等于把账号交给别人。
5. 内容版权：提取的字幕、弹幕、评论等内容的版权归原作者与 B 站所有，仅限个人阅读学习，请勿转载、二次分发、商用。
6. 稳定性与可用性：本项目按"现状"提供，不提供任何明示或默示的保证。B 站改版、风控、网络环境等因素都可能使其失效；接口失效时按 README 指引重新扫码或自行修复，作者不承诺修复时间。
7. 不构成建议：本项目产出的任何内容均不构成投资、理财、法律或其他专业建议；引用他人内容不代表赞同其观点。
8. 风险自担条款：使用即视为同意以上全部条款。如果你所在地区或你的使用场景不允许此类工具，请立即停止使用并删除本项目。

看视频一时爽，一直看一直爽 🫡

---

📄 License

MIT