概览
给一个关键词,或者一批视频链接,它会把 B 站上对应的视频找出来,整理成一张视频表现表:标题、播放量、点赞、投币、收藏、分享、弹幕、评论、时长、分区、发布时间和 UP 主。
做内容运营和选题研究的人,最费时间的往往不是判断,而是把一条条视频页上的播放、点赞、收藏抄进表格。这个应用把这一步变成一次运行:给关键词就按站内搜索排名往下取,给链接就直接按链接取。
怎么填输入
按关键词搜索:采集方式选「关键词搜索」,填一个词(比如 猫咪),再用「最多采集条数」控制要多少条。默认就是这种方式。
按视频链接:采集方式选「视频链接」,然后在「视频链接」框里填一个 JSON 数组,可以直接复制这个改:
["https://www.bilibili.com/video/BV17x411w7KC", "BV1jFUkBPEZA"]
多个地址就照这样用英文逗号隔开、每项加引号。下面这些写法都认:
| 写法 | 例子 |
|---|---|
| 完整链接 | https://www.bilibili.com/video/BV17x411w7KC |
| 手机端链接 | https://m.bilibili.com/video/BV17x411w7KC |
| 纯 BV 号(大小写都行) | BV1jFUkBPEZA、bv1jFUkBPEZA |
| av 号或纯数字 aid | av170001、170001 |
| 短链 | https://b23.tv/BV17x411w7KC |
| 分享文案整段粘贴 | 【某个视频】 https://b23.tv/BV17x411w7KC |
如果运行时提示 start_urls: '...' is not of type 'array',说明这个框被填成了普通文本,按上面的例子补上方括号和引号即可。
注意两件事:什么都不填直接点运行,会按默认值去搜 cat、取 50 条,会真的跑出数据;填「最多采集条数」1000 时实际通常只出 900 多条,原因见下。
数据说明
一条视频一条记录,用「视频 BV 号」去重,同一批输入重复运行不会产生重复行。两种取数方式落的是同一张表,区别只在来源列:「命中关键词」和「搜索名次」只有在按关键词搜索时才有值,按链接采集时前者为空、后者是 -1。
按关键词搜索时,程序会一直往下翻页,直到取够「最多采集条数」为止,而不是取固定几页就收工——站内搜索的相邻页经常出现同一条视频,取固定页数去重后必然短一截。也正因为跳过了重复项,「搜索名次」会出现跳号(比如取 100 条,名次可能排到 119),那是视频在搜索结果里的真实位置,不是漏采。站内搜索最多只能翻到第 50 页,所以填 1000 时通常拿到 900 多条;关键词本身结果不足时也会少于目标,这两种情况日志里都会写明。
播放、点赞、投币、收藏、分享、弹幕、评论都是采集当刻的累计值,会随视频热度实时变化,要对比趋势请隔几天用同样的输入再跑一次,用「采集时间」区分批次。时长统一换算成秒。发布时间和采集时间都是 UTC 时区,直接按北京时间看会差 8 小时。
站内搜索接口本身不返回投币数和分享数,这两列会用视频详情补齐;某条详情没取到时记 -1 表示「未取到」,不要当成 0。同理,点赞、评论等列也沿用这个约定。
「分享数」直接取 B 站详情接口里的原始值,是平台自己的统计口径(疑似把外部转发也算了进去),所以个别视频会出现千万级的数字,那是 B 站返回的原始数据,不是解析出错。如果用它和别的工具做对账,这一列对不上是正常的。
「分区」两种模式都会尽量填:按关键词搜索时直接取站内搜索给的分区名;按链接采集时,上游详情只回分区编号不回名称,程序会用相关推荐里同分区视频的名字反查,绝大多数能补上,极少数(相关推荐里没有同分区视频)为空,这时可以用「视频标签」判断内容类型。同一条视频用 BV 号和 av 号各写一遍只出一条记录。
仅粉丝可见、已删除、已下架以及需要付费解锁的视频取不到数据,会在日志里跳过,不影响同一批里的其他视频。评论区只给数量,不返回评论正文;弹幕也只给条数。
结果长这样
每条记录是一个视频在采集当刻的表现快照。
| 视频标题 | 播放量 | 点赞数 | 收藏数 | 弹幕数 | UP 主昵称 |
|---|---|---|---|---|---|
| 给我家猫咪看的动画 | 1492116 | 11818 | 12902 | 1569 | 猫老大的世界 |
| 【MV】保加利亚妖王AZIS视频合辑 | 45851017 | 943944 | 876717 | 915703 | 冰封.虾子 |
除上表外还有投币数、分享数、评论数、时长、封面图、分区、发布时间、UP 主 ID 与头像、视频地址、命中关键词、搜索名次、标签、分P数量等列。
应用场景
- 选题研究:按关键词搜一批视频,把「播放量」按「分区」分组,看哪类内容在这个话题下更容易起量,再结合「时长」判断是短平快还是长视频更吃香。
- 互动质量评估:算「点赞数」「投币数」「收藏数」与「播放量」的比值,投币和收藏占比高的视频说明内容认可度强,比只看播放量更接近真实口碑。
- 榜单追踪:同一关键词每隔几天跑一次,用「搜索名次」和「播放量」看哪条视频在往上冲,「发布时间」帮你排除老视频的自然累积。
- UP 主表现盘点:按「UP 主昵称」汇总同一批结果,看单个账号在本话题下的产出数量和平均播放水平。
适用边界
只采集 B 站公开视频的展示与互动数据,不含用户隐私、不下载视频文件、不抓取评论正文
- 适合用于
- 要按关键词批量拿一批 B 站视频的播放/点赞/投币等互动数据做内容分析
- 盯某个话题或某个 UP 主的视频表现,需要按时间反复跑同一批关键词做对比
- 手上有一批 B 站链接,要批量转成一张结构化视频表
- 不要用于
- 需要评论正文、弹幕正文或用户画像,本应用只给数量不给内容
- 需要下载视频文件或音频
- 需要私密、仅粉丝可见或已下架视频的数据
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1上游返回 HTTP 412 或 code -412 表示出口 IP 被风控,请换出口 IP 或稍后重试
- 2单个视频被删除或不可见时会跳过并记日志,不影响其他记录
- 3中途被拦时已采集的记录照常保留,运行不会整体失败
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 采集方式
mode必填string(enum)按关键词搜索视频,还是采集指定的视频链接。填 search 时看「搜索关键词」,填 url 时看「视频链接」可选值关键词搜索search视频链接url默认值search - 搜索关键词
query选填string在 B 站站内搜索这个关键词,按综合排序取结果。支持中文、英文、多个词用空格分隔;只在「关键词搜索」方式下生效默认值cat - 视频链接
start_urls选填array<string>要采集的视频地址。必须是 JSON 数组,形如 ["https://www.bilibili.com/video/BV17x411w7KC"];多个地址写成 ["地址1", "地址2"]。支持:完整链接、m.bilibili.com 移动端链接、纯 BV 号(大小写都认)、av 号或纯数字 aid、b23.tv 短链,也可以直接粘 App 分享出来的一整段话;带 ?p= 的分P链接按整条视频采集。若提示「is not of type 'array'」,说明填成了普通文本,请补上方括号和引号。只在「视频链接」方式下生效数量最多 1000 项示例["https://www.bilibili.com/video/BV17x411w7KC"] - 最多采集条数
max_results选填integer关键词搜索方式下最多返回多少条视频,按搜索排名从小到大取。实际产出可能少于这个数:B 站搜索最多只翻到 50 页,且相邻页会重复推同一条视频(重复项已去重),填 1000 通常拿到 900 多条。视频链接方式下按填了几条链接采集,不受这个数字影响范围1–1000默认值50
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 视频 BV 号
bvidstring视频在 B 站的 BV 编号,同一条视频的稳定标识,也用作去重键示例BV1jFUkBPEZA - av 号
aidinteger视频的旧版数字编号 aid,BV 号与之等价示例115603541137064 - 视频标题
titlestring视频标题原文,已去掉搜索结果里的关键词高亮标签示例给我家猫咪看的动画 - 视频简介
descriptionstringUP 主填写的视频简介原文,可能为空
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"bvid": "BV1jFUkBPEZA",
"aid": 115603541137064,
"title": "给我家猫咪看的动画",
"description": "<description>",
"views": 1492116,
"likes": 11818,
"coins": 5123,
"favorites": 12902,
"shares": 8923,
"danmaku": 1569,
"comments": 899,
"duration": 2089,
"thumbnail": "https://i2.hdslb.com/bfs/archive/319020c06956b003db3ec42fd87726cdd270e671.jpg",
"category": "喵星人",
"publish_date": "2025-11-24T10:00:00+00:00",
"author_name": "猫老大的世界",
"author_mid": 385510297,
"author_face": "https://i1.hdslb.com/bfs/face/248296d6c84008ab65fbea71eaf20d560b6a6868.jpg",
"url": "https://www.bilibili.com/video/BV1jFUkBPEZA",
"fetched_at": "2026-11-17T06:37:54.750309+00:00",
"search_keyword": "猫咪",
"search_rank": 1,
"tags": "<tags>",
"part_count": 1
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=slzc81gz/bilibili-video-scraper",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。