wechat-10w-hot

公众号10w+文章

1. 简介

一句话定位：公众号10w+阅读爆文推荐工具，全网持续收录每日1000+条公众号10w+文章，支持按领域分类查询、智能爆款规律分析和HTML报告导出。

核心价值：

• 海量收录：每日收录1000+条10w+阅读文章，覆盖22个标准分类
• 智能分析：基于四维度内容分析（内容概述、热点利用、传播作用、达成效果）
• 可视化报告：自动生成公众号风格HTML页面，支持PDF导出

适用对象：公众号运营者、内容创作者、自媒体编辑、市场运营、爆文研究者。

2. 功能特性

核心功能

特色亮点

• 智能时间判断：根据数据更新时间(18:30)自动计算正确查询区间
• 分页预览机制：首次展示前10条，按需展示完整50条
• 四维度分析：每篇文章从内容概述、热点利用、传播作用、达成效果四方面深度分析
• HTML防分页：PDF导出自适应单页模式，所有内容完整展示

3. 一键安装

鉴权

获取 API Key

请前往 红狐hub 获取API KEY

配置 API Key

方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：

{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

方案2: 终端配置：

export REDFOX_API_KEY="ak_xxxx..."

依赖安装

无需额外安装，脚本使用Python标准库（urllib.request）。

环境变量配置

4. 使用指南

基础使用

查询全领域10w+文章（总榜）

启动后提示用户：「技能已加载完成。是否为您推送最新的10w+阅读文章。」

总榜请求直接推送最新10w+阅读文章TOP50（首次预览展示前10条）。

领域关键词查询

输入具体领域关键词（如"AI编程"、"财经"、"健康饮食"），系统自动匹配22个标准分类并输出该领域TOP10。

标准22分类：人文资讯、知识百科、健康养生、时尚潮流、美食餐饮、乐活生活、旅游出行、搞笑幽默、情感心理、体育娱乐、美容美体、文摘精选、财富理财、科技数码、创投商业、汽车交通、房产楼市、职场发展、教育考试、学术研究、企业品牌、总排名。

分类泛化映射规则详见 references/category-mapping.md。

高级使用

标准执行流程

1. 用户意图识别：智能体识别总榜请求/领域查询/模糊输入
2. 获取爆文数据：调用 scripts/fetch_hot_articles.py 脚本（必须调用，禁止自行生成）
3. 爆款规律分析：基于实际文章数据进行四维度分析
4. 询问订阅：主动询问用户是否需要订阅特定领域
5. 生成HTML页面：调用 scripts/generate_hot_html.py 生成可视化报告
6. 处理用户订阅选择：根据用户回复执行订阅逻辑

脚本参数说明

时间参数计算规则（重要）

数据更新时间：每天 18:30 同步前一日数据。

时间判断逻辑：智能体必须根据当前时间自动计算正确的查询日期。

默认时间规则：用户提到"最近"、"最新"等无明确时间说法时，默认查询过去7天。

订阅推送时间参数：订阅推送（每天19:30）查询昨天（T-1）的数据。

典型场景示例（假设今天是2026-05-14）：

时间不一致提示规则

只要用户询问的时间和实际查询的时间不一致，就需要提示：

• 用户询问"今天的数据"，实际查询昨天：「非常抱歉🙏，今天的数据要明天才会更新，我将为您查询昨天的xx月xx日10W+文章。」
• 用户询问"昨天数据"，实际查询前天：「非常抱歉🙏，昨天的数据还未更新，我将为您查询前天的xx月xx日10W+文章。」
• 用户询问时间早于回溯日期：「非常抱歉🙏，目前最多支持回溯过去30天，我将为您查询最接近您需求的时间范围~」

分页展示策略

• 首次展示：--mode preview --limit 10，展示前10条
• 用户要求拓展：--mode full，展示所有数据
• 数据不超过10条：直接展示所有，无需询问
• 超过10条时底部提示："还有X条数据未展示，是否需要全部展示？"

文章数量较少提示规则

当某赛道某日10w+文章少于10篇时，提示：「💡 xx日xx赛道10w+文章较少，您可以拓展过去30天或者看看综合10w+文章~」

输出格式

脚本输出按以下顺序：数据说明 → 文章概览表格 → 文章详情 → 统计信息。

文章概览表格：

文章详情格式：

四维度内容分析规则

每篇文章必须从以下四个维度进行分析：

• 内容概述：简明扼要地概括文章核心内容
• 热点利用：分析文章借用了哪些热点话题或趋势
• 传播作用：阐述内容起到的作用（满足用户需求、引发情感共鸣、提供实用价值）
• 达成效果：说明内容达到的效果（提升品牌认知、完成用户转化、促进信息传播）

爆款规律分析

在完整展示榜单数据后执行，基于实际文章数据进行四方面分析：

• 标题特征：总结标题共性和亮点
• 内容主题：分析话题类型、传播价值
• 发布时间：分析发布时段规律
• 公众号特征：分析账号类型和内容定位特点

HTML页面生成

HTML视觉规范：

• 主色：rgb(0, 179, 84)（微信绿）
• 辅助色：#0088ff（阅读数、用户名称）
• 序号1-3使用🥇🥈🥉，4往后使用数字
• 用户名称可点击跳转公众号名片（https://open.weixin.qq.com/qr/code?username={accountId}）
• PDF导出：自适应单页模式，pagebreak: { mode: 'none' }

订阅服务

规律分析后主动询问用户是否需要订阅：

命令速查表

5. 使用场景

场景一：公众号运营者获取写作灵感

角色：公众号编辑/运营 需求：每天早晨查看前一天10w+爆文，提取爆款选题和标题套路 使用方式：输入"今日爆文"，获取全领域TOP50 + 爆款规律分析 预期收益：快速掌握当日爆文风向，获得可复用的标题和选题方法论

场景二：垂直领域内容深耕

角色：垂直领域内容创作者（如健康养生、科技数码） 需求：持续追踪本领域爆文，了解同行内容策略 使用方式：查询特定领域TOP50，分析爆款规律，订阅每日推送 预期收益：精准对标同领域头部内容，提升自身内容竞争力

场景三：品牌营销内容策划

角色：品牌营销策划 需求：研究公众号爆文传播规律，为品牌内容制作提供参考 使用方式：跨领域查询爆文榜单，分析标题特征和传播作用 预期收益：掌握公众号内容传播密码，制定高效的品牌内容策略

场景四：自媒体创业方向调研

角色：自媒体创业者 需求：了解各领域公众号的流量分布和爆文特征，选择适合的切入方向 使用方式：连续查询多个领域近7天数据，对比各领域爆文数量和质量 预期收益：基于数据做出领域选择决策，从起号阶段就走在正确方向

6. 项目架构

目录结构

技术栈

核心模块说明

资源索引

• 脚本: 见 scripts/fetch_hot_articles.py（用途: 根据分类和时间获取10w+热门文章数据）
• 脚本: 见 scripts/generate_hot_html.py（用途: 从临时JSON文件读取数据，生成公众号风格HTML页面）
• 参考: 见 references/api-spec.md（何时读取: 查看API接口规范时使用）
• 参考: 见 references/category-mapping.md（何时读取: 查看分类泛化映射规则时使用）

7. 常见问答

安装相关

Q: 脚本运行报错 "REDFOX_API_KEY not found" A: 请确保已配置环境变量 REDFOX_API_KEY，可参考上方鉴权章节配置。

Q: 是否需要安装Python依赖？ A: 不需要，脚本使用Python标准库（urllib.request），无需额外安装。

使用相关

Q: 为什么查询"今天"的文章返回的是昨天的？ A: 数据每日18:30同步前一日数据。如果在18:30之后查询，可获取昨日数据；18:30之前查询需使用前日数据。系统会自动计算并提示。

Q: 如何查看完整的50条数据？ A: 首次预览展示前10条后，回复「全部展示」或「是」，系统会使用 --mode full 展示所有50条。

Q: 用户输入的领域关键词如何匹配？ A: 系统通过分类泛化映射规则自动匹配，如"AI" → "科技数码"，"减肥" → "健康养生"。详见 references/category-mapping.md。

Q: HTML中的文章数量和对话中不一致？ A: 使用 --display_count 参数控制HTML展示数量，必须与对话中实际展示的数量一致。

故障排除

Q: 查询返回空数据？ A: 可能原因：1) 该领域在查询时间段内无10w+文章；2) API Key 无效或过期。系统会提示推荐查看综合榜单或其他分类。

Q: PDF导出出现分页？ A: HTML生成时已配置 pagebreak: { mode: 'none' } 和 page-break-inside: avoid，如果仍有分页请检查html2pdf.js配置。

Q: 脚本输出被截断？ A: 确保使用 preview 模式首次展示，仅输出10条避免截断。用户需要时再使用 full 模式展示全部。