B站评论分析

SKILL.md

---
name: bilibili-comment
description: B站评论分析工具。输入B站视频链接或BV号即可获取一级评论数据，支持分页浏览、评论情感分析（积极/负面/需求/竞品），生成精美 HTML 报告。当用户需要查看B站视频评论、分析评论舆情、了解用户反馈时使用。触发词：B站评论、B站视频评论、评论查询、评论分析、评论舆情、看评论、bilibili评论。
---

# B站评论分析

## 简介

B站评论分析是一款专为内容创作者、UP主、品牌运营和研究人员设计的智能评论洞察工具。输入任意B站视频链接或BV号，即可一键获取评论数据，并通过四维情感分析（积极/负面/需求/竞品）快速了解用户真实反馈，同时生成可离线保存的交互式 HTML 报告。

通过本技能，你可以：
- 📊 逐页获取视频一级评论（每页20条，支持翻页）
- 🤖 AI 自动完成四维情感分析，理解B站梗文化
- 📋 生成深色主题交互式 HTML 报告，便于保存与分享

适用于 UP主复盘、品牌舆情监测、竞品分析、内容策略研究等场景。

## 功能特性

### 核心功能

- **评论获取**：粘贴视频链接或BV号即可拉取最新评论数据
- **分页浏览**：每页20条，支持前后翻页，逐步浏览大量评论
- **四维 AI 分析**：积极/负面/需求/竞品四类情感分析，各维度附代表评论引用
- **置顶标记**：置顶评论特殊标识，一眼识别重要内容
- **HTML 报告**：深色主题交互式报告，支持离线保存与分享

### 特色亮点

- **B站梗文化理解**：识别弹幕术语、缩写（awsl / yyds / xswl / 爷青回 等）及热门梗的真实语境
- **数据完整展示**：作品详情（播放/点赞/投币/收藏/弹幕等）与评论表格全量展示，不截断
- **编码安全回填**：智能编码保障，中文分析内容完整无误地注入报告

## 鉴权

- 获取 API Key：前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub)
- 配置方式1：写入 `~/.openclaw/openclaw.json` → `{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }`
- 配置方式2：终端执行 `export REDFOX_API_KEY="ak_xxxx..."`

## 工作流程

> 核心执行流程详见 `references/core_workflow.md`

## 使用指南

直接用自然语言说出视频链接或BV号即可，无需记忆固定命令。

### 常用说法速查

| 意图 | 示例话术 | 效果 |
|------|---------|------|
| 查看视频评论 | 「查看B站视频 BV1xx411c7mD 的评论」 | 获取第1页评论 + AI总结 |
| 通过链接查询 | 粘贴 `https://www.bilibili.com/video/BV1xx411c7mD` | 自动提取BV号并拉取评论 |
| 翻页 | 「下一页」「第3页」 | 沿用当前视频，获取指定页评论 |
| 生成报告 | 「需要」「生成HTML」 | 回填AI分析，生成交互式HTML报告 |

### 输出示例

完成查询后，你将依次收到：

1. **作品详情**（标题、UP主、播放量、点赞等核心数据）
2. **评论表格**（当前页全部评论，含昵称链接、内容、点赞数、时间、IP属地）
3. **四维情感分析**（积极/负面/需求/竞品，各附代表评论）
4. **询问是否生成 HTML 报告**

## 使用场景

| 场景 | 角色 | 示例问法 | 收益 |
|------|------|---------|------|
| 内容复盘 | UP主 | 「看看这个视频的评论怎么样」 | 快速了解观众反馈，优化选题策略 |
| 舆情监测 | 品牌运营 | 「分析这条视频的负面评论」 | 及时发现危机信号，制定应对方案 |
| 竞品分析 | 内容策划 | 「分析竞品视频的用户评论」 | 了解竞品优劣势，找准差异化方向 |
| 用户研究 | 产品经理 | 「看看用户在评论区提了哪些需求」 | 挖掘真实需求，指导产品迭代 |

## 项目架构

```
bilibili-comment/
├── SKILL.md                    # 技能配置与使用说明
├── references/
│   └── core_workflow.md        # Agent 核心执行流程
├── assets/
│   └── report_template.html    # HTML 报告模板
└── scripts/
    ├── bili_comment_search.py  # 评论获取脚本（调用 API，自动生成 HTML）
    └── backfill_html.py        # AI 分析回填脚本（将分析结果写入 HTML）
```

| 模块 | 职责 |
|------|------|
| `bili_comment_search.py` | 调用红狐 API 获取评论数据，生成含占位符的 HTML 报告 |
| `backfill_html.py` | 将 AI 四维分析 JSON 安全回填至 HTML 报告，支持文件直读模式 |
| `report_template.html` | 深色主题交互式报告模板 |

技术栈：Python 标准库（`urllib`），无需额外安装依赖。

## 常见问答

### 安装相关

**Q1: 如何获取 REDFOX_API_KEY？**

A: 前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 注册账号并申请 API Key，按鉴权章节说明配置到本地环境变量。

**Q2: 需要安装额外依赖吗？**

A: 不需要。脚本使用 Python 标准库 `urllib`，Python 3.6+ 环境即可直接运行。

### 使用相关

**Q3: 一次能获取多少条评论？**

A: 每次调用获取1页（20条）。如需更多数据，通过翻页命令逐页获取，或前往 [红狐平台](https://redfox.hk/) 联系客服获取批量能力。

**Q4: 支持获取二级评论（回复）吗？**

A: 当前版本仅支持一级评论，二级回复暂不支持。

### 故障排除

**Q5: HTML 报告中部分中文显示乱码（问号）怎么办？**

A: 这是编码回填环节的兼容性问题。解决方案：用 Python 写入分析数据为 UTF-8 JSON 文件，再使用 `backfill_html.py --json-file` 直接读取回填。详见 `references/core_workflow.md` Step 3。

**Q6: 如有其他问题如何获取帮助？**

A: 前往 [红狐平台](https://redfox.hk/) 联系客服，或查阅技能文档。