wechat-10w-hot

---
name: wechat-10w-hot
description: 全网持续收录每日超过1000+公众号10w+文章内容，向用户推送公众号达到10w+阅读的热门文章；当用户需要获取全领域的公众号热门文章、或订阅每日10w+文章推送、特定领域爆款文章时使用
---

# 公众号10w+文章

## 1. 简介

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

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

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

## 2. 功能特性

### 核心功能

| 功能模块 | 能力描述 | 核心价值 |
|----------|----------|----------|
| 📊 爆文榜单推送 | 获取全领域10w+阅读文章TOP50 | 快速了解公众号爆文风向 |
| 🏷️ 领域分类查询 | 23个标准分类独立查询 | 精准定位垂直领域爆文 |
| 📝 四维度内容分析 | 内容概述/热点利用/传播作用/达成效果 | 深度解析爆文成功要素 |
| 📈 爆款规律分析 | 标题特征/内容主题/发布时间/账号特征 | 提炼可复用的爆款方法论 |
| 🎨 HTML可视化报告 | 微信绿主题设计，支持PDF导出 | 便于分享存档和数据汇报 |
| ⏰ 订阅推送 | 每日19:30定时推送 | 持续追踪，不错过爆文 |

### 特色亮点

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

## 3. 一键安装

### 鉴权

#### 获取 API Key

请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取API KEY

#### 配置 API Key

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

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

方案2: 终端配置：

```bash
export REDFOX_API_KEY="ak_xxxx..."
```

### 依赖安装

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

### 环境变量配置

| 变量名 | 说明 | 必填 |
|--------|------|------|
| `REDFOX_API_KEY` | 红狐 API Key | 是 |

## 4. 使用指南

### 基础使用

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

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

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

#### 领域关键词查询

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

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

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

### 高级使用

#### 标准执行流程

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

#### 脚本参数说明

```bash
python scripts/fetch_hot_articles.py --type "分类名称" --start_date YYYY-MM-DD --end_date YYYY-MM-DD --mode preview --limit 10 --source "公众号10w+阅读文章推荐"
```

| 参数 | 说明 | 示例 |
|------|------|------|
| `--type` | 标准分类名称，默认"总排名" | `--type "科技数码"` |
| `--start_date` | 开始日期（必传），YYYY-MM-DD | `--start_date 2026-05-13` |
| `--end_date` | 结束日期（必传），YYYY-MM-DD | `--end_date 2026-05-14` |
| `--source` | 数据源（固定值） | `--source "公众号10w+阅读文章推荐"` |
| `--mode` | 输出模式：preview(前10条) / full(全部) | `--mode preview` |
| `--limit` | 预览模式下显示数量 | `--limit 10` |
| `--temp_file` | 临时数据文件路径 | `--temp_file temp_articles.json` |

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

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

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

| 当前时间 | 用户询问 | 实际查询区间 | 原因 |
|----------|---------|-------------|------|
| < 18:30 | 今日文章 | T-2 ~ T-1 | 昨天数据未更新，查前天区间 |
| >= 18:30 | 今日文章 | T-1 ~ T | 昨天数据已更新，查昨天区间 |
| < 18:30 | 昨天文章 | T-2 ~ T-1 | 昨天数据未更新，查前天区间 |
| >= 18:30 | 昨天文章 | T-1 ~ T | 昨天数据已更新 |

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

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

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

| 用户询问 | 当前时间 | 实际查询区间 | 原因 |
|----------|---------|-------------|------|
| 今日文章 | 11:19 | start_date=2026-05-12, end_date=2026-05-13 | 昨天数据未更新，查前天区间 |
| 今日文章 | 19:30 | start_date=2026-05-13, end_date=2026-05-14 | 昨天数据已更新，查昨天区间 |
| 昨天文章 | 11:19 | start_date=2026-05-12, end_date=2026-05-13 | 昨天数据未更新，但前天数据已更新 |
| 昨天文章 | 19:30 | start_date=2026-05-13, end_date=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+文章~」

#### 输出格式

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

**文章概览表格**：

```markdown
| 序号 | 标题 | 作者 | 阅读数 |
|------|------|------|--------|
| 1 | [标题](文章链接) | [作者名称](公众号名片链接) | 5w+ |
```

**文章详情格式**：

```markdown
**序号、[标题](文章链接)**
📄 作者：[作者名称](公众号名片链接)
👀 阅读数：阅读数
⏰ 发布时间：发布时间
🔍 内容分析：基于四维度规则的分析内容
---
```

#### 四维度内容分析规则

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

#### 爆款规律分析

在完整展示榜单数据后执行，基于实际文章数据进行四方面分析：
- **标题特征**：总结标题共性和亮点
- **内容主题**：分析话题类型、传播价值
- **发布时间**：分析发布时段规律
- **公众号特征**：分析账号类型和内容定位特点

#### HTML页面生成

```bash
python scripts/generate_hot_html.py --temp_file temp_articles.json --output "热门文章_榜单.html" --display_count 10
```

| 参数 | 说明 |
|------|------|
| `--temp_file` | 临时JSON文件路径（默认：`temp_articles.json`） |
| `--output` | 输出文件路径 |
| `--display_count` | 展示的文章数量，必须与对话中展示的数量一致 |

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

#### 订阅服务

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

```
📬 订阅服务

是否需要订阅具体赛道的账号表现？我们支持：
人文资讯、知识百科、健康养生、时尚潮流、美食餐饮、乐活生活、旅游出行、搞笑幽默、情感心理、体育娱乐、美容美体、文摘精选、民生资讯、财富理财、科技数码、创投商业、汽车交通、房产楼市、职场发展、教育考试、学术研究、企业品牌、总排名

订阅推送 - 每天19点30分推送最新10w+公众号爆文
暂不需要 - 仅本次查询
```

### 命令速查表

| 场景 | 命令示例 |
|------|----------|
| 总榜预览 | `python scripts/fetch_hot_articles.py --type "总排名" --start_date 2026-05-12 --end_date 2026-05-13 --mode preview --limit 10` |
| 总榜完整 | `python scripts/fetch_hot_articles.py --type "总排名" --start_date 2026-05-12 --end_date 2026-05-13 --mode full` |
| 领域查询 | `python scripts/fetch_hot_articles.py --type "科技数码" --start_date 2026-05-13 --end_date 2026-05-14 --mode preview --limit 10` |
| 生成HTML | `python scripts/generate_hot_html.py --temp_file temp_articles.json --output "榜单.html" --display_count 10` |

## 5. 使用场景

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

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

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

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

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

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

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

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

## 6. 项目架构

### 目录结构

```
wechat-10w-hot/
├── SKILL.md                       # 技能描述文件
├── scripts/
│   ├── fetch_hot_articles.py      # 爆文数据获取脚本
│   └── generate_hot_html.py       # HTML页面生成脚本
└── references/
    ├── api-spec.md                # API接口规范
    └── category-mapping.md        # 分类泛化映射规则
```

### 技术栈

| 组件 | 技术 | 说明 |
|------|------|------|
| 脚本语言 | Python 3 | 使用标准库（urllib.request） |
| 数据接口 | Redfox API (GET) | `https://redfox.hk/story/api/cozeSkill/getWxDataByCategoryAndTime` |
| 认证方式 | X-API-KEY | 请求头认证 |
| 报告模板 | HTML/CSS/JS | 微信绿主题风格 |
| PDF导出 | html2pdf.js | 自适应单页模式 |

### 核心模块说明

| 模块 | 功能 |
|------|------|
| `fetch_hot_articles.py` | 根据分类和时间获取10w+热门文章数据，生成摘要表格和详情列表，保存到临时JSON文件 |
| `generate_hot_html.py` | 从临时JSON文件读取数据，生成公众号风格HTML页面，支持PDF导出 |
| `api-spec.md` | API接口规范参考 |
| `category-mapping.md` | 分类泛化映射规则参考 |

### 资源索引

- 脚本: 见 [scripts/fetch_hot_articles.py](scripts/fetch_hot_articles.py)（用途: 根据分类和时间获取10w+热门文章数据）
- 脚本: 见 [scripts/generate_hot_html.py](scripts/generate_hot_html.py)（用途: 从临时JSON文件读取数据，生成公众号风格HTML页面）
- 参考: 见 [references/api-spec.md](references/api-spec.md)（何时读取: 查看API接口规范时使用）
- 参考: 见 [references/category-mapping.md](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` 模式展示全部。