Skip to content
Back to search

bilibili-mcp

B站 MCP Server - 支持搜索/评论/字幕/弹幕/回复

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/adoresever--bilibili-mcp/badge.svg)](/listings/adoresever--bilibili-mcp)

HTML

<a href="/listings/adoresever--bilibili-mcp"><img src="/api/listings/adoresever--bilibili-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 176 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # bilibili-mcp
  2. B站(Bilibili)MCP Server —— 让 AI 助手直接操作B站。
  3. 支持 OpenClaw / Claude Code / Cursor / Cline 等所有 MCP 客户端。
  4. **27 个工具**,覆盖登录认证、搜索采集、内容发布、数据分析、互动运营。
  5. ## 功能
  6. ### 登录认证
  7. | Tool | 功能 | 说明 |
  8. |------|------|------|
  9. | `bili_login` | 扫码登录 | 生成二维码(base64图片),AI直接展示给用户扫码 |
  10. | `bili_login_check` | 登录状态检查 | 轮询扫码状态,扫码成功后自动保存凭证 |
  11. | `bili_check_credential` | 凭证验证 | 检查当前登录是否有效,返回用户名等信息 |
  12. ### 数据采集
  13. | Tool | 功能 | 说明 |
  14. |------|------|------|
  15. | `bili_search` | 搜索视频 | 按关键词搜索,支持按播放量/最新/弹幕排序 |
  16. | `bili_comments` | 获取评论 | 获取视频热门评论,含子评论 |
  17. | `bili_subtitle` | 获取字幕 | 获取视频AI字幕(语音转文字) |
  18. | `bili_danmaku` | 获取弹幕 | 获取视频弹幕列表 |
  19. | `bili_video_info` | 视频详情 | 获取播放量、评论数、收藏数等 |
  20. | `bili_reply` | 回复评论 | 发表评论或回复评论(支持楼中楼) |
  21. | `bili_crawl` | 批量采集 | 搜索+评论+字幕一步到位 |
  22. ### 内容发布
  23. | Tool | 功能 | 说明 |
  24. |------|------|------|
  25. | `bili_send_dynamic` | 发图文动态 | 发布文字/图文动态,支持定时发布、话题关联 |
  26. | `bili_upload_video` | 上传视频 | 单P视频上传,支持封面、标签、分区选择 |
  27. | `bili_upload_video_multi` | 多P上传 | 多分P视频合并投稿 |
  28. | `bili_send_opus` | 图文专栏 | 发布图文长内容(Opus) |
  29. | `bili_video_zones` | 分区查询 | 获取常用分区ID,辅助视频上传 |
  30. ### 数据分析
  31. | Tool | 功能 | 说明 |
  32. |------|------|------|
  33. | `bili_hot_videos` | 热门视频 | 获取当前B站热门视频列表 |
  34. | `bili_hot_buzzwords` | 热搜关键词 | 获取B站热搜词/热门话题 |
  35. | `bili_weekly_hot` | 每周必看 | 获取每周必看推荐视频 |
  36. | `bili_rank` | 排行榜 | 全站及17个分区排行榜 |
  37. | `bili_user_info` | 用户信息 | 获取UP主粉丝数、等级、总播放量等 |
  38. | `bili_user_videos` | 用户视频 | 获取UP主投稿列表,支持排序和搜索 |
  39. ### 互动运营
  40. | Tool | 功能 | 说明 |
  41. |------|------|------|
  42. | `bili_favorite_lists` | 收藏夹列表 | 获取自己或他人的收藏夹 |
  43. | `bili_favorite_content` | 收藏夹内容 | 获取收藏夹内视频,支持搜索 |
  44. | `bili_send_message` | 发私信 | 给指定用户发送文字私信 |
  45. | `bili_unread_messages` | 未读消息 | 获取私信、@、回复、点赞等未读数 |
  46. | `bili_received_replies` | 收到的回复 | 获取评论回复通知 |
  47. | `bili_received_at_and_likes` | @和点赞 | 获取@提及和点赞通知 |
  48. ## 快速开始
  49. ### 1. 克隆项目
  50. ```bash
  51. git clone https://github.com/adoresever/bilibili-mcp.git
  52. cd bilibili-mcp
  53. ```
  54. ### 2. 安装依赖
  55. ```bash
  56. pip install -r requirements.txt
  57. ```
  58. 需要 Python 3.10+,视频上传自动截取封面需要 ffmpeg。
  59. ### 3. 登录
  60. **方式一:通过 AI 工具登录(推荐)**
  61. 接入 MCP 后,直接对 AI 说"登录B站",AI 会调用 `bili_login` 生成二维码展示给你扫码,全程无需终端操作。
  62. **方式二:命令行登录**
  63. ```bash
  64. python bili_login.py
  65. ```
  66. ### 4. 测试运行
  67. ```bash
  68. npx @modelcontextprotocol/inspector python mcp_server.py
  69. ```
  70. ## 接入 AI 工具
  71. ### OpenClaw
  72. ```bash
  73. npm i -g mcporter
  74. npx mcporter config add bilibili-mcp "python /path/to/bilibili-mcp/mcp_server.py"
  75. ```
  76. 或直接把 GitHub 链接粘贴到 OpenClaw 对话框,让它自动配置。
  77. ### Claude Code
  78. 在项目目录创建 `.mcp.json`:
  79. ```json
  80. {
  81. "mcpServers": {
  82. "bilibili-mcp": {
  83. "command": "python",
  84. "args": ["/path/to/bilibili-mcp/mcp_server.py"]
  85. }
  86. }
  87. }
  88. ```
  89. ### Cursor / Cline
  90. 在设置中添加 MCP Server,command 填 `python`,args 填 `mcp_server.py` 的完整路径。
  91. ## 使用示例
  92. 接入后,你可以直接用自然语言让 AI 操作:
  93. - "登录B站"(AI会展示二维码给你扫)
  94. - "搜索B站上关于AI Agent的热门视频"
  95. - "获取这个视频的评论,分析用户需求"
  96. - "获取视频字幕,总结视频内容"
  97. - "帮我回复这条评论"
  98. - "批量采集OpenClaw相关视频的评论和字幕"
  99. - "帮我发一条B站动态,配上这几张图片"
  100. - "把这个视频上传到B站科技区"
  101. - "看看B站现在什么最火"
  102. - "获取科技区排行榜前10的视频"
  103. - "分析这个UP主的粉丝和投稿数据"
  104. - "我有多少未读私信和回复?"
  105. - "看看我的收藏夹里有什么"
  106. ## 技术栈
  107. - **[bilibili-api-python](https://github.com/Nemo2011/bilibili-api)** — B站 API 封装库,提供搜索、评论、字幕、弹幕等全部接口
  108. - **[MCP (Model Context Protocol)](https://modelcontextprotocol.io/)** — Anthropic 提出的开放协议,标准化 AI 与工具的交互
  109. - **[FastMCP](https://github.com/modelcontextprotocol/python-sdk)** — MCP Python SDK,快速构建 MCP Server
  110. ## 项目结构
  111. ```
  112. bilibili-mcp/
  113. ├── mcp_server.py # MCP Server 主文件(27个tool)
  114. ├── bili_login.py # 命令行扫码登录(备用)
  115. ├── bili_credential.json # 登录凭证(自动生成,勿提交)
  116. ├── requirements.txt # Python 依赖
  117. ├── README.md # 项目说明
  118. ├── LICENSE # MIT 开源协议
  119. └── .gitignore # Git 忽略文件
  120. ```
  121. ## 注意事项
  122. - 首次使用通过 AI 对话即可完成登录,无需终端操作
  123. - 凭证保存在本地,不会上传
  124. - 请求间隔自动控制,避免频率过快
  125. - 回复评论/发私信功能请谨慎使用,遵守B站社区规则
  126. - 视频上传未指定封面时,自动从视频第3秒截取(需要ffmpeg)
  127. - 本项目仅用于学习和研究
  128. ## License
  129. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.