B站工具箱专业版

付费版专享能力

核心能力

1. 视频发布管理

import asyncio
from main import BilibiliAllInOne
# ...
# 使用凭证初始化
app = BilibiliAllInOne(
    sessdata="your_sessdata",
    bili_jct="your_bili_jct",
    buvid3="your_buvid3"
)
# ...
async def publish_video():
    # 上传并发布视频
    result = await app.execute("publisher", "upload",
        file_path="./video.mp4",
        title="我的专业视频",
        description="使用B站工具箱专业版上传",
        tags=["python", "bilibili", "教程"],
        category="122",  # 开源软件分类
        no_reprint=1,    # 原创内容
        open_elec=1      # 开启充电
    )
    print(f"发布结果: {result}")
# ...
asyncio.run(publish_video())

# 命令行发布
python main.py publisher upload '{
    "file_path": "./video.mp4",
    "title": "我的专业视频",
    "description": "专业版上传测试",
    "tags": ["教程", "python"],
    "category": "122"
}'
# ...
# 保存为草稿
python main.py publisher draft '{
    "file_path": "./video.mp4",
    "title": "草稿视频"
}'
# ...
# 定时发布
python main.py publisher schedule '{
    "file_path": "./video.mp4",
    "title": "定时发布视频",
    "schedule_time": "2026-12-31T20:00:00+08:00"
}'
# ...
# 编辑已发布视频
python main.py publisher edit '{
    "bvid": "BV1xx411c7mD",
    "title": "新标题",
    "tags": ["更新", "标签"]
}'
```- 验证返回数据的完整性和格式正确性
- 参考`数据追踪与对比分析`的配置文档进行参数调优- 验证返回数据的完整性和格式正确性
- 参考`批量下载与队列管理`的配置文档进行参数调优- 验证返回数据的完整性和格式正确性
- 参考`视频发布管理`的配置文档进行参数调优
### 2. 批量下载与队列管理
```python
async def batch_download():
    # 批量下载多个视频
    urls = [
        "BV1xx411c7mD",
        "BV1yy411c8nE",
        "BV1zz411c9oF"
    ]
# ...
    result = await app.execute("downloader", "batch_download",
        urls=urls,
        quality="1080p+",  # 专业版支持高清
        format="mp4",
        output_dir="./downloads"
    )
    print(f"批量下载完成: {result}")
# ...
asyncio.run(batch_download())

输入: 用户提供批量下载与队列管理所需的指令和必要参数。- 验证执行结果,确认输出符合预期格式

• 异常时参考错误处理章节进行恢复
• 关键参数: 批量下载与队列管理 选项
• 处理流程: 接收输入 -> 执行批量下载与队列管理 -> 返回结果
• 输入: 用户提供批量下载与队列管理所需的参数和指令
• 输出: 返回批量下载与队列管理的处理结果,包含执行状态码、结果数据和执行日志

3. 数据追踪与对比分析

async def track_and_compare():
    # 追踪视频数据（每30分钟采集一次，持续12小时）
    track_result = await app.execute("watcher", "track",
        url="BV1xx411c7mD",
        interval=30,    # 30分钟间隔
        duration=12     # 持续12小时
    )
    print(f"追踪完成: {track_result}")
# ...
    # 多视频数据对比
    compare_result = await app.execute("watcher", "compare",
        urls=["BV1xx411c7mD", "BV1yy411c8nE", "BV1zz411c9oF"]
    )
    print(f"对比结果: {compare_result}")
# ...
asyncio.run(track_and_compare())

输入: 用户提供数据追踪与对比分析所需的指令和必要参数。- 验证执行结果,确认输出符合预期格式

• 异常时参考错误处理章节进行恢复
• 关键参数: 数据追踪与对比分析 选项
• 处理流程: 接收输入 -> 执行数据追踪与对比分析 -> 返回结果
• 输入: 用户提供数据追踪与对比分析所需的参数和指令
• 输出: 返回数据追踪与对比分析的处理结果,包含执行状态码、结果数据和执行日志

4. 凭证安全管理

# 方式一：环境变量（推荐）
import os
os.environ["BILIBILI_SESSDATA"] = "your_sessdata"
os.environ["BILIBILI_BILI_JCT"] = "your_bili_jct"
os.environ["BILIBILI_BUVID3"] = "your_buvid3"
# ...
app = BilibiliAllInOne()  # 自动从环境变量读取
# ...
# 方式二：凭证文件
app = BilibiliAllInOne(
    sessdata="your_sessdata",
    bili_jct="your_bili_jct",
    buvid3="your_buvid3",
    persist=True  # 启用持久化存储（0600权限）
)
# ...
# 方式三：运行时管理
app.auth.persist = True   # 启用持久化
app.auth.clear_persisted()  # 清除持久化文件

输入: 用户提供凭证安全管理所需的指令和必要参数. 输出: 返回凭证安全管理的处理结果,包含执行状态码、结果数据和执行日志。- 验证执行结果,确认输出符合预期格式

• 异常时参考错误处理章节进行恢复
• 关键参数: 凭证安全管理 选项

适用场景

场景一：UP主内容发布管理

专业UP主批量管理视频发布，包括上传、定时发布与草稿管理.

async def up_master_workflow():
    # 1. 上传并保存为草稿
    draft_result = await app.execute("publisher", "draft",
        file_path="./videos/episode01.mp4",
        title="系列教程优秀期",
        description="Python基础教程",
        tags=["Python", "教程", "编程"],
        category="122"
    )
# ...
    # 2. 定时发布第二期
    schedule_result = await app.execute("publisher", "schedule",
        file_path="./videos/episode02.mp4",
        title="系列教程第二期",
        schedule_time="2026-01-20T19:00:00+08:00",
        tags=["Python", "教程", "编程"],
        category="122"
    )
# ...
    # 3. 编辑已发布视频信息
    edit_result = await app.execute("publisher", "edit",
        bvid="BV1xx411c7mD",
        title="更新后的标题",
        tags=["更新标签", "Python"]
    )
# ...
    print(f"草稿: {draft_result}")
    print(f"定时: {schedule_result}")
    print(f"编辑: {edit_result}")
# ...
asyncio.run(up_master_workflow())

场景二：竞品数据追踪分析

运营团队追踪竞品视频数据变化，进行对比分析.

async def competitor_analysis():
    # 追踪竞品视频数据
    competitor_videos = [
        "BV1xx411c7mD",  # 竞品A
        "BV1yy411c8nE",  # 竞品B
        "BV1zz411c9oF"   # 竞品C
    ]
# ...
    # 获取当前数据
    for bv in competitor_videos:
        stats = await app.execute("watcher", "get_stats", url=bv)
        print(f"视频{bv}: 播放{stats['data']['view']} 点赞{stats['data']['like']}")
# ...
    # 多视频对比
    comparison = await app.execute("watcher", "compare", urls=competitor_videos)
    print(f"对比分析: {comparison}")
# ...
    # 长期追踪（每小时采集，持续24小时）
    track = await app.execute("watcher", "track",
        url="BV1xx411c7mD",
        interval=60,
        duration=24
    )
# ...
asyncio.run(competitor_analysis())

场景三：高清视频批量归档

企业批量下载高清视频用于内容归档.

async def batch_archive():
    # 批量下载4K高清视频
    video_list = [
        "BV1xx411c7mD",
        "BV1yy411c8nE",
        "BV1zz411c9oF",
        "BV1aa411c0pG"
    ]
# ...
    result = await app.execute("downloader", "batch_download",
        urls=video_list,
        quality="4k",      # 4K超清
        format="mp4",
        output_dir="./archive/4k_videos"
    )
# ...
    # 批量获取字幕
    for bv in video_list:
        await app.execute("subtitle", "download",
            url=bv,
            language="zh-CN",
            format="srt",
            output_dir="./archive/subtitles"
        )
# ...
    print(f"归档完成: {result}")
# ...
asyncio.run(batch_archive())

使用流程

依赖说明

运行环境

1. Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
2. 操作系统: Windows / macOS / Linux
3. Python版本: 3.8及以上
4. 可选工具: ffmpeg（用于合并音视频流）

第三方依赖

API Key 配置

5. BILIBILI_SESSDATA：B站会话凭证（发布与高清下载必需）
6. BILIBILI_BILI_JCT：B站CSRF Token（写操作必需）
7. BILIBILI_BUVID3：B站设备标识（辅助验证）
8. BILIBILI_PERSIST：是否启用凭证持久化（设为1启用）
9. 与免费版完全兼容，免费版的无登录功能可直接使用

可用性分类

10. 分类: MD+EXEC（纯Markdown指令，核心功能需要exec命令行执行能力）
11. 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行专业B站运营任务。支持视频发布、高清下载、批量操作、数据追踪等全功能能力，通过Python脚本调用B站API实现。与免费版完全兼容，可直接复用免费版的无登录功能. API Key配置方式:

export API_KEY="your_api_key_here"

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

输入格式

输出格式

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

异常处理

依赖说明(补充)

国内替代方案:

• OpenAI GPT → 智谱GLM-4 / 百度文心一言 / 通义千问 / DeepSeek

案例展示

凭证获取方式

登录bilibili.com，打开浏览器开发者工具（F12）→ Application → Cookies，复制以下值：

发布参数说明

凭证安全说明

常见问题

Q1：发布视频失败提示认证错误怎么办？

检查SESSDATA和bili_jct是否正确且未过期。发布操作必须同时提供这两个凭证.

Q2：4K下载失败怎么办？

4K下载需要登录凭证。确认已正确配置SESSDATA，且账号有4K观看权限.

Q3：凭证持久化安全吗？

持久化文件使用0600权限（仅所有者可读写）。建议仅在需要跨会话使用时启用，用完及时清除.

Q4：定时发布的时间格式是什么？

使用ISO 8601格式，如 2026-12-31T20:00:00+08:00（北京时间20:00）.

Q5：与免费版的功能是否兼容？

完全兼容。专业版包含免费版所有功能，免费版的无登录功能在专业版中同样可用.

错误处理

已知限制

• 需要API Key，无Key环境无法使用