bilibili

bili-agent-kit 提供 TypeScript SDK、命令行工具和 MCP 服务，用来读取 B 站视频、字幕、评论和消息，也支持扫码登录和审核后发送回复。可以接入支持 MCP 的 AI 助手，或在自己的程序中调用。

能做什么

• 读取内容：视频信息、搜索结果、官方字幕、评论、可信对象的私信，以及直播房间和近期弹幕。

• 接收私信：保存读取进度，重启后可以继续处理。需要定时检查时，由接入它的程序安排调用。

• 审核后发送：评论发布与删除、私信、直播弹幕。写入默认关闭，须配置目标白名单并由管理员批准草稿。

• 提取画面：可选 ffmpeg 从指定本地视频采样，最多 12 帧；不自动下载视频或安装 ffmpeg。

Related MCP server: bilibili-mcp

快速开始

需要 Node.js 22.18+、24.11+ 或 26+，不支持 Node.js 23/25。

npx --yes @bili-agent-kit/cli@0.1.0 help

创建 config.local.json，供 CLI 和 MCP 共用：

{
  "version": 1,
  "stateDir": "./.bili-agent-kit",
  "credentialsFile": "./credentials.local.json"
}

配置中的路径相对配置文件所在目录解析。写入默认关闭；凭据文件尚不存在时，可以匿名读取公开内容。完整配置示例见 examples/config.json。

读取视频信息：

npx --yes @bili-agent-kit/cli@0.1.0 --config config.local.json video '{"bvid":"BV1xx411c7mD"}'

CLI 只向 stdout 输出 JSON。每个结果都有 version: 1 和 ok；失败时返回错误码并以非零状态退出。支持用 - 从 stdin 读取 JSON。

扫码登录

示例配置已指定 credentialsFile。在你自己控制的终端中运行：

npx --yes @bili-agent-kit/cli@0.1.0 --config config.local.json auth.login '{}'
npx --yes @bili-agent-kit/cli@0.1.0 --config config.local.json auth.status '{}'

二维码和进度显示在 stderr，用哔哩哔哩 App 扫码并在手机确认。需要图片时，将登录参数改为 '{"png":"login-qr.png"}'，路径相对当前工作目录，目标文件必须不存在。二维码最多等待 3 分钟，Ctrl+C 取消；失败保留旧凭据。

凭据以受限权限保存为本地明文 JSON，成功验证后才替换。退出仅删除这个本地文件，不撤销其他设备会话、不删除历史状态。登录不会开启发送权限或解除风控暂停。已有 MCP 进程会在下一次操作时读取同一文件。

需要退出时再运行：

npx --yes @bili-agent-kit/cli@0.1.0 --config config.local.json auth.logout '{}'

接入 MCP

在 AI 助手的 MCP 配置中使用 npm 包，将配置文件路径替换成实际绝对路径。需要登录时，先用上面的 CLI 命令对同一份配置扫码登录：

{
  "mcpServers": {
    "bilibili": {
      "command": "npx",
      "args": ["--yes", "@bili-agent-kit/mcp@0.1.0", "--config", "/absolute/path/config.local.json"]
    }
  }
}

Windows 路径可以使用 D:/bilibili/config.local.json。MCP 提供 14 个工具，不提供批准、策略修改、凭据管理或解除暂停工具。

使用 SDK

在自己的项目中安装 SDK：

npm install @bili-agent-kit/core@0.1.0

使用 ESM 导入，读取公开视频信息：

import { BiliKit, FileStore } from "@bili-agent-kit/core";

const kit = new BiliKit({ store: new FileStore("./.bili-agent-kit") });
const video = await kit.reads.video({ bvid: "BV1xx411c7mD" });
console.log(video.title);

如需复用 CLI/MCP 的配置和登录状态，从同一包导入 loadKit，使用 const kit = await loadKit("./config.local.json")。临时读取可以使用 MemoryStore；发送操作需要保存草稿和执行记录，请使用 FileStore 等持久存储。完整 API 和配置见 使用说明。

审批与数据

发送前先生成并保存草稿，由管理员检查内容和摘要后批准执行。同一次发送不能通过更换内容重复执行；发送结果不明时会停止，需要先核查结果。私信还要求目标在可信名单中，且双方互相关注。

Cookie 由你指定的配置或 SDK 凭据提供器读取，不会自动扫描浏览器。草稿和待处理私信保存在配置的状态目录中，Cookie 单独保存；获取字幕时不会把 Cookie 发给字幕 CDN。

MCP 中的审批限制不能阻止 AI 通过终端执行管理员命令。 接入时，请单独限制 AI 对管理员命令、凭据和状态文件的访问。权限、限流和异常恢复见 安全说明。

开发与验证

从源码开发需要 pnpm 12.15.0：

git clone https://github.com/Cansiny0320/bili-agent-kit.git
cd bili-agent-kit
pnpm install --frozen-lockfile
pnpm check
pnpm test
pnpm build
pnpm smoke

构建后可用 node packages/cli/dist/main.mjs help 调用本地 CLI；读取或登录时仍需显式传入配置文件。

pnpm fmt 会修改格式。测试使用模拟网络；smoke 会打包并安装三个包，检查 SDK、CLI 和 MCP 是否能正常使用。尚未验证真实账号发送消息。直播工具读取近期弹幕记录，不会持续监听；定时调用需要由接入的程序安排。

许可

使用 MIT License，第三方组件说明见 NOTICE。本项目与 Bilibili 官方无关联。

赞助

如果这个项目对你有帮助，欢迎通过微信或支付宝支持后续开发。感谢你的支持！

相关项目

• codex-bili-dragon：在官方 Codex 客户端中运行的 B 站小白龙，按兴趣探索视频、写日记和处理消息。

• dsh-bili-whale-dashboard：给 DSH 原版养鱼插件配套的管理后台，用来查看日记、审核回复和调整人设。