红果短剧市场周报

问题背景

在短剧内容运营中，快速获取市场动态是关键。从业者常需回答“本周哪些题材爆发？”或“新剧上线表现如何？”，但手动查看官方周榜并整理数据耗时且易错。本技能解决这一痛点，通过自动化数据抓取与分析，生成结构化报告。

核心能力与关键步骤

该技能基于红果短剧官方周榜 API（基地址：https://fxb.chatvideoai.com）工作，数据口径为热播指数（综合播放量、完播率等）。运行时需 Python 3 环境，仅依赖标准库 urllib 和 json，无需额外安装。关键流程包括：

• 根据用户查询（默认最新周或通过 --week 参数指定周数）发起 API 请求获取 TOP50 榜单。
• 解析 JSON 响应，提取剧名、题材、热播指数等字段。
• 生成 Markdown 报告，涵盖九个章节：报告头部、核心洞察、TOP10 排名、题材分布、近 N 周趋势、热门标签、标签组合（如“都市爱情+打脸虐渣”）、新剧观察和排名变动。
• 若需深度评估，可调用 /v1/score 端点（POST 请求，传入题材、标签等参数）获取选题评分，并集成到报告中。

适用边界与注意点

• 数据准确性：所有数字直接取自 API 返回值，严禁编造剧名、名次或指数。热播指数需展示为原始整数（如 11627），不进行单位换算。
• 异常处理：若 API 调用失败（如网络问题或状态码 503/404），报告应如实说明错误原因，避免使用旧数据冒充。
• 定制化：用户可通过参数调整报告内容，例如指定周数或基于报告进一步评估新选题。
• 局限性：技能专注于官方周榜数据分析，不适用于历史深度挖掘或非公开数据；依赖稳定网络连接，且数据更新频率为每周一次。