---
name: kb-link-parser
description: 链接解析器 - 从各平台 URL 提取平台类型、内容类型和 ID
---

# KB Link Parser Skill

**kb-link-parser** - 从各种平台 URL 中提取和解析 ID。

## 什么时候使用

- kb-workflow 步骤 1：解析用户提供的链接
- 需要判断链接属于哪个平台、什么类型的内容

## 功能

- 多平台支持：Bilibili、YouTube、知乎、小红书
- 短链接解析：b23.tv、xhslink.com 等
- 多种内容类型：video、article、question、answer 等
- 批量处理支持
- JSON 输出格式

## 命令

```bash
# 解析单个 URL
python3 link-parser.py --url "https://www.bilibili.com/video/BV1xx411c7mD"

# 批量处理
python3 link-parser.py --batch urls.txt --output results.json

# 指定输出格式
python3 link-parser.py --url "..." --format json
```

## 输出格式 Schema

### 必需字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `success` | boolean | 是否解析成功 |
| `platform` | string | 平台名称（成功时必需） |
| `type` | string | 内容类型（成功时必需） |
| `id` | string | 内容 ID（成功时必需） |
| `error` | string | 错误信息（失败时必需） |

### 可选字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `filename` | string | 建议的文件名 |
| `message` | string | 描述信息 |

## 成功示例

### B站视频

```json
{
  "success": true,
  "platform": "bilibili",
  "type": "video",
  "id": "BV1xx411c7mD",
  "filename": "bilibili_BV1xx411c7mD.link.json",
  "message": "URL解析成功"
}
```

### B站专栏

```json
{
  "success": true,
  "platform": "bilibili",
  "type": "article",
  "id": "cv43780186",
  "filename": "bilibili_cv43780186.link.json",
  "message": "URL解析成功"
}
```

### 知乎问答

```json
{
  "success": true,
  "platform": "zhihu",
  "type": "question",
  "id": "266309957",
  "filename": "zhihu_266309957.link.json",
  "message": "URL解析成功"
}
```

### 知乎专栏文章

```json
{
  "success": true,
  "platform": "zhihu",
  "type": "zhuanlan",
  "id": "1894054073625461813",
  "filename": "zhihu_1894054073625461813.link.json",
  "message": "URL解析成功"
}
```

### 知乎视频

```json
{
  "success": true,
  "platform": "zhihu",
  "type": "zvideo",
  "id": "123456789",
  "filename": "zhihu_123456789.link.json",
  "message": "URL解析成功"
}
```

### 小红书笔记

```json
{
  "success": true,
  "platform": "xiaohongshu",
  "type": "note",
  "id": "abc123",
  "filename": "xiaohongshu_abc123.link.json",
  "message": "URL解析成功"
}
```

## 错误示例

### 不支持的平台

```json
{
  "success": false,
  "error": "Unsupported URL format",
  "detail": "URL: https://example.com/video/123"
}
```

### 无效 URL

```json
{
  "success": false,
  "error": "解析失败",
  "detail": "URL: not-a-valid-url"
}
```

## 支持的平台和类型

| 平台 | 类型 | URL 示例 |
|------|------|----------|
| bilibili | video | `bilibili.com/video/BVxxx` |
| bilibili | article | `bilibili.com/read/cvxxx` |
| bilibili | up主 | `space.bilibili.com/12345` |
| bilibili | favlist | `space.bilibili.com/123/favlist?fid=xxx` |
| zhihu | question | `zhihu.com/question/123` |
| zhihu | answer | `zhihu.com/question/123/answer/456` |
| zhihu | zhuanlan | `zhuanlan.zhihu.com/p/123` |
| zhihu | zvideo | `zhihu.com/zvideo/123` |
| xiaohongshu | note | `xiaohongshu.com/explore/xxx` |
| youtube | video | `youtube.com/watch?v=xxx` |

## 安装

```bash
cp -r kb-link-parser/ ~/.openclaw/skills/
pip install requests
```

## 在 kb-workflow 中的使用

```bash
# 步骤 1：链接解析
python3 ~/.openclaw/skills/kb-link-parser/link-parser.py --url "[用户提供的URL]"

# 解析输出后：
# - 检查 success 字段
# - 提取 platform, type, id
# - 生成 pending/{platform}_{id}.link.json
# - 进入步骤 2（元数据提取）
```