unclecheng-bilibili-danmaku-extractor（大叔 bilibili 弹幕提取器）

B站弹幕提取 Skill

专注于弹幕提取的轻量工具，输入B站视频链接，自动提取所有弹幕并输出为 JSON 和 Markdown 两种格式。

核心功能

• ✅ 弹幕提取 - 提取视频所有弹幕（滚动、底端、顶端等全部类型）
• ✅ JSON导出 - 包含视频信息和完整弹幕数据
• ✅ Markdown导出 - 按时间顺序排列的易读格式
• ✅ 无需登录 - 使用B站公开API，完全免费

前置条件

1. 环境要求

• Python 3.8+
• 网络可访问 B站 API

2. 依赖安装

pip install requests

使用方式

对话中使用

@skill://B站弹幕提取 请提取这个视频的弹幕：https://www.bilibili.com/video/BV1xx97xx9xx

命令行使用

# 提取弹幕并输出到当前目录
python main.py "https://www.bilibili.com/video/BV1xx97xx9xx"

# 指定输出目录
python main.py "https://www.bilibili.com/video/BV1xx97xx9xx" -o /path/to/output

# 使用BV号
python main.py "BV1xx97xx9xx"

技术实现

核心API接口

请求头设置

DEFAULT_HEADERS = {
    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36...',
    'Referer': 'https://www.bilibili.com/',
    'Origin': 'https://www.bilibili.com'
}

输出文件

JSON格式

{
  "video_info": {
    "bvid": "BV1xx97xx9xx",
    "title": "视频标题",
    "owner": "UP主名称",
    "duration": 600,
    "stat": { "view": 123456, "like": 7890, ... },
    "pubdate": 1234567890
  },
  "export_time": "2024-01-01T12:00:00",
  "total_count": 1234,
  "danmakus": [
    {
      "text": "弹幕内容",
      "time": 12.5,
      "type": "滚动",
      "type_code": 1,
      "color": "ffffff",
      "timestamp": 1234567890
    },
    ...
  ]
}

Markdown格式

# 视频标题

> **BV号**: `BV1xx97xx9xx`
> **UP主**: UP主名称
> **弹幕总数**: 1234 条
> **导出时间**: 2024-01-01 12:00:00

---

## 全部弹幕 (共 1234 条)

`[00:12]` 这是第一条弹幕
`[00:15]` 这是第二条弹幕
`[00:20]` 这是第三条弹幕
...

工作流程

输入B站视频链接
    │
    ▼
1. 提取BV号 (正则匹配)
    │
    ▼
2. 获取视频信息 (标题、UP主、时长、CID等)
    │
    ▼
3. 获取弹幕数据 (XML/压缩格式)
    │
    ▼
4. 解析弹幕
   ├── 提取文本、时间、类型、颜色等
   └── 处理压缩弹幕 (zlib解压)
    │
    ▼
5. 导出文件
   ├── JSON: 完整数据 + 元信息
   └── Markdown: 易读格式

脚本参数

弹幕字段说明

弹幕类型代码

注意事项

1. 无需登录: 脚本使用B站公开API，无需登录即可提取弹幕
2. 弹幕完整性: 获取的弹幕数量取决于视频实际弹幕数量
3. 频率限制: 建议控制请求频率，避免触发风控
4. 编码处理: 自动处理gzip压缩的弹幕数据

故障排除

实际案例

案例：萌娘百科消亡视频弹幕提取

用户输入：

@skill://B站弹幕提取 请提取这个视频的弹幕：https://www.bilibili.com/video/BV1Am9gBzEUb

执行过程：

1. 提取BV号：BV1Am9gBzEUb

1. 获取视频信息：

- 标题：曾经"二次元入坑必备"的萌娘百科，为何一步步走向消亡？ - UP主：BB姬Studio - 时长：约11分钟

1. 获取弹幕：通过CID调用弹幕接口，获取到 1063 条弹幕

1. 导出文件：

- JSON: BV1Am9gBzEUb_弹幕_1063条.json - Markdown: BV1Am9gBzEUb_弹幕_1063条.md

弹幕预览：

输出成果：

• ✅ 成功提取 1063 条弹幕
• ✅ JSON文件包含完整视频信息和弹幕数据
• ✅ Markdown文件按时间顺序排列，便于阅读

文件结构

B站弹幕提取/
├── SKILL.md                 # 本说明文件
├── _skillhub_meta.json      # Skill元数据
├── main.py                  # 核心脚本
└── requirements.txt         # Python依赖