NcatBot 文档

外观

Bilibili 平台 API 使用指南

约 517 字大约 2 分钟

2026-03-19

Bilibili 平台（B 站适配器）的完整 API 使用教程 — 直播间操作、私信、评论与数据源管理。

Quick Reference

访问方式

方式类型场景
self.api.bilibiliIBiliAPIClient插件中
bot.api.bilibiliIBiliAPIClient非插件模式
event.reply()—通用回复（弹幕/评论回复）

API 功能分类

类别典型方法说明
直播间操作send_danmu, ban_user, set_room_silent弹幕、禁言、房间管理
私信send_private_msg, send_private_image私信文字与图片
评论send_comment, reply_comment, delete_comment视频/动态评论操作
数据源管理add_live_room, add_comment_watch监听直播间/评论
用户查询get_user_info获取用户信息

快速示例

from ncatbot.plugin import NcatBotPlugin
from ncatbot.core import registrar

class BiliPlugin(NcatBotPlugin):
    name = "bili_demo"
    version = "1.0.0"

    async def on_enable(self):
        # 添加直播间监听
        await self.api.bilibili.add_live_room(12345)

    @registrar.on_message(platform="bilibili")
    async def on_msg(self, event):
        await event.reply(text="收到弹幕！")

认证方式

方式 1：扫码登录（推荐）

将 bilibili 适配器的 sessdata / bili_jct 留空，启动 Bot 时会自动在终端显示二维码：

adapters:
  - type: bilibili
    platform: bilibili
    enabled: true
    config:
      sessdata: ""         # 留空即可触发扫码
      bili_jct: ""
      live_rooms: [12345]

启动后终端会打印 ASCII 二维码，同时保存 PNG 到临时目录（路径会打印在终端）。使用 Bilibili APP 扫码确认后，凭据自动写入 config.yaml，下次启动不再需要扫码。

凭据过期后再次启动会自动检测并重新触发扫码流程。

从浏览器 DevTools → Application → Cookies → bilibili.com 获取以下字段并填入 config.yaml：

config:
  sessdata: "从浏览器获取"
  bili_jct: "从浏览器获取"
  buvid3: "可选"
  dedeuserid: "可选"

本目录索引

文档内容
直播间操作弹幕发送、用户禁言、全员禁言、房间信息
私信操作发送私信文字/图片、获取私信历史
评论操作发送/回复/删除/点赞评论
数据源与查询直播间/评论监听管理、用户信息查询

返回：Bot API 使用指南 · 相关：Bilibili 消息发送 · Bilibili API 参考 · 示例：examples/bilibili/

版权归属：huan-yp

许可证：署名 4.0 国际 (CC-BY-4.0)

© 2025 NcatBot