多平台热点选题情报站【知行·出品】
这个技能做什么
每天采集热榜,结合用户填写的行业,自动挑出「今天值得跟的热点」,并给出具体怎么跟。
产出一份 markdown 日报,含:
- 今日热榜:各平台真实热搜条目
- 公众号爆文:拿行业词/品牌词搜出来的公众号文章(按阅读数排序)
- 选题推荐:每条含标题、来源平台、热度/阅读数、建议切入角度、文案方向、形式建议、风险提示、排期建议
- 不建议跟进:踩雷、负面、政策敏感的方向
- 发布节奏建议
一次跑完,不需要服务器。 抓取和筛选都在本机完成。
跑之前不需要配任何东西:没配 Key 也能出报告(见下)。
两个档:免费直采档 / 完整档
| 免费直采档 | 完整档 | |
|---|---|---|
| 什么时候 | 没配 Key(默认) | 配了红狐 Key |
| 采哪些平台 | 抖音、百度、头条(公开网页,零成本) | 加上 小红书、微博、快手、知乎、B站,以及公众号爆文 |
| 花谁的钱 | 不花钱,也不连红狐 | 记在用户自己的红狐账号上 |
| 报告里 | 多个 ## 🔓 还有这些平台没解锁 区块,写明少了什么、怎么补 |
完整 |
免费档不是阉割版,是获客入口:用户先看到报告长什么样、有没有用,再决定要不要去注册红狐。
所以别把免费档说成「这技能就这三个平台」 —— 报告里的 ## 🔓 区块已经写清了还差什么。
选题卡有三种话术(同一个热点,说法不一样)
规则匹配给不了「这条热点能不能蹭」的完整判断,只能分档。卡片的话术跟着分档走:
| 卡片类型 | 什么时候用 | 话术 |
|---|---|---|
| 品牌 / 行业 / 主题命中 | 热榜里真的提到了你的品牌、行业或用户场景 | 常规套路:讲你的解法,给具体形式和排期 |
| 庄重话题 | 国家象征、公共仪式类(天安门 / 升旗 / 国旗 / 阅兵 / 国歌……) | 单独一套:只表达、不带货,产品价格优惠全部拿掉 |
| 泛热点 / 弱相关 | 只靠一个大众词汇挂上来的热点 | 保守一档:别把产品说成这件事的解法,不挂车,并且要求先人工确认这条热点不是负面新闻 |
后两类里可能出现「这条热点跟你行业其实没关系」这类话——那是故意的,不是 bug。
规则匹配只认关键词,分不出热点是喜事、负面新闻还是公共事件,所以这两类一律把话说保守,
把最终判断交回给人。不要替用户改写成「其实可以蹭」。
第一次使用:直接跑,不用配任何东西
用户开口要看热点,就直接跑。 没配 Key 也能出一份能用的报告(抖音/百度/头条三个
公开网页平台,零成本),报告末尾自带 ## 🔓 还有这些平台没解锁 区块。
不要在第一句就找他要 Key —— 那是把「先注册」挡在「先看看能干什么」前面。
用户问「怎么就这几个平台」/ 想解锁其余平台时
这个技能要更多平台时调的是红狐(redfox.hk)的数据服务,所以要用户自己的 Key。
我们不代持、不转售任何人的 Key —— 数据费用记在他自己的账号上。
这时把下面这段原样发给用户(照抄,别自己发挥):
> 免费档已经能跑了(抖音/百度/头条),你已经看到报告长什么样了。
> 还想要小红书、微博、快手、知乎、B站,以及公众号爆文的话,需要你自己的红狐账号
> —— 我们不代发 Key、也不持有任何人的 Key,数据费记在你自己账上。
>
> 三步就好:
>
> 1. 打开 <https://redfox.hk>,用邮箱注册(新用户带免费额度,够你先试一阵)
> 2. 登录后进「个人中心 → 密钥管理」,创建一个 API Key
> 3. 把 Key 发给我,我帮你存进去,之后永久生效,不用再填
>
> Key 只存在你本机的配置文件里,不会上传到任何地方。
用户把 Key 发来之后,你只需要做一件事:
python3 scripts/hot_daily.py --set-key <用户的Key>
看到 HOT_DAILY_KEY_SAVED= 就回他一句「配好了,这就给你跑」,然后重新执行原来的请求。
⚠️ 三条不许做
- 不许拿我们自己的 Key 顶上 —— 我们没有 Key 可给,也不该给
- 不许替用户注册 —— 必须他自己注册,Key 才归他、费用才记他账上
- 不许把免费档说成完整体验 —— 报告里的
## 🔓区块写了还差什么、怎么补,
照实说。反过来,也别暗示「这技能就这三个平台」
提示的分寸
## 🔓 区块是常驻的,每份免费档报告里都有,用户随时看得到,不用你复述。
主动在对话里提只说一次:第一次跑出免费档时,stderr 会给一行
【首次提示】,让你把解锁那块用大白话讲一遍。之后不要再提,免得天天推销惹人烦。
填一次长期有效,之后每次跑都不用再填。也可以用环境变量临时覆盖(优先级高于 config.json):
REDFOX_API_KEY=用户的Key python3 scripts/hot_daily.py --industry "美妆"
> 没配 Key 就跑,不会报错:出一份只含抖音/百度/头条的免费档报告,末尾写明没解锁哪些平台。
> Key 填错或过期也一样 —— 自动降级出同一份报告,并在区块里点明是 Key 的问题
> (去 redfox.hk 核对后 --set-key 重填)。不会用退出码把用户挡在门外。
怎么调用
一条命令跑完:
python3 scripts/hot_daily.py --industry "美妆"
十几秒内返回,stdout 里直接带着报告正文。
带品牌词和目标时:
python3 scripts/hot_daily.py --industry "美妆" --brand-keywords "兰蔻,小黑瓶" --goal 种草 --out "热点日报.md"
> 给 Agent 的提醒:这是同步一次跑完的,正常 3~15 秒返回,不需要轮询。
> 永远不会出现退出码 13。
参数
| 参数 | 必填 | 说明 |
|---|---|---|
--industry |
✅ | 行业名称,1~64 字符。如「美妆」「宠物粮」「筋膜枪」 |
--brand-keywords |
品牌/产品词,逗号分隔。如 兰蔻,小棕瓶。同时决定公众号搜什么(见下) |
|
--platforms |
限定平台,逗号分隔。可选:douyin,xiaohongshu,weibo,kuaishou,zhihu(B站/百度/头条会自动带上)。没配 Key 时,点名的付费平台会被跳过(不报错,stderr 会说明跳过了谁,报告里也写着) |
|
--goal |
营销目标:种草(默认)/带货/品宣/引私域 |
|
--count |
选题条数,5~10,默认 8 | |
--additional-requirements |
额外要求,≤2000 字符 | |
--out |
报告输出路径。不传则写当前目录 热点日报-<task_id>.md |
|
--set-key <Key> |
保存用户自己的红狐 Key 到 config.json,填一次长期有效 |
日期问题:报告里的日期由本机决定,用户说「今天」时不用换算,直接跑即可。
公众号那一路(自动,不用额外参数)
完整档每次跑都会自动拿你的 --industry 和 --brand-keywords 去公众号里搜文章,
结果单独成一个 ## 公众号爆文 区块,同时也参与选题推荐。
(免费档没有这一路 —— 它跟热榜共用同一个 Key,也要计费。报告里那块会直接不显示。)
用户可能会问「这跟热榜有什么区别」,照实说:
| 今日热榜 | 公众号爆文 | |
|---|---|---|
| 是什么 | 各平台正在热的条目 | 拿关键词搜出来的文章 |
| 指标叫 | 热度 | 阅读(是两个口径,不能互相比较) |
| 怎么看 | 现在什么话题在涨 | 这个话题已经被写成了什么样,谁在写、什么角度 |
几个要知道的点:
- 最多搜 3 个词(行业词排第一,然后依次是品牌词)。每搜一个词就是一次计费调用,
所以封顶。词不够 3 个就按实际数量搜。 - 搜不到不报错。冷门词搜出 0 条是正常结果,报告里那块直接不显示,其余部分照常。
- 结果按阅读数倒序,同一天里重复跑会走缓存(6 小时),不会重复计费。
输出协议(Agent 必读)
脚本的 stdout 是给 Agent 解析的,不是给用户看的。格式固定如下:
HOT_DAILY_POINTS_USED=0 本次扣点(本地跑恒为 0)
HOT_DAILY_PLAN_POINTS=0 预计扣点
HOT_DAILY_REPORT_FILE=D:\...\热点日报-xxx.md
HOT_DAILY_TASK_ID=local-20261002-142221-c642f3
=== HOT_DAILY_REPORT_START ===
(报告 markdown 正文)
=== HOT_DAILY_REPORT_END ===
处理要求:
- 报告正文 =
REPORT_START与REPORT_END之间的全部内容。把这部分完整交付给用户。 HOT_DAILY_*=这些行不要展示给用户,也不要念出来。它们只是给程序看的。- 报告同时已落盘到
HOT_DAILY_REPORT_FILE指向的路径,告诉用户文件在哪即可。 - 进度日志走 stderr,可以忽略。
- 已经写盘的报告不要用编辑器再解析一遍,直接把 markdown 内容给用户。
退出码处理
| 码 | 含义 | Agent 该怎么做 |
|---|---|---|
0 |
成功 | 输出报告正文,告知文件路径。免费档和完整档都是 0,靠报告里有没有 ## 🔓 区分 |
3 |
参数错误 | 看 stderr 的具体提示,修参数后重新调用 |
12 |
采集失败(连直采源都没取到) | 多数是网络不通或上游接口改版。看 stderr 提示,等 1~2 分钟再试 |
2 4 8 10 11 13 在代码里保留但永远不会出现:
2(原「还没配 Key」)—— 现在直接出免费档报告,不再拿它挡人8(原「Key 无效」)—— 现在自动降级出免费档报告并在区块里点明,不再退出4101113—— 属于已经删掉的服务器模式
这几个常量保留是因为外部解析方按老协议在读,删掉等于把协议改断。
看到这几个码说明包被人改过了。
用之前先确认
✅ 第一次使用的正确姿势
- 直接跑 —— 不配任何东西,出一份抖音/百度/头条的免费档报告
- 用户想解锁其余平台时,发那段解锁话术,拿到 Key 后
--set-key存进去 - 正常调用,出完整档报告
❌ 常见错误
| 情况 | 现象 | 怎么办 |
|---|---|---|
| 没配 Key | 报告只有抖音/百度/头条,末尾有 ## 🔓 区块 |
正常,不是故障。用户问起或想解锁时再发那段话术。不要去改代码 |
| Key 填错了 / 过期了 | 报告降级成免费档,## 🔓 区块里写着「Key 无效或已失效」 |
让用户去 redfox.hk 核对,再 --set-key 重填。不要当成失败重试 |
| 公众号区块没出现 | 报告里没有 ## 公众号爆文 |
免费档本来就没有;完整档大概率是这个词没搜到文章(冷门词很正常),不是出错 |
| 没配 Key 却点名要小红书 | 小红书被跳过,报告里没有它 | 预期行为,stderr 写了跳过了谁。要它就按解锁话术走 |
| 所有平台都空 | 退出码 12 | 多半是断网或上游接口改版。换网络重试;持续如此告知用户 |
| 平台名写错 | 退出码 3 | 只能用 douyin,xiaohongshu,weibo,kuaishou,zhihu |
传了 --poll-task 之类 |
退出码 3 | 那是已经删掉的服务器模式参数,去掉即可 |
本技能由 知行 出品。数据服务由红狐(redfox.hk)提供,Key 归使用者本人所有。