| name | playlet-douyin-feed |
| description | 短剧-抖音信息源 — 每日扫描抖音短剧爆款内容,按点赞量筛选热门短剧,智能聚类题材方向后生成包含封面、互动数据与创作洞察的HTML日报。支持按题材(穿越/霸总/重生等)、达人、时间范围定向查询。⚠️数据每日15:00更新前一天数据,目标日期无数据时必须先告知用户并等待确认后才能调用接口,禁止自动获取。当用户需要短剧抖音日报、抖音短剧爆款、短剧热点、短剧创作趋势或自定义题材查询时使用。 |
短剧-抖音信息源
简介
短剧-抖音信息源是一款专为短剧创作者和MCN运营人员设计的抖音爆款内容追踪工具,每日自动扫描抖音短剧创作内容,按点赞量筛选爆款作品,智能聚类题材后生成HTML可视化日报。
通过简单的自然语言指令,你可以:
- 📊 获取每日抖音短剧爆款榜单与题材分布
- 🏷️ 自动聚类穿越/霸总/重生/悬疑等题材方向
- 📈 生成创作趋势分析报告(爆款标题特征、核心达人榜、新兴起量信号)
- 🔔 开启每日订阅,日报自动产出
适用于短剧创作者选题、MCN机构运营、题材趋势研究等需要每日追踪抖音短剧热点的场景。
重要:数据每日15:00更新前一天数据,目标日期无数据时禁止自动调用接口,必须先告知用户并等待确认。
功能特性
🎯 核心功能
| 功能模块 | 能力描述 | 核心价值 |
|---|
| 爆款发现 | 从抖音短剧中按点赞量筛选热门内容 | 精准定位高热度短剧作品 |
| 题材聚类 | 自动识别题材方向(穿越/霸总/重生/悬疑等) | 每天题材分类由内容动态决定 |
| 智能查询 | 默认查询全部短剧,数据不足时自动扩展题材批量查询 | 节省接口额度,高效获取数据 |
| 自定义查询 | 用户可指定任意题材/达人/关键词定向查询 | 灵活覆盖任意短剧细分方向 |
| 创作洞察 | 分析爆款标题特征、题材趋势、达人表现 | 深度挖掘创作规律 |
| 可视化日报 | 深色主题HTML,封面图+互动数据+作品直链 | 直观展示每日短剧热点 |
| 一键订阅 | --subscribe 开启每日自动产出 | 日报自动攒在本地文件夹 |
✨ 特色亮点
- ⚡ 每日自动更新:15:00自动更新前一天数据,订阅后无需手动操作
- 🏷️ 智能题材聚类:内置6大题材关键词库(穿越/霸总/重生/悬疑/甜宠/逆袭),自动识别归类
- 📊 创作趋势报告:自动分析新兴起量信号、爆款标题特征、核心达人榜
- 🎨 HTML深色主题日报:封面图+互动数据+作品直链,美观直观,自动浏览器打开
- 💰 API积分优化:批量查询+1小时缓存,节省接口调用额度
一键安装
前置条件
- 已安装 Python 3 运行环境
- 获取红狐Hub API Key
API Key 获取
数据查询接口通过请求头 X-API-KEY 鉴权,Key 从环境变量 REDFOX_API_KEY 获取。
前往 红狐Hub 官网 注册,登录后在个人中心获取,格式为 ak_xxxxxxxx。新注册用户获赠免费积分。
环境变量配置
| 变量名 | 必填 | 说明 |
|---|
REDFOX_API_KEY | 是 | 红狐Hub API 访问密钥,格式 ak_xxxxxxxx |
配置方式:
- 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)
使用指南
基础使用
1. 查询每日短剧爆款日报
直接告诉助手你想查看的日报:
用户:查询今天的短剧抖音日报
助手:⚠️2026-06-18数据尚未更新,当前可查询的最新日期:2026-06-16,是否查询?
用户:好的
助手:(生成日报 + 输出题材概览 + 创作趋势分析)
2. 按题材定向查询
指定你关注的题材方向:
用户:查询穿越题材的短剧
助手:(生成穿越题材定向日报 + 趋势分析)
3. 查询历史日期
用户:查询6月10日的短剧日报
助手:(历史日期已有数据,直接生成日报)
高级使用
4. 多题材组合查询
python3 scripts/playlet_douyin_daily.py --topics "穿越,霸总,重生" --latest
5. 按时间范围查询
python3 scripts/playlet_douyin_daily.py \
--start-time "2026-06-01 00:00:00" \
--end-time "2026-06-30 23:59:59"
6. 开启每日订阅
python3 scripts/playlet_douyin_daily.py --subscribe
7. 使用缓存数据
python3 scripts/playlet_douyin_daily.py --from-cache
常用命令速查
| 命令 | 功能 |
|---|
--latest | 生成最新一期日报(自动跳过无数据日期) |
--date YYYY-MM-DD | 生成指定日期日报 |
--topics "关键词" | 自定义题材查询(逗号分隔) |
--count N | 扫描作品数量(默认200) |
--subscribe | 开启每日订阅 |
--unsubscribe | 关闭每日订阅 |
--from-cache | 使用缓存数据(1小时内有效) |
--output-dir | 自定义输出目录 |
完整参数说明
| 参数 | 说明 | 默认值 |
|---|
--topics | 自定义题材关键词,逗号分隔。默认查询全部短剧,数据不足时自动扩展题材;所有题材通过批量接口查询 | 短剧 |
--count | 扫描作品数量,满足即停 | 200 |
--date | 指定日期 YYYY-MM-DD(若无数据会提示并询问切换) | 今天 |
--start-time | 自定义开始时间 YYYY-MM-DD HH:MM:SS(覆盖 --date 推算) | — |
--end-time | 自定义结束时间 YYYY-MM-DD HH:MM:SS(覆盖 --date 推算) | — |
--latest | 自动使用最新有数据的日期,跳过无数据区间,不扣积分 | — |
--output-dir | 输出目录 | ~/Downloads/QoderReports |
--api-key | 指定 API Key | — |
--subscribe | 开启每日订阅 | — |
--unsubscribe | 关闭每日订阅 | — |
工作流程
详细执行流程(日期预检规则、脚本调用、强制输出格式模板、题材聚类规则、创作趋势分析逻辑)请参阅 core_workflow.md
工作流程分为三步:
- 第零步 — 日期有效性预检:按15:00规则判断目标日期是否有数据,无数据时必须先告知用户并等待确认,禁止自动调用接口
- 第一步 — 生成爆款日报:执行
playlet_douyin_daily.py 脚本,支持 --latest、--date、--topics 等参数
- 第二步 — 执行创作趋势分析:基于聚类结果自动分析TOP 5题材、爆款标题特征、核心达人榜,输出结构化趋势报告
自定义题材查询
除默认短剧日报外,用户可指定任意题材组合进行定向查询:
python3 scripts/playlet_douyin_daily.py --topics "穿越,时空,重生"
python3 scripts/playlet_douyin_daily.py --topics "霸总,甜宠,总裁,虐恋"
python3 scripts/playlet_douyin_daily.py --topics "悬疑,推理,反转,惊悚"
自定义查询逻辑:
- 用户提供的所有题材通过批量接口一次性查询,无需逐个调用
- 查询结果自动去重,题材聚类、趋势分析均基于查询结果生成,与用户关注方向强关联
题材关键词速查:
| 题材类型 | 典型关键词 |
|---|
| 穿越 | 穿越、时空、古代、现代、回到 |
| 霸总 | 霸总、总裁、豪门、冷酷 |
| 重生 | 重生、逆袭、回到、翻盘 |
| 悬疑 | 悬疑、推理、反转、惊悚、谜案 |
| 甜宠 | 甜宠、恋爱、撒糖、甜蜜、宠溺 |
| 逆袭 | 逆袭、翻身、打脸、崛起 |
使用场景
场景一:短剧创作者选题参考
角色:短剧编剧/导演
需求:了解当前哪些题材和标题模式最容易出爆款
使用方式:
- 每日查询短剧爆款日报,查看题材概览
- 重点关注「新兴起量信号」和「爆款标题特征」
- 结合自身优势选择题材方向
预期收益:精准把握流量风口,提升作品爆款概率
场景二:MCN机构运营管理
角色:MCN运营总监
需求:追踪旗下达人和竞品在抖音短剧赛道的表现
使用方式:
- 查看「核心达人榜」了解头部达人动态
- 按题材定向查询,分析各赛道竞争格局
- 开启每日订阅,日报自动推送
预期收益:提升运营决策效率,及时捕捉市场变化
场景三:题材趋势研究
角色:内容分析师/投研人员
需求:系统性分析抖音短剧题材分布和趋势变化
使用方式:
- 按时间范围查询(如月度数据),观察题材占比变化
- 对比多个题材的互动数据和增长趋势
- 分析「跨题材对比建议」,发现融合机会
预期收益:形成数据驱动的趋势判断,支撑投资决策
场景四:日常内容追踪
角色:短剧爱好者/行业关注者
需求:每天快速了解抖音短剧热点,无需手动分析
使用方式:
- 开启订阅
--subscribe
- 每日自动生成日报,保存在
~/Downloads/QoderReports/
预期收益:零成本追踪行业动态,省时省力
项目架构
目录结构
短剧-抖音信息源/
├── SKILL.md # Skill核心说明文档
├── scripts/
│ └── playlet_douyin_daily.py # 日报生成脚本(含题材聚类+HTML生成)
├── references/
│ ├── core_workflow.md # 核心工作流程+输出格式+聚类规则+趋势分析
│ └── examples.md # 使用示例与常见用法组合
└── assets/
技术栈
| 组件 | 技术 | 说明 |
|---|
| 运行环境 | Python 3 | 脚本执行环境 |
| 数据接口 | 红狐Hub API | 抖音短剧创作数据,RESTful接口 |
| 鉴权方式 | X-API-KEY | 请求头鉴权,环境变量配置 |
| 输出格式 | HTML(深色主题) | 自动浏览器打开,响应式设计 |
| 缓存策略 | JSON本地缓存 | 1小时有效期,路径 ~/.workbuddy/cache/ |
核心模块
- playlet_douyin_daily.py:主执行脚本,集成API调用、题材聚类、HTML日报生成、创作趋势分析,支持日期智能判断(15:00规则)、批量查询去重、浏览器自动预览
常见问答
安装相关
Q: 提示 "缺少 API Key" 怎么办?
A: 请确认已正确配置环境变量 REDFOX_API_KEY:
- 前往 红狐Hub 注册并获取 API Key(格式
ak_xxxxxxxx)
- Windows:
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "ak_xxx", "User")
- 重启终端后验证:
echo %REDFOX_API_KEY%
Q: API Key 无效或过期?
A: 登录红狐Hub个人中心检查Key状态,确认Key未过期且账户积分充足。
使用相关
Q: 数据什么时候更新?
A: 每日15:00更新前一天的数据。15:00前最新可查为前天,15:00后为昨天。
Q: 查询时提示"数据尚未更新"?
A: 这是日期预检机制的正常提示。按提示确认可查询的最新日期即可,不会浪费API积分。
Q: 支持哪些题材查询?
A: 内置6大题材(穿越/霸总/重生/悬疑/甜宠/逆袭),同时支持任意自定义关键词查询。
Q: 如何节省API积分?
A: 使用 --from-cache 复用1小时内缓存;使用 --latest 避免查询无数据日期;默认批量查询策略已自动优化。
故障排除
Q: 脚本报错 "UnicodeEncodeError: 'gbk' codec"?
A: Windows终端编码问题,执行前设置环境变量:$env:PYTHONIOENCODING="utf-8"
Q: HTML日报没有自动打开?
A: 确认系统默认浏览器已正确设置,日报文件始终保存在 ~/Downloads/QoderReports/ 目录下,可手动打开。
Q: API常见错误码?
| 错误码 | 说明 | 解决方式 |
|---|
| 1002 | 每页条数超过200 | 脚本已自动限制,无需处理 |
| 3106 | 缺少API Key | 配置环境变量 REDFOX_API_KEY |
| 3107 | API Key无效 | 检查Key格式和有效性 |
| 3108 | 请求过于频繁 | 等待后重试 |
| 3109 | 今日调用达上限 | 次日再试 |
| 3201 | 积分不足 | 前往红狐Hub充值 |
参考文档
