红果短剧市场周报

技能文档

---
name: hongguozhoubao
title: 红果短剧市场周报
category: 内容创作
description: 基于红果短剧官方周榜数据，自动生成本周短剧市场行情周报，覆盖热播指数、题材分布、TOP 榜单、新剧观察、标签趋势与爆款标签组合，可指定历史周回溯。当用户需要了解最近一周短剧市场整体情况、热播题材、TOP 榜单、新剧爆款、标签趋势、选题方向时触发。触发词：短剧周报、红果短剧、短剧市场、热播题材、短剧榜单、选题方向。
---

# 红果短剧市场周报

根据红果短剧官方周榜（热播指数），自动生成一份结构化 Markdown 市场周报。适合回答这类问题：

- 「本周短剧市场怎么样？」
- 「最近什么题材最火？」
- 「本周 TOP10 是哪些？有什么新剧上榜？」
- 「这个题材/标签组合最近在榜表现如何？」

## 数据源

- API 基地址：`https://fxb.chatvideoai.com`（可用环境变量 `WIND_VANE_API_URL` 覆盖）
- 数据口径：红果官方周榜，周更；数值为**热播指数**（播放量、完播率、搜索量、互动量综合计算），不是原始播放量。
- 榜单每期 TOP50，最新周通常为本周一对应的统计周。

## 技能工作流

### 步骤1：确认统计周

- 用户问「最近怎么样」时默认生成最新一周；用户指定具体周时使用 `--week` 参数（格式 YYYY-MM-DD，须为榜单内存在的周）。
- 需要更长趋势时用 `--trend-weeks` 调整回溯周数（默认 12 周）。

### 步骤2：运行脚本生成周报

在本技能目录下运行：

```bash
python3 scripts/generate_weekly_report.py
```

常用参数：

```bash
# 指定历史周（YYYY-MM-DD，须为榜单内存在的周）
python3 scripts/generate_weekly_report.py --week 2026-08-10

# 指定趋势回溯周数（默认 12 周）
python3 scripts/generate_weekly_report.py --trend-weeks 24

# 输出到文件（默认打印到 stdout）
python3 scripts/generate_weekly_report.py --output /tmp/weekly-report.md

# 输出 JSON 原始数据（供进一步分析）
python3 scripts/generate_weekly_report.py --format json
```

依赖：仅 Python 3 标准库（`urllib` / `json` / `argparse`），无需安装第三方包。

### 步骤3：交付与解读

周报包含以下章节，按需向用户解读要点：

1. **报告头部**：统计周、数据来源、生成时间。
2. **本周核心洞察**：总热播指数、新剧数量、头部题材与占比、最热标签组合、中位数环比。
3. **本周 TOP10**：名次、剧名、题材、当周热播指数、是否新剧。
4. **题材分布**：各题材上榜数量与热播指数合计。
5. **题材趋势（近 N 周）**：各主要题材在榜数量走势。
6. **热门标签**：标签出现次数、平均名次、最佳名次、受众属性。
7. **标签组合（爆款公式）**：高频标签对与组合公式。
8. **新剧观察**：本周新上榜剧目。
9. **排名变动**：较上周上升/下降明显的剧目。

### 步骤4：选题评分（可选）

用户想基于周报进一步评估某个新选题时，可额外调用 `/v1/score`（POST，body 形如 `{"genre":"都市爱情","tags":["打脸虐渣","逆袭"],"timing":"new"}`）给出选题评分，并在回答中引用评分结果。

## 使用约束

- 报告中所有数字必须来自 API 返回，**不得编造**剧名、名次或指数。
- 热播指数按原始整数展示（如 11627），不要自行换算成「万」。
- 若 API 返回异常（网络失败、503、404），如实向用户说明失败原因与重试建议，不要用旧数据冒充。

## 输出示例

```markdown
# 红果短剧市场周报 · 2026-08-10 周

> 数据源：红果短剧官方周榜（热播指数）｜生成时间：2026-08-14

## 本周核心洞察
- 本周 TOP50 合计热播指数 326,569，上榜新剧 8 部。
- 头部题材：女性成长（15 部，占 30%）。
- 最热标签组合：大女主 + 女性成长（11 部）。
- 中位数热播指数 6,164，较上周 +xxx。

## 本周 TOP10
| 名次 | 剧名 | 题材 | 当周热播指数 | 新剧 |
|---|---|---|---|---|
| 1 | ... | ... | ... | 否 |
...
```

使用说明

# 红果短剧市场周报

基于红果短剧官方周榜数据，一键生成本周短剧市场行情周报：核心洞察、TOP 榜单、题材分布与趋势、热门标签组合、新剧观察。

## 使用

对 Agent 说：

```text
生成本周短剧市场周报
看看最近什么短剧题材最火
生成 2026-08-10 那一周的短剧周报
```

命令行直接运行：

```bash
python3 scripts/generate_weekly_report.py                     # 最新一周
python3 scripts/generate_weekly_report.py --week 2026-08-10   # 指定历史周
python3 scripts/generate_weekly_report.py --format json       # 原始数据
```

仅依赖 Python 3 标准库。

## 工作原理

脚本调用红果短剧官方周榜 API（热播指数口径，每周 TOP50），聚合计算总指数、题材占比、标签共现与排名变动，输出结构化 Markdown 周报；所有数字均来自接口返回，不做人工编造。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。