---
name: kb-bilibili-content
description: B站内容下载 - 下载视频、字幕、专栏文章
---

# KB Bilibili Content Skill

**kb-bilibili-content** - 下载 B站视频、字幕、专栏文章。

## 什么时候使用

- kb-workflow 步骤 3a：下载视频或字幕
- kb-workflow 步骤 3b：提取专栏文章内容

## 功能

- 视频下载（使用 yt-dlp）
- 字幕提取（官方字幕）
- 专栏文章内容提取
- 多种画质选项（360P/480P/720P/1080P）
- 支持 `BILIBILI_COOKIE` 环境变量（会员视频）

## 环境变量

| 变量名 | 必需 | 说明 |
|--------|------|------|
| `BILIBILI_COOKIE` | 否 | B站登录 Cookie（会员视频需要） |

**获取 Cookie：**
1. 登录 bilibili.com
2. F12 → Network → 刷新页面
3. 从请求头复制 Cookie

```bash
export BILIBILI_COOKIE="SESSDATA=xxx; bili_jct=xxx; DedeUserID=xxx"
```

## 命令

```bash
# 下载字幕（推荐首先尝试）
python3 bilibili_content.py --id "BV1xx411c7mD" --type subtitle-download --output "/path/to/output/"

# 下载视频（720P，推荐）
python3 bilibili_content.py --id "BV1xx411c7mD" --type video --output "/path/to/output/"

# 下载视频（1080P）
python3 bilibili_content.py --id "BV1xx411c7mD" --type video --quality 80 --output "/path/to/output/"

# 提取专栏文章
python3 bilibili_content.py --id "cv43780186" --type article --output "/path/to/output/"
```

## 输出格式 Schema

### 必需字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `success` | boolean | 是否成功 |
| `type` | string | 操作类型（subtitle/video/article） |

### 字幕下载特有字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `has_subtitle` | boolean | 是否有官方字幕 |
| `subtitle_file` | string | 字幕文件路径（有字幕时） |

### 视频下载特有字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `filepath` | string | 视频文件路径 |
| `filename` | string | 视频文件名 |
| `quality` | string | 画质 |

### 文章提取特有字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `filepath` | string | 文章文件路径 |
| `content_length` | number | 内容长度 |

## 成功示例

### 字幕下载 - 有官方字幕

```json
{
  "success": true,
  "type": "subtitle-download",
  "has_subtitle": true,
  "subtitle_file": "content/downloads/bilibili_BV1xx411c7mD.srt",
  "message": "官方字幕下载成功"
}
```

### 字幕下载 - 无官方字幕

```json
{
  "success": true,
  "type": "subtitle-download",
  "has_subtitle": false,
  "message": "无官方字幕，需要下载视频进行语音识别"
}
```

### 视频下载

```json
{
  "success": true,
  "type": "video",
  "filename": "bilibili_BV1xx411c7mD.mp4",
  "filepath": "content/downloads/bilibili_BV1xx411c7mD.mp4",
  "quality": "720P",
  "message": "下载完成"
}
```

### 专栏文章提取

```json
{
  "success": true,
  "type": "article",
  "filename": "bilibili_cv43780186.txt",
  "filepath": "content/bilibili_cv43780186.txt",
  "content_length": 5234,
  "message": "文章内容提取成功"
}
```

## 错误示例

### 403 禁止访问

```json
{
  "success": false,
  "type": "video",
  "error": "403 Forbidden",
  "error_code": "FORBIDDEN",
  "suggestion": "可能需要会员权限，请配置 BILIBILI_COOKIE 环境变量"
}
```

### 视频不存在

```json
{
  "success": false,
  "type": "video",
  "error": "视频不存在或已被删除",
  "error_code": "NOT_FOUND"
}
```

### 网络超时

```json
{
  "success": false,
  "type": "video",
  "error": "下载超时",
  "error_code": "TIMEOUT",
  "suggestion": "请检查网络连接后重试"
}
```

## 画质选项

| 画质 | ID | 分辨率 | 说明 |
|------|-----|--------|------|
| 360P | 16 | 640x360 | 最快 |
| 480P | 32 | 852x480 | 低带宽 |
| 720P | 64 | 1280x720 | **推荐** |
| 1080P | 80 | 1920x1080 | 最高画质 |

**默认画质：** 64 (720P)

## 安装

```bash
cp -r kb-bilibili-content/ ~/.openclaw/skills/
pip install aiohttp yt-dlp
```

## 在 kb-workflow 中的使用

```bash
# 步骤 3a：首先尝试字幕
python3 ~/.openclaw/skills/kb-bilibili-content/bilibili_content.py \
    --id "BV1xx411c7mD" --type subtitle-download \
    --output "content/downloads/"

# 判断结果：
# - has_subtitle=true → 跳过 Whisper，直接进入深度分析
# - has_subtitle=false → 下载视频，进入 Whisper 步骤

# 如果无字幕，下载视频
python3 ~/.openclaw/skills/kb-bilibili-content/bilibili_content.py \
    --id "BV1xx411c7mD" --type video \
    --output "content/downloads/"
```

## 注意事项

- **无官方字幕是正常的**：很多视频没有自动生成的字幕，这不是错误
- **403 错误**：通常需要配置 Cookie
- **会员视频**：必须配置 BILIBILI_COOKIE
- **下载时间**：视频可能较大，需要耐心等待