bilibili-danmaku-extractor ​

---

name: bilibili-danmaku-extractor description: "B站视频弹幕提取工具。输入B站视频链接，自动提取该视频的所有弹幕，输出JSON和Markdown两种格式的文件。" description_zh: "B站弹幕提取，输出JSON和Markdown格式" description_en: "Extract Bilibili video danmaku to JSON and Markdown"

---

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接口

| 数据 | 接口URL | 参数 | |------|---------|------| | 视频信息 | https://api.bilibili.com/x/web-interface/view?bvid={bvid} | bvid | | 弹幕数据 | https://api.bilibili.com/x/v1/dm/list.so?oid={cid} | oid(视频cid) |

请求头设置

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: 易读格式

脚本参数

| 参数 | 说明 | 示例 | |------|------|------| | url | B站视频链接或BV号 | BV1ky97B9Efn | | -o, --output | 输出目录 | -o ./output |

弹幕字段说明

| 字段 | 类型 | 说明 | |------|------|------| | text | string | 弹幕文本内容 | | time | float | 出现时间（秒） | | type | string | 弹幕类型（滚动/底端/顶端等） | | type_code | int | 弹幕类型代码 | | color | string | 弹幕颜色（十六进制） | | timestamp | int | 发送时间戳 |

弹幕类型代码

| code | 类型 | |------|------| | 1 | 滚动弹幕 | | 4 | 底部弹幕 | | 5 | 顶部弹幕 | | 6 | 逆向弹幕 | | 7 | 高级弹幕 | | 8 | 代码弹幕 |

注意事项

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

故障排除

| 问题 | 原因 | 解决 | |------|------|------| | 获取弹幕为0 | CID获取失败或视频无弹幕 | 检查网络或视频有效性 | | 412/403错误 | 风控拦截 | 添加延时或稍后重试 | | 视频信息获取失败 | BV号无效 | 检查链接格式是否正确 |

实际案例

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

用户输入：

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

执行过程：

1. 提取BV号：BV1Am9gBzEUb

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

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

4. 导出文件： - JSON: BV1Am9gBzEUb_弹幕_1063条.json - Markdown: BV1Am9gBzEUb_弹幕_1063条.md

弹幕预览：

| 时间 | 弹幕内容 | |------|----------| | [07:24] | 绿坝：没想到吧，老娘回来了 | | [03:03] | 4千万身价指的是当时这玩意软件造价4,000万元人民币... | | [00:14] | 萌娘百科方便是方便，不过有的时候会夹带私货或者玩梗误导人… | | [10:37] | "不是我害了你，是这乱世害了你啊" | | [06:46] | 啊？还有这么巧的事？ |

输出成果：

✅ 成功提取 1063 条弹幕

✅ JSON文件包含完整视频信息和弹幕数据

✅ Markdown文件按时间顺序排列，便于阅读

---

文件结构

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