Bilibili All In One Free

B站全功能工具箱的免费基础版,集成热门监控(Hot Monitor)、标准清晰度下载(Downloader)、数据追踪(Watcher)与播放信息(Player)四大公共API模块。支持热门/热搜/必看榜/分区排行获取, 360p至1080p视频下载与mp4格式输出,播放量/点赞/评论统计与多视频对比,弹幕获取与分P列表解析。全部功能基于B站公共API,无需任何登录凭据。不包含1080p+/4K高清下载、字幕处理、视频投稿等需要会话Cookie的付费能力。

天轰穿@thcjp

Install

openclaw skills install @thcjp/bilibili-all-in-one-free

Bilibili All In One 全功能工具箱 (免费版)

依赖说明

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

分类: MD+EXEC（）

API Key配置方式:

bash

export API_KEY="your_api_key_here"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统。

核心能力

热门监控 (hot_monitor): get_hot 获取热门视频、get_trending 获取热门系列、get_weekly 获取每周必看榜、get_rank 按分区获取排行,支持 all/anime/music/dance/game/tech/life/food/car/fashion/entertainment/movie/tv 等13个分区
视频下载 (downloader): get_info 获取视频信息、get_formats 列出可用清晰度、download 单视频下载,支持 360p/480p/720p/1080p 四档清晰度与 mp4 格式输出
数据追踪 (watcher): watch 获取视频详情、get_stats 获取当前互动统计、compare 多视频数据对比,支持 BV 短ID与完整URL两种输入
播放信息 (player): play 获取完整播放信息、get_playurl 获取标准清晰度直链、get_danmaku 获取弹幕(支持滚动/底部固定/顶部固定三种模式)、get_playlist 获取分P列表
统一调用接口: 所有模块通过 app.execute(module, action, **params) 异步调用,返回 {"success": bool, ...} 统一JSON结构,CLI支持 python main.py <module> <action> <params_json>
无需凭据: 全部功能基于B站公共API,无需 SESSDATA/bili_jct/buvid3 等会话Cookie

视频下载 (downloader)

执行视频下载 (downloader)操作,处理用户输入并返回结果。

输入: 用户提供视频下载 (downloader)所需的参数和指令。

输出: 返回视频下载 (downloader)的处理结果。

执行视频下载 (downloader)操作，处理输入数据并返回结果
验证执行结果，确认输出符合预期格式
参考视频下载 (downloader)相关配置参数进行设置

数据追踪 (watcher)

执行数据追踪 (watcher)操作,处理用户输入并返回结果。

输入: 用户提供数据追踪 (watcher)所需的参数和指令。

输出: 返回数据追踪 (watcher)的处理结果。

执行数据追踪 (watcher)操作，处理输入数据并返回结果
验证执行结果，确认输出符合预期格式
参考数据追踪 (watcher)相关配置参数进行设置

能力覆盖范围

本skill还覆盖以下能力场景: 站热门监控、标准清晰度下载、数据追踪与弹幕获、取基础工具集、无需登录凭据、站全功能工具箱的、免费基础版、集成热门监控、与播放信息、四大公共、支持热门、分区排行获取、视频下载与、播放量、评论统计与多视频、弹幕获取与分、列表解析、无需任何登录凭据、不包含、高清下载、字幕处理、视频投稿等需要会、的付费能力。这些能力在上述核心功能中均有对应处理逻辑。

使用流程

环境确认: 确认Agent平台已加载本skill，检查依赖说明中的环境要求
指令输入: 向Agent描述需要执行的任务，引用bilibili-all-in-one-free的相关能力
执行处理: Agent按照核心能力章节的指令执行任务
结果验证: 检查输出结果是否符合预期，参考错误处理章节处理异常

适用场景

热门内容发现: 获取B站热门视频、分区排行与每周必看榜,辅助内容选题与趋势洞察
标准视频下载: 下载360p-1080p清晰度视频为本地mp4文件,用于离线观看或素材采集

安装与环境

bash

pip install httpx aiohttp beautifulsoup4 lxml requests
# 可选: 视频流合并
# 系统安装 ffmpeg

Python >= 3.8,操作系统 Windows / macOS / Linux。

基础用法

python

import asyncio
from main import BilibiliAllInOne

app = BilibiliAllInOne()

async def main():
    hot = await app.execute("hot_monitor", "get_hot", page_size=10)
    print(hot)

asyncio.run(main())

CLI调用:

bash

python main.py hot_monitor get_hot '{"page_size": 10}'
python main.py hot_monitor get_rank '{"category": "game", "limit": 10}'

案例展示

案例一：热门监控与分区排行

获取热门视频与游戏分区排行:

bash

python main.py hot_monitor get_hot '{"page_size": 10}'
python main.py hot_monitor get_rank '{"category": "game", "limit": 10}'
python main.py hot_monitor get_weekly
python main.py hot_monitor get_trending '{"limit": 5}'

python

import asyncio
from main import BilibiliAllInOne

app = BilibiliAllInOne()

async def main():
    hot = await app.execute("hot_monitor", "get_hot", page_size=10)
    rank = await app.execute("hot_monitor", "get_rank", category="game", limit=10)
    print(hot, rank)

asyncio.run(main())

案例二：标准清晰度下载与弹幕获取

下载1080p视频并获取弹幕:

bash

python main.py downloader download '{"url": "BV1xx411c7mD", "quality": "1080p", "format": "mp4"}'
python main.py player get_danmaku '{"url": "BV1xx411c7mD"}'
python main.py watcher compare '{"urls": ["BV1xx411c7mD", "BV1yy411c8nE"]}'

python

result = await app.execute("downloader", "download", url="BV1xx411c7mD", quality="1080p")
danmaku = await app.execute("player", "get_danmaku", url="BV1xx411c7mD")

异常处理

412风控拦截

现象: 请求返回412状态码或 {"code": -509, "message": "请求过于频繁"}。原因: 短时间高频请求触发B站反爬。处理: 降低调用频率,单次批量不超过20个视频,批量间间隔5-10秒;复用同一会话的httpx Client保持连接一致性。

视频清晰度不可用

现象: downloader.download 指定 1080p+/4k 后实际下载为 720p 或返回不支持。原因: 免费版仅支持360p-1080p四档清晰度,1080p+/4K需要付费版携带 SESSDATA 会话Cookie。处理: 切换到 1080p 及以下档位;若需1080p+/4K高清下载,请升级付费版。

ffmpeg合并失败

现象: 下载的视频只有画面无声音,或合并时报 ffmpeg not found。原因: B站高清流为音视频分离的DASH流,需要ffmpeg合并;系统未安装ffmpeg或未加入PATH。处理: 安装ffmpeg(brew install ffmpeg / apt install ffmpeg / Windows下载二进制并配置PATH)。

弹幕分段缺失

现象: get_danmaku 返回弹幕数量明显少于实际播放量。原因: B站弹幕按分P与时间分段存储,长视频弹幕分多段,默认只返回第一段。处理: 通过 get_playlist 获取分P列表后逐P调用 get_danmaku,并指定 segment 索引遍历所有分段。

视频不存在或已下架

现象: get_info/download 返回 {"success": false, "message": "video not found"}。原因: BV号错误、视频已被UP主删除或被B站下架。处理: 核对BV号格式(以BV开头12位);在浏览器访问确认视频可正常播放;已下架视频无法恢复。

常见问题

Q1: 免费版需要登录凭据吗?

不需要。免费版全部功能基于B站公共API,无需 SESSDATA/bili_jct/buvid3 等会话Cookie,直接 BilibiliAllInOne() 初始化即可使用。

Q2: 免费版支持哪些下载清晰度?

免费版支持 360p/480p/720p/1080p 四档清晰度与 mp4 格式。1080p+/4k 高清档位与 flv/mp3 格式需升级付费版并携带会话Cookie。

Q3: 免费版能投稿视频吗?

不能。视频上传、定时发布、草稿编辑等 publisher 模块能力需要 SESSDATA+bili_jct 完整会话Cookie,属付费版功能。

Q4: 下载的视频为什么音画分离?

B站高清流(720p+)采用DASH协议,音频与视频独立传输。库内部会调用ffmpeg合并为单文件;若系统无ffmpeg,需自行安装或将清晰度降至360p/480p(这些档位为单流)。

错误处理

错误场景	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	执行ping命令测试网络连通性,检查防火墙和代理设置连接，执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令请求；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

已知限制

仅支持360p-1080p四档清晰度,不包含1080p+/4K高清下载
仅支持 mp4 格式输出,不包含 flv 与 mp3 音频提取
不包含 subtitle 字幕处理模块与 faster-whisper 语音识别兜底
不包含 publisher 视频投稿模块(上传/定时发布/草稿编辑)
不支持凭据管理与持久化(无需凭据)
反爬策略可能触发412,需控制请求频率

升级提示

当前为免费版,仅包含公共API基础能力。升级付费版可获得:

1080p+/4k 高清下载与 flv/mp3 格式转换
subtitle 字幕处理模块(SRT/ASS转换 + faster-whisper 语音识别兜底)
publisher 视频投稿模块(上传/定时发布/草稿编辑)
凭据三态管理(环境变量/JSON文件/直接参数)与0600权限持久化
高清播放直链与 watcher.track 长期指标追踪
完整13个分区排行与多视频对比分析

付费版slug: bilibili-all-in-one

Bilibili All In One Free

Install

Bilibili All In One 全功能工具箱 (免费版)

依赖说明

运行环境

依赖项

API Key 配置

可用性分类

核心能力

热门监控 (hot_monitor)

视频下载 (downloader)

数据追踪 (watcher)

能力覆盖范围

使用流程

适用场景

安装与环境

基础用法

案例展示

案例一： 热门监控与分区排行

案例二： 标准清晰度下载与弹幕获取

异常处理

412风控拦截

视频清晰度不可用

ffmpeg合并失败

弹幕分段缺失

视频不存在或已下架

常见问题

Q1: 免费版需要登录凭据吗?

Q2: 免费版支持哪些下载清晰度?

Q3: 免费版能投稿视频吗?

Q4: 下载的视频为什么音画分离?

错误处理

已知限制

升级提示

案例一：热门监控与分区排行

案例二：标准清晰度下载与弹幕获取