bilibili-danmaku-extractor ​

B站视频弹幕提取工具。输入B站视频链接，自动提取该视频的所有弹幕，输出JSON和Markdown两种格式的文件。

Security Scan

The skill's code, instructions, and network requests are consistent with a simple Bilibili danmaku extractor; it doesn't request secrets or odd permissions, though the source is unsigned/unknown so exercise normal caution.

Purpose & Capability

Name/description (extract Bilibili danmaku) aligns with what the files do: main.py fetches video info and danmaku from Bilibili API endpoints and exports JSON/Markdown. No unrelated services, binaries, or credentials are requested.

Instruction Scope

SKILL.md instructs the agent to call Bilibili APIs and run the included main.py; the script only reads the provided URL/BV, performs HTTP requests to Bilibili, parses XML (with optional zlib decompression), and writes local output files. It does not read arbitrary system files, access other environment variables, or send data to unexpected external endpoints.

Install Mechanism

No install spec; requirements.txt lists only requests (requests>=2.28.0). This is low-risk and proportionate for a Python script that performs HTTP calls.

Credentials

The skill requires no environment variables, no credentials, and no config paths. Network access to Bilibili is necessary and appropriate for the stated purpose.

Persistence & Privilege

always is false and the skill does not request permanent/system-wide changes. It is user-invocable only and does not modify other skills or agent-wide settings.

Assessment

The skill appears to be a straightforward Bilibili danmaku extractor and is internally consistent. Before installing/run: (1) Review the code yourself or run it in a disposable environment (container or VM) because the package author and homepage are unknown; (2) run inside a Python virtualenv and inspect network activity if you have concerns; (3) be mindful of Bilibili rate limits and terms of service when extracting many videos; (4) the script writes files to the output directory — avoid running as a privileged user and choose a safe output path; (5) verify the pip package 'requests' is installed from the official index (pip install in a controlled env). These steps reduce risk even though the code itself matches its stated purpose.

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依赖