Bilibili API
约 936 字大约 3 分钟
2026-09-01
Bilibili（哔哩哔哩）是中国广受欢迎的弹幕视频与动画社区。在 Shirone 中，Bilibili 相关的接口主要用于两个场景：
- 番剧追番同步（Anime Sync Provider）：在离线构建期抓取用户在 B 站的追番列表，生成本地快照。
- 视频门面嵌入（Video Embed Facade）：在文章排版中以延迟加载的隐私保护门面形式嵌入 B 站视频播放器。
追番列表同步 API
Shirone 的追番同步脚本（scripts/anime/providers/bilibili.mjs）通过 Bilibili 空间追番接口批量拉取追番数据。
配置方式 src/config/animeConfig.ts
在 src/config/animeConfig.ts 中配置 Bilibili 提供方：
src/config/animeConfig.ts
export const animeConfig = withUserConfig("anime", {
enable: true,
source: {
kind: "snapshot",
provider: "bilibili",
},
providers: {
bilibili: {
enable: true,
vmid: "12345678", // 你的 B 站数字 UID
sessdataEnv: "BILI_SESSDATA", // .env 中的凭据环境变量名
cover: {
mode: "local", // 封面本地下载缓存（推荐）
useWebp: true, // 自动转换为 WebP
},
request: {
pageSize: 30, // 单页大小（10 ~ 50，默认 30）
maxItems: 300, // 最大条目上限
minDelayMs: 300, // 请求间隔延迟（毫秒）
},
},
},
})| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
vmid | string | "" | 用户的 B 站数字 UID（必填） |
sessdataEnv | string | "BILI_SESSDATA" | 读取私密追番凭据的环境变量名称 |
cover.mode | "local" | "remote" | "none" | "local" | 封面策略：local（本地下载缓存，防盗链推荐）、remote（直连远程）、none（不加载封面） |
cover.useWebp | boolean | true | 是否启用 WebP 格式压缩 |
request.pageSize | number | 30 | 分页大小 |
request.minDelayMs | number | 300 | 请求间隔延迟（毫秒） |
接口端点详情
- 端点地址：
GET https://api.bilibili.com/x/space/bangumi/follow/list - 请求头：
User-Agent：合规桌面浏览器 UAReferer：https://space.bilibili.com/Cookie：SESSDATA=${sessdata};（仅当追番列表设为私密且提供了环境变量时携带）
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
type | number | 固定为 1（追番） |
follow_status | number | 追番状态：1 想看 / 2 在看 / 3 看过 |
vmid | string | 目标用户的 UID |
ps | number | 每页数量（最大 50） |
pn | number | 当前页码（从 1 开始） |
接口响应与状态码
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"media_id": 28228367,
"season_id": 34209,
"title": "间谍过家家",
"cover": "http://i0.hdslb.com/bfs/bangumi/image/....jpg",
"total_count": 25,
"progress": "看到第12话",
"rating": {
"score": 9.7
},
"evaluate": "为了潜入名校，西国能力最强的间谍...",
"publish": {
"pub_time": "2022-04-09 23:00:00"
},
"styles": ["搞笑", "日常", "漫画改"]
}
],
"total": 45
}
}code: 0：请求成功code: 53013或-401：追番列表被用户设置为私密，需要提供合法的SESSDATA
封面防盗链与本地化下载
B 站图片服务器（hdslb.com）对外部站点有严格的 Referer 防盗链校验。当 cover.mode: "local" 时，Shirone 同步脚本会在构建机上自动将图片下载到 public/assets/anime/covers/bili_{id}.webp：
- 零破图：所有封面转为站内本地静态资源，不受防盗链限制。
- 体积优化：自动转为轻量 WebP 格式，加快页面首屏加载。
视频嵌入门面（Video Facade）
在 Markdown 文章中插入 B 站视频时，Shirone 使用了轻量门面技术：
::bilibili{bvid="BV1GJ411x7h7" part=1}播放器参数
- 播放器地址：
https://player.bilibili.com/player.html?bvid={bvid}&page={part}&as_wide=1&high_quality=1&danmaku=0 - 按需加载：初始状态仅渲染静态预览卡片与播放按钮（零外部脚本注入、零 Cookie 追踪）；用户点击播放后才动态创建
iframe。
常见问题
追番同步报错code: 53013（权限不足）
你在 B 站的「空间隐私设置」中将追番列表设为了「仅自己可见」。 解决方式：在项目根目录 .env（或 CI 环境变量）中添加 BILI_SESSDATA="你的SESSDATA"。
注意
凭据安全警报SESSDATA 拥有对应 B 站账号的完整会话权限。切勿将含有真实 Cookie 的 .env 文件提交至公开 Git 仓库或客户端前端包中。
同步命令执行方式
pnpm anime:sync --provider bilibili