bilibili-all-in-one-free

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

输入规范

运行环境

运行环境

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

依赖项

API Key 配置

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

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。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
• 无需凭据: 全部功能基于B站公共API,无需 SESSDATA/bili_jct/buvid3 等会话Cookie

部署说明

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

典型场景

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

安装与环境

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

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

基础用法

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调用:

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_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}'

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视频并获取弹幕:

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"]}'

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(这些档位为单流).

能力边界

• 仅支持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

输出规范

{
  "success": true,
  "data": {
    "result": "B站工具箱免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "bilibili-all-in-one"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

诊断与修复

安全规范

创新特色

关键特性

• 自动化执行: B站热门监控、标准清晰度下载、数据追踪与弹幕获取基础工具集,无需登录凭据。B站全功能工具箱的免费基础版,集成热门监控(H
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

性能数据

差异分析

异常处理框架

针对B站工具箱免费版使用中可能遇到的常见问题,提供以下排查方案:

B站工具箱免费版通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块