/install bilibili-search
Bilibili(B站)数据查询
查询B站视频、UP主、热榜数据。无需 API Key,即装即用,大陆直连可用。
用法
python3 skills/bilibili/scripts/bilibili.py '\x3CJSON>'
功能一览
1. 搜索视频 search
python3 scripts/bilibili.py '{"action":"search","query":"AI大模型","count":10,"order":"totalrank"}'
参数:
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| action | str | 是 | - | "search" |
| query | str | 是 | - | 搜索关键词 |
| page | int | 否 | 1 | 页码 |
| count | int | 否 | 10 | 每页数量(最多20) |
| order | str | 否 | totalrank |
排序:totalrank综合 / click播放量 / pubdate最新 / dm弹幕 / stow收藏 |
返回格式:
{
"total": 1000,
"page": 1,
"results": [
{
"bvid": "BV1xx411c7mD",
"url": "https://www.bilibili.com/video/BV1xx411c7mD",
"title": "视频标题",
"author": "UP主名称",
"mid": 123456,
"play": 100000,
"danmaku": 500,
"favorites": 2000,
"like": 3000,
"pubdate": 1700000000,
"duration": "10:30",
"desc": "视频简介前100字..."
}
]
}
展示时必须包含: bvid、url、title、author、play(播放量)
2. 视频详情 video
python3 scripts/bilibili.py '{"action":"video","bvid":"BV1GJ411x7h7"}'
参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | str | 是 | "video" |
| bvid | str | 是 | 视频BV号,如 BV1GJ411x7h7 |
返回格式:
{
"bvid": "BV1GJ411x7h7",
"url": "https://www.bilibili.com/video/BV1GJ411x7h7",
"title": "视频标题",
"desc": "视频简介",
"owner": {
"name": "UP主名称",
"mid": 123456
},
"pubdate": 1700000000,
"duration": 213,
"tags": ["标签1", "标签2"],
"stat": {
"view": 97000000,
"danmaku": 135000,
"reply": 184000,
"favorite": 1393000,
"coin": 1152000,
"share": 434000,
"like": 2653000
}
}
展示时必须包含: bvid、url、title、owner.name、全部 stat 数据
3. UP主信息 user
python3 scripts/bilibili.py '{"action":"user","mid":123456}'
参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | str | 是 | "user" |
| mid | int | 是 | UP主UID |
返回格式:
{
"mid": 123456,
"name": "UP主昵称",
"followers": 1382687,
"following": 414,
"videos": 42,
"url": "https://space.bilibili.com/123456"
}
展示时必须包含: mid、url、name、followers(粉丝数)、videos(投稿数)
4. 热门视频 popular
python3 scripts/bilibili.py '{"action":"popular","count":10}'
参数:
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| action | str | 是 | - | "popular" |
| count | int | 否 | 10 | 获取数量(最多100) |
返回格式:
{
"results": [
{
"bvid": "BV1xx411c7mD",
"url": "https://www.bilibili.com/video/BV1xx411c7mD",
"title": "视频标题",
"owner": "UP主名称",
"view": 5000000,
"like": 500000,
"danmaku": 10000
}
]
}
展示时必须包含: bvid、url、title、owner、view(播放量)、like(点赞数)
5. 热搜榜 hot_search
python3 scripts/bilibili.py '{"action":"hot_search"}'
无需参数,返回实时热搜 Top20。
返回格式:
{
"hot_search": [
{
"rank": 1,
"keyword": "热搜关键词",
"search_url": "https://search.bilibili.com/all?keyword=...",
"hot_id": 241546
}
]
}
展示时必须包含: rank、keyword、search_url,格式如下:
#1 热搜关键词
搜索链接: https://search.bilibili.com/all?keyword=...
完整示例
# 搜索最新AI视频(按发布时间)
python3 scripts/bilibili.py '{"action":"search","query":"Claude AI","order":"pubdate","count":5}'
# 查询视频详情
python3 scripts/bilibili.py '{"action":"video","bvid":"BV1GJ411x7h7"}'
# 查看UP主信息
python3 scripts/bilibili.py '{"action":"user","mid":2}'
# 今日热门视频 Top10
python3 scripts/bilibili.py '{"action":"popular","count":10}'
# 实时热搜榜
python3 scripts/bilibili.py '{"action":"hot_search"}'
说明
- 无需 API Key,基于B站公开接口
- 大陆直连可用,无需代理,无需登录
- 接口为公开接口,稳定性较好,但可能随B站更新变化
- 请合理控制调用频率,避免触发风控
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install bilibili-search - 安装完成后,直接呼叫该 Skill 的名称或使用
/bilibili-search触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Bilibili Search 是什么?
B站(哔哩哔哩)数据查询工具。搜索视频、获取视频详情和数据、查看UP主信息、热门排行榜、热搜榜。无需 API Key,即装即用。Use when you need to search Bilibili videos, get video stats, check UP主 info, browse popular... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1004 次。
如何安装 Bilibili Search?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install bilibili-search」即可一键安装,无需额外配置。
Bilibili Search 是免费的吗?
是的,Bilibili Search 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Bilibili Search 支持哪些平台?
Bilibili Search 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Bilibili Search?
由 Songrat(@songrat)开发并维护,当前版本 v0.1.0。