| name | playlet-wechat-feed |
| description | 短剧-公众号信息源 — 每日扫描公众号短剧爆款文章,按阅读量筛选热门内容,智能聚类题材方向后生成包含封面图、互动数据与创作洞察的HTML日报。支持按题材(穿越/霸总/重生等)、公众号、时间范围定向查询。⚠️数据每日15:00更新前一天数据,目标日期无数据时必须先告知用户并等待确认后才能调用接口,禁止自动获取。当用户需要短剧公众号日报、公众号短剧爆款、短剧热点、短剧创作趋势或自定义题材查询时使用。 |
短剧-公众号信息源
📝 简介
短剧-公众号信息源是一款专为短剧创作者和内容运营设计的公众号爆款追踪工具,每日自动扫描公众号短剧内容,按阅读量筛选热门作品,智能聚类题材方向后生成可视化 HTML 日报与创作趋势分析。
通过简单的指令,你可以:
- 🔥 发现当日公众号短剧爆款文章
- 📊 获取按题材智能聚类的热门内容
- 📈 分析爆款标题特征与创作趋势
- 🔔 开启每日订阅,自动产出日报
适用于短剧编剧、内容运营、MCN 机构、公众号号主等需要追踪公众号短剧热点的场景。
⚠️ 重要提醒:数据每日 15:00 更新前一天数据,目标日期无数据时必须先告知用户并等待确认后才能调用接口,禁止自动获取。
✨ 功能特性
🎯 核心功能
| 功能模块 | 能力描述 | 核心价值 |
|---|
| 爆款发现 | 从公众号短剧文章中按阅读量筛选热门内容 | 精准定位高热度短剧作品 |
| 题材聚类 | 自动识别题材方向(穿越/霸总/重生/悬疑等) | 每天题材分类由内容动态决定 |
| 智能查询 | 默认查询全部短剧,数据不足时自动扩展题材批量查询 | 节省接口额度,高效获取数据 |
| 自定义查询 | 用户可指定任意题材/公众号/关键词定向查询 | 灵活覆盖任意短剧细分方向 |
| 创作洞察 | 分析爆款标题特征、题材趋势、公众号表现 | 深度挖掘创作规律 |
| 可视化日报 | 深色主题HTML,封面图+互动数据(为0时隐藏)+文章直链 | 直观展示每日短剧热点 |
| 一键订阅 | --subscribe 开启每日自动产出 | 日报自动攒在本地文件夹 |
✨ 技术亮点
- ⚡ 批量查询:所有题材通过批量接口一次性查询,节省接口调用次数
- 🧠 智能聚类:9 大题材自动分类(穿越/霸总/重生/悬疑/甜宠/逆袭/年代/战神/古装)
- 🔒 安全接入:通过 API Key 鉴权,无需账号密码
- 📅 日期智能判断:脚本内置
DATA_UPDATE_HOUR = 15 常量,自动检测目标日期有效性
- 💾 缓存机制:1 小时有效期,避免重复扣费
🔑 安装配置
前置条件
- Python 3 运行环境
- 红狐Hub API Key(前往 红狐Hub 官网 注册获取,格式为
ak_xxxxxxxx)
环境变量配置
数据查询接口通过请求头 X-API-KEY 鉴权,Key 从环境变量 REDFOX_API_KEY 获取。
| 变量名 | 必填 | 说明 |
|---|
REDFOX_API_KEY | 是 | 红狐Hub API 访问密钥 |
配置方式:
- macOS/Linux:将
export REDFOX_API_KEY=<值> 追加到 ~/.zshrc 或 ~/.bashrc,然后 source 使其生效
- Windows:
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User")(需重启终端)
- 配置后验证:
echo $REDFOX_API_KEY(macOS/Linux)或 echo %REDFOX_API_KEY%(Windows)
查询接口调用时通过 source 字段同步记录（值为 短剧公众号信息源-GitHub），无需额外请求保存接口。
📖 使用指南
基础使用
1. 日期有效性预检(必须执行,先于任何接口调用)
⛔ 核心规则:未经用户确认,禁止调用任何数据接口,禁止自动执行 --latest
数据更新规则:每日 15:00 更新前一天的数据
- 15:00 前:最新可用日期 = T-2(前天)
- 15:00 后:最新可用日期 = T-1(昨天)
执行流程(每次查询前强制执行):
- 获取当前系统日期 T 和当前时间,按 15:00 规则计算最新可用日期
- 判断用户请求的目标日期是否在无数据区间(即 > 最新可用日期)
- 若目标日期有数据(≤ 最新可用日期):直接执行第 2 步,无需额外确认
- 若目标日期无数据(> 最新可用日期),向用户输出提示并等待用户明确确认后才能继续:
**⚠️{查询日期}数据尚未更新**
数据更新规则:每日15:00更新前一天的数据
当前可查询的最新日期:{最新可查询到数据的日期}
是否需要查询{最新可查询到数据的日期}的数据?
- 若用户拒绝,则不执行任何接口调用
示例对话:
用户:查询今天的短剧公众号日报
Agent:⚠️2026-06-16数据尚未更新
数据更新规则:每日15:00更新前一天的数据
当前可查询的最新日期:2026-06-14
是否需要查询2026-06-14的数据?
用户:好的
Agent:(执行 python3 daily_report.py --latest)
2. 生成爆款日报
python3 "$SKILL_PATH/assets/daily_report.py" --latest
python3 "$SKILL_PATH/assets/daily_report.py" --date 2026-06-10
python3 "$SKILL_PATH/assets/daily_report.py" --topics "穿越,霸总,重生,悬疑" --latest
python3 "$SKILL_PATH/assets/daily_report.py" --subscribe
python3 "$SKILL_PATH/assets/daily_report.py" --unsubscribe
查询策略:默认查询全部短剧内容(pageSize=200),数据不足时自动追加热门题材(穿越→霸总→重生→悬疑→甜宠→逆袭),所有题材通过批量接口一次性查询,无需逐个调用。用户自定义题材时仅使用用户提供的列表,同样批量查询。
3. 创作趋势分析
日报生成后,必须基于聚类结果自动执行创作趋势分析:
- 读取题材聚类结果,选取 TOP 5 热门题材
- 分析每个题材的爆款数量、平均互动数据、头部作品特征
- 识别新兴起量题材(数量少但互动高)
- 输出结构化创作趋势报告
生成的 HTML 日报保存在 ~/Downloads/QoderReports/,自动浏览器打开。终端同步输出题材分类表格 + 创作趋势分析报告。
高级使用
自定义题材查询
除默认短剧日报外,用户可指定任意题材组合进行定向查询:
python3 "$SKILL_PATH/assets/daily_report.py" --topics "穿越,时空,重生"
python3 "$SKILL_PATH/assets/daily_report.py" --topics "霸总,甜宠,总裁,虐恋"
python3 "$SKILL_PATH/assets/daily_report.py" --topics "悬疑,推理,反转,惊悚"
自定义查询逻辑:
- 用户提供的所有题材通过批量接口一次性查询,无需逐个调用
- 查询结果自动去重,题材聚类、趋势分析均基于查询结果生成
时间范围查询
python3 "$SKILL_PATH/assets/daily_report.py" \
--start-time "2026-06-01 00:00:00" \
--end-time "2026-06-30 23:59:59"
python3 "$SKILL_PATH/assets/daily_report.py" \
--start-time "2026-06-10 00:00:00" \
--end-time "2026-06-17 23:59:59"
订阅功能
python3 "$SKILL_PATH/assets/daily_report.py" --subscribe
python3 "$SKILL_PATH/assets/daily_report.py" --unsubscribe
命令速查
| 命令/参数 | 功能 | 默认值 |
|---|
--latest | 自动使用最新有数据的日期,跳过无数据区间 | — |
--date YYYY-MM-DD | 指定日期查询(若无数据会提示并询问切换) | 今天 |
--topics "题材1,题材2" | 自定义题材关键词,逗号分隔 | 短剧 |
--start-time | 自定义开始时间 YYYY-MM-DD HH:MM:SS | — |
--end-time | 自定义结束时间 YYYY-MM-DD HH:MM:SS | — |
--count N | 扫描文章数量,满足即停 | 200 |
--output-dir | 输出目录 | ~/Downloads/QoderReports |
--api-key | 指定 API Key(覆盖环境变量) | — |
--subscribe | 开启每日订阅 | — |
--unsubscribe | 关闭每日订阅 | — |
📊 输出格式(强制执行)
⛔ 严格执行规则:
- 以下模板是唯一合法输出格式,禁止任何自由发挥、省略、简化或重新组织
- 禁止输出模板中未定义的额外内容(如"我来帮你…""以下是…"等口语化文字)
- 禁止合并、跳过任何板块,即使某板块数据为"暂无"也必须保留该板块标题
- 日报生成后,对话回复只能包含以下内容,不得包含其他任何文字
每次运行日报后,对话输出必须严格按以下模板原样输出(仅替换 {...} 占位符):
## 短剧-公众号信息源 · {日期} 日报
**扫描 {N} 篇热门短剧文章,聚类 {M} 个题材方向**
---
### 题材概览
| 题材 | 数量 | 占比 | 爆款亮点 |
|------|------|------|---------|
| #{题材名} | {N}篇 | {X}% | 《{头部作品标题}》{阅读数}阅读，{该题材当日内容特征简述} |
| ... | ... | ... | ... |
---
### 创作趋势分析
**一、新兴起量信号**
- 🔥 **#{题材}** — 仅{N}篇但{核心互动指标描述(如:均阅读X+、点赞率X%等)}，{起量原因/内容特征分析}
(若无新兴起量信号，输出：暂无新兴起量信号)
> 新兴起量判断标准：作品数≤3篇但头部阅读超过大盘均值，或互动率(点赞/阅读)显著高于其他题材
**二、爆款标题特征**
| 特征模式 | 出现次数 | 典型案例 | 平均阅读 |
|---------|---------|---------|---------|
| {标题结构特征描述(如:感叹号情绪钩子（！）、"N部"清单推荐体、AI+工具/平台名等)} | {N}次 | 《{标题}》 | {X} |
| ... | ... | ... | ... |
(若无标题数据，输出：暂无爆款标题数据)
> 标题特征分析维度：标点符号使用(！/？/…)、数字清单体(N部/N条)、关键词类型(AI/明星/工具)、情绪钩子结构(反差词/悬念词/承诺词)
**三、核心公众号榜**
| 公众号 | 作品数 | 总阅读 | 代表作 |
|--------|--------|--------|--------|
| @{公众号} | {N}篇 | {X}w | 《{作品}》 |
| ... | ... | ... | ... |
(若无公众号数据，输出：暂无核心公众号数据（本日接口未返回 accountName 字段）)
**四、题材趋势报告**
**题材**：#{题材1}
**作品数**：{N}篇
**平均阅读**：{X}
**头部作品**：《{标题}》— {阅读}阅读
**题材特征**：{基于当日数据描述该题材的内容形态、标题特征、受众画像、流量天花板等}
**创作建议**：{基于数据给出可执行的创作方向、标题公式、题材融合建议等}
**五、#{题材2}**
(同上格式)
**六、#{题材3}**
(同上格式)
> 题材趋势报告选取 TOP 3 题材(排除"其他")逐一展开分析，每个题材必须包含「题材特征」和「创作建议」两个子模块
**七、跨题材对比建议**
- **{题材A} × {题材B}** — {两题材的联动创作建议，基于当日数据中发现的跨题材信号}
- **{主题线索(如:AI短剧)} × 全题材** — {当日数据中发现的跨题材共性趋势及创作机会}
(若无建议，输出：暂无跨题材对比建议)
---
**日报地址**：{HTML文件绝对路径}
> 数据说明：每日15:00更新昨天的数据
以上格式为强制规范,所有字段不可省略,板块标题(一、二、三、四、五、六、七)必须保留。若某模块无数据则在该板块内标注"暂无",不得删除板块本身。
输出质量要求：
- 题材概览的「爆款亮点」必须包含该题材当日的内容特征简述,不能仅列出头部作品
- 爆款标题特征必须基于实际数据归纳,特征模式需具体可操作(如"感叹号情绪钩子"而非"情绪化标题")
- 题材趋势报告的「题材特征」和「创作建议」必须基于当日数据,不能套用通用描述
- 跨题材对比建议必须从当日数据中发现真实联动信号,不能凭空推测
- HTML 日报中各项互动数据（阅读量 👁 / 点赞数 👍 / 评论数 💬）为 0 时不展示该字段，只展示有实际数据的指标
🎯 使用场景
场景一:短剧编剧选题调研
角色:短剧编剧
需求:了解当前公众号短剧哪些题材最火,为下一部作品选题
使用方式:
- 运行默认日报,查看题材概览和趋势分析
- 关注新兴起量信号,发现蓝海题材
- 分析爆款标题特征,学习流量密码
预期收益:精准把握题材风口,提升选题命中率
场景二:内容运营日报追踪
角色:公众号运营 / MCN 运营
需求:每日追踪短剧公众号爆款,形成团队内部情报
使用方式:
- 开启
--subscribe 订阅,每日自动产出日报
- 按题材查询(
--topics "穿越,霸总")聚焦团队关注方向
- 分析核心公众号榜,发现优质对标账号
预期收益:建立团队短剧情报体系,驱动内容决策
场景三:竞品分析
角色:品牌方 / 投放经理
需求:监测竞品公众号的短剧推广表现
使用方式:
- 用
--topics 查询竞品相关关键词
- 分析竞品题材分布和阅读数据
- 对比自身与竞品的题材布局差异
预期收益:及时调整投放策略,优化内容差异化
场景四:创作趋势复盘
角色:内容总监 / 数据分析师
需求:复盘一段时间内的短剧创作趋势变化
使用方式:
- 使用
--start-time 和 --end-time 查询指定时间段
- 对比不同日期的题材分布和爆款特征
- 识别持续增长题材和衰退题材
预期收益:掌握中长期趋势,指导内容战略规划
🏗️ 项目架构
目录结构
短剧-公众号信息源/
├── SKILL.md # 主文档(Skill 定义)
├── README.md # 快速开始指南
├── assets/
│ └── daily_report.py # 主脚本
├── scripts/
│ └── playlet_wechat_daily.py # 脚本副本
└── references/
├── core_workflow.md # 核心执行流程、日期预检、输出格式模板、错误处理
└── examples.md # 使用示例与常见用法组合
技术栈
| 组件 | 技术 | 说明 |
|---|
| 运行环境 | Python 3 | 脚本语言 |
| 数据源 | 红狐Hub API | 公众号短剧数据接口 |
| 鉴权方式 | X-API-KEY | 请求头鉴权 |
| 输出格式 | HTML/CSS | 深色主题可视化日报 |
| 缓存机制 | JSON 文件 | 1 小时有效期 |
平台适配说明
本 skill 基于"短剧-抖音信息源"改造,针对公众号平台做了以下核心适配:
| 维度 | 抖音版本 | 公众号版本(本 skill) |
|---|
| 平台标识 | platform: 1 | platform: 0 |
| 核心指标 | 点赞量(likeCount) | 阅读量(readCount) |
| 账号字段 | userName | accountName |
| 展示指标 | 点赞、评论、分享 | 阅读(👁)、点赞(👍)、评论(💬)，为0时隐藏该字段 |
| 主题色 | 粉色 #FB7299 | 绿色 #07C160 |
| 图标 | 🔗👍⭐ | 👁👍💬 |
| 文件命名 | 短剧抖音日报 | 短剧公众号日报 |
| 缓存文件 | playlet_douyin_data.json | playlet_wechat_data.json |
核心代码差异:
保持一致的部分:日期预检机制、数据更新规则、批量查询策略、题材聚类算法、去重机制、缓存机制、输出格式模板、订阅功能、创作趋势分析逻辑。
注意事项:
- API 接口使用相同端点
https://redfox.hk/story/api/parseWork/queryPlayletMsgs
- 必须设置
platform: 0 才能获取公众号数据
- 公众号和抖音使用不同的缓存文件,互不干扰
❓ 常见问答
安装相关
Q1: API Key 怎么获取?
A: 前往 红狐Hub 官网 注册,登录后在个人中心获取,格式为 ak_xxxxxxxx。新注册用户获赠免费积分。
Q2: 配置了 API Key 但提示无效?
A: 请检查:
- Key 是否已正确复制(前后无空格)
- Windows 下需重启终端使环境变量生效
- 确认 Key 格式为
ak_ 开头
使用相关
Q3: 为什么查询今天的数据提示无数据?
A: 数据每日 15:00 更新前一天数据。15:00 前最新可查为前天,15:00 后为昨天。脚本会提示最新可查日期并询问是否切换。
Q4: 可以查询哪些题材?
A: 脚本内置 9 大题材分类:穿越、霸总、重生、悬疑、甜宠、逆袭、年代、战神、古装。你也可以通过 --topics 传入任意自定义关键词。
Q5: 默认查询和自定义题材查询有什么区别?
A: 默认查询全部短剧内容(pageSize=200),数据不足时自动追加热门题材;自定义查询仅使用你提供的题材列表,同样批量查询。
故障排除
Q6: 脚本报错 UnicodeEncodeError 怎么办?
A: Windows 下需设置环境变量 PYTHONIOENCODING=utf-8,可在命令前加上 $env:PYTHONIOENCODING='utf-8';。
Q7: 接口返回错误码?
A: 常见错误码对照:
| 错误码 | 含义 | 解决方式 |
|---|
| 1002 | 每页条数超过 200 | 脚本自动限制,无需处理 |
| 3106 | 缺少 API Key | 配置 REDFOX_API_KEY 环境变量 |
| 3107 | API Key 无效 | 检查 Key 格式和有效性 |
| 3108 | 请求过于频繁 | 等待后重试 |
| 3109 | 今日调用达上限 | 次日再试 |
| 3201 | 积分不足 | 前往红狐Hub 充值 |
获取帮助
如有其他问题,可查看参考文档:
📋 真实输出示例（2026-06-15）
以下为完整日报输出的真实样例，供 Agent 参考输出深度与格式规范。
短剧-公众号信息源 · 2026-06-15 日报
扫描 176 篇热门短剧文章，聚类 6 个题材方向
题材概览
| 题材 | 数量 | 占比 | 爆款亮点 |
|---|
| #其他 | 156篇 | 88.6% | 《价值升维，短剧与明星双向奔赴的2.0时代》2.3w阅读，AI短剧工具类内容大量涌现 |
| #甜宠 | 7篇 | 4.0% | 《热植物语》温馨睡前故事，均阅读800+，受众稳定 |
| #霸总 | 6篇 | 3.4% | 克拉拉转型短剧演员引热议，单篇最高4905阅读 |
| #悬疑 | 3篇 | 1.7% | 《短剧男演员去世真相》3801阅读，八卦向内容互动强 |
| #穿越 | 3篇 | 1.7% | 陕西短剧基地千万实景遇冷，产业观察类内容受关注 |
| #古装 | 1篇 | 0.6% | 《古装发型提示词，附图》1058阅读，AI创作辅助类单篇爆发 |
创作趋势分析
一、新兴起量信号
- 🔥 #古装 — 仅1篇但点赞率达3.6%（38赞/1058阅读），AI辅助创作类工具内容互动远超均值，提示词/工作流类内容有持续爆发潜力
- 🔥 #悬疑 — 仅3篇但头部阅读达3801，八卦揭秘+短剧圈内幕的组合标题互动效率高于大盘均值
二、爆款标题特征
| 特征模式 | 出现次数 | 典型案例 | 平均阅读 |
|---|
| 感叹号情绪钩子（！） | 93次 | 《OiiOii 2.0重磅升级，短剧带货真的要杀疯了...》 | 1374 |
| 疑问号悬念钩子（？） | 55次 | 《长短剧边界消融，演员在千亿短剧新局有何机遇？》 | 1325 |
| "N部"清单推荐体 | 13次 | 《5部高分上头短剧合集！霸总甜宠、都市治愈》 | 1072 |
| AI+工具/平台名 | 15次 | 《全网7亿播放的AI短剧，背后的神级制作工具我找到了！》 | 约6500 |
三、核心公众号榜
暂无核心公众号数据（本日接口未返回 accountName 字段）
四、题材趋势报告
题材：#甜宠
作品数：7篇
平均阅读：约900
头部作品：《热植物语》迪克羊仔（温馨甜宠睡前故事）— 1258阅读
题材特征：甜宠题材以"睡前故事""情头""宝藏剧推荐"为主要内容形态，标题普遍带有"甜""治愈""圆满"等情绪关键词，受众黏性高但流量天花板较低，阅读规模整体偏中腰部。
创作建议：可结合"CP向"二创内容、"甜宠+其他题材"复合标签（如甜宠×古装、甜宠×穿越）破圈，标题加入"闭眼追""宝藏""结局超甜"等完结承诺类钩子提升点击。
五、#霸总
题材：#霸总
作品数：6篇
平均阅读：约2911
头部作品：《"亚洲第一美女"克拉拉，被豪门抛弃，转型当短剧演员！》— 4905阅读
题材特征：霸总题材本日热度主要由"明星入局短剧"的八卦新闻驱动，而非传统霸总剧情推荐。"豪门""转型""被抛弃"等反差词构成核心流量钩子，汉南拍摄地话题也带动了在地化传播。
创作建议：可借势明星/演员话题切入霸总题材，标题结构采用"身份反差+转折"公式（如"被XX抛弃，转型XX"），同时结合"高分合集""上头短剧"清单体做长尾流量。
六、#悬疑
题材：#悬疑
作品数：3篇
平均阅读：约2047
头部作品：《短剧男演员去世真相，安以轩复出，侯明昊被拉出试水…》— 3801阅读
题材特征：悬疑题材本日以"圈内八卦+真相揭秘"形式呈现，标题普遍采用多个明星名串联+悬念问号的钩子结构；另有银发反诈AI微短剧（1718阅读）等政策向内容，整体数量少但单篇互动高于大盘均值。
创作建议：悬疑题材公众号端更适合"内幕揭秘""真相还原"等非虚构方向，标题可堆叠多个名人/事件名制造信息密度感，同时关注"反诈""社会议题"等政策风口，容易获得平台流量加持。
七、跨题材对比建议
- #霸总 × #甜宠 — 建议同步关注"霸总甜宠"复合标签的联动创作，本日《5部高分上头短剧合集！霸总甜宠、都市治愈》（2606阅读）已验证融合题材的合集形式有效，可进一步拆解两题材受众重叠度
- #AI短剧（其他类内隐主题）× 全题材 — 本日38篇AI短剧相关内容均阅读2630，远超大盘1994均值，AI工具+任意题材的"制作教程/工具测评"方向是当前显著流量洼地，建议各题材创作者关注AI制作工作流内容
日报地址：C:\Users\马祯\Downloads\QoderReports\短剧公众号日报_2026-06-15.html
数据说明：每日15:00更新昨天的数据
