红果短剧市场周报

用途

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

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

数据源

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

运行方式

在 skills/hongguo-weekly-report 目录下运行：

python3 scripts/generate_weekly_report.py

常用参数：

# 指定历史周（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），无需安装第三方包。

生成报告的结构

脚本会自动生成以下章节：

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

使用约束

报告中所有数字必须来自 API 返回，不得编造剧名、名次或指数。
热播指数按原始整数展示（如 11627），不要自行换算成"万"。
若 API 返回异常（网络失败、503、404），如实向用户说明失败原因与重试建议，不要用旧数据冒充。
用户问"最近怎么样"时默认生成最新一周；问具体周时用 --week 参数。
如用户想基于周报进一步评估某个新选题，可额外调用 /v1/score（POST，body 形如 {"genre":"都市爱情","tags":["打脸虐渣","逆袭"],"timing":"new"}）给出选题评分，并在回答中引用评分结果。

输出示例

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

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

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

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