公众号原创文章推荐（红狐数据）

SKILL.md

---
name: wechat-original-hot
description: 全网持续收录每日公众号原创热门文章内容，向用户推送公众号原创热门文章；当用户需要获取全领域的公众号原创热门文章、或订阅每日原创热门文章推送时使用
---

# 公众号热门原创文章

## 1. 简介

**一句话定位**：公众号原创爆文推荐工具，全网持续收录每日公众号原创热门文章，支持按分类和日期筛选，提供HTML可视化报告和每日订阅推送。

**核心价值**：
- **聚焦原创**：专注收录公众号原创爆款文章，区别于转载/洗稿内容
- **灵活查询**：支持分类查询、日期查询、时间范围查询等多种方式
- **完整数据输出**：对话中逐条展示所有文章，禁止截断省略

**适用对象**：公众号内容创作者、原创写手、爆文研究者、自媒体运营。

**重要提示**：本Skill必须调用脚本获取数据，禁止AI自行生成任何内容。

## 2. 功能特性

### 核心功能

| 功能模块 | 能力描述 | 核心价值 |
|----------|----------|----------|
| 📊 原创爆文榜单 | 获取公众号原创热门文章TOP50 | 专注原创内容，洞察创作趋势 |
| 🏷️ 分类筛选 | 23个标准分类独立查询 | 精准定位垂直领域原创爆文 |
| 📅 日期回溯 | 支持指定日期查询，默认回溯30天 | 灵活查询历史数据 |
| 🎨 HTML可视化报告 | 微信绿主题设计，支持PDF导出 | 便于分享存档和数据汇报 |
| ⏰ 订阅推送 | 每日19:30定时推送 | 持续追踪原创爆文动态 |

### 特色亮点

- **强制脚本调用**：禁止AI自行生成内容，确保数据真实性
- **逐条完整展示**：limit=20就必须逐条输出全部20条，严禁截断或省略
- **智能时间判断**：根据数据同步时间(19:30)自动计算正确查询区间
- **分类泛化匹配**：支持模糊关键词自动匹配到23个标准分类

## 3. 一键安装

### 鉴权

#### 获取 API Key

请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取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标准库（json、argparse、os、sys、urllib、ssl）。

### 环境变量配置

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

## 4. 使用指南

### 基础使用

#### 启动提示

Skill 加载后提示用户：「技能已加载完成。是否为您推送最新的原创爆款文章？」

#### 查询总榜原创爆文

```bash
python scripts/fetch_articles.py --type "总排名" --limit 20
```

或不传 `--type`，默认为"总排名"。输出最新原创爆款文章Top20。

#### 分类查询

```bash
python scripts/fetch_articles.py --type "科技数码" --limit 20
```

分类名称从用户输入中匹配，参考 [分类映射表](references/category_mapping.md)。

#### 日期查询

```bash
python scripts/fetch_articles.py --type "总排名" --start_date "2026-05-03" --limit 20
```

脚本会自动计算 `endDate` = `startDate` + 1天。

### 高级使用

#### 用户意图识别

智能体首先识别用户意图类型：

| 意图类型 | 触发词 | 处理方式 |
|----------|--------|----------|
| 直接查询 | "今日爆文"、"原创爆文"、"最新爆文" | 输出最新原创爆款Top20 |
| 分类查询 | "科技"、"健康养生"、"财经" | 匹配分类，输出该分类Top20 |
| 日期查询 | "5月3日的原创爆款"、"昨日爆文" | 输出指定日期爆文Top20 |
| 时间范围 | "最近"、"最新"（无明确时间） | 默认查询过去7天，输出Top20 |
| 模糊输入 | 输入不明确 | 直接推送今日原创热门文章 |

#### 数据时间说明

- **数据同步时间**：每日 19:30 同步
- **同步数据范围**：前一天（T-1）的数据
- **查询数据范围**：
  - 当前时间 < 19:30：查询 T-2 数据（前天）
  - 当前时间 >= 19:30：查询 T-1 数据（昨天）
- **默认查询时间**：用户提到"最近"、"最新"等无明确时间说法时，默认查询过去7天

#### 接口信息

- 接口URL：`https://redfox.hk/story/api/cozeSkill/getWxDataByCategoryAndTime`
- 请求方式：POST（JSON body）
- 认证方式：X-API-KEY header，值从 `REDFOX_API_KEY` 环境变量获取
- 参数：
  - `type`：分类名称（如"科技数码"、"总排名"等）
  - `startDate`：开始日期（YYYY-MM-DD格式）
  - `endDate`：结束日期（YYYY-MM-DD格式）
  - `source`："公众号文章原创之王"（固定值）

#### 核心输出规则（必须遵守）

- **必须调用脚本**：智能体必须调用 `fetch_articles.py` 脚本，不能自己生成文章内容
- **禁止输出脚本路径或代码**：智能体不得向用户展示任何脚本路径、代码内容或执行命令
- **必须原样展示脚本输出**：脚本stdout输出内容原样展示，不得省略、修改、重新格式化
- **禁止截断或省略**：`limit=20` 就必须逐条输出全部20条，严禁使用"..."只展示前N条
- **禁止修改数据**：不得修改、重新格式化、美化或隐藏脚本输出的任何部分
- **脚本输出即最终输出**：脚本输出内容就是展示给用户的最终内容
- **询问部分不可省略**：脚本输出的"共获取到XX条..."和订阅服务必须完整展示

#### 输出格式

**文章概览表格**：

```markdown
| 序号 | 作者 | 标题 | 阅读数 |
|------|------|------|--------|
| 1 | [夜听](https://open.weixin.qq.com/qr/code?username=yetingfm) | [【夜听】有一种感情，叫不再联系](https://mp.weixin.qq.com/s?...) | 10w+ |
```

**输出示例（最新一期数据，时间不一致需提示）**：

```markdown
💡 数据说明
公众号原创文章推荐将在每日19点30分准时更新昨日文章数据，以下数据为获取时间时的快照，和实时数据有所差别。

非常抱歉🙏，最新的是前天的数据，我将为您查询最接近您需求的2026年05月12日原创文章。

📊 原创爆文推荐
最近30天的原创爆款文章

| 序号 | 作者 | 标题 | 阅读数 |
|------|------|------|--------|
| 1 | [作者A](链接) | [文章标题](链接) | 10w+ |
...

导出功能：输出生成HTML榜单页面，表格内容支持导出 PDF 格式，自动生成并打开

共获取到50条爆款原创热门文章,当前展示前20条。

📬 订阅服务
是否需要订阅具体赛道的账号表现？我们支持：
人文资讯、知识百科、健康养生、时尚潮流、美食餐饮、乐活生活、旅游出行、搞笑幽默、情感心理、体育娱乐、美容美体、文摘精选、民生资讯、财富理财、科技数码、创投商业、汽车交通、房产楼市、职场发展、教育考试、学术研究、企业品牌、总排名
订阅推送 — 每天19点30分推送最新公众号原创文章
暂不需要 — 仅本次查询
```

#### 时间不一致提示规则

只要数据查询日期和用户询问日期不一致，就必须在数据说明后显示提示信息：

- 查询日期 > 最新日期：`非常抱歉🙏，最新的是{查询日期}的数据，我将为您查询最接近您需求的{查询日期}原创文章。`
- 查询日期 < 回溯日期：`非常抱歉🙏，目前最多支持回溯「过去30天」（最早至{回溯日期}），我将为您查询最接近您需求的时间范围~`

#### 查询"最近7天"（查询范围超出最新数据）

```markdown
💡 数据说明
公众号原创文章推荐将在每日19点30分准时更新昨日文章数据，以下数据为获取时间时的快照，和实时数据有所差别。

非常抱歉🙏，最新的是前天的数据，我将为您查询最接近您需求的时间范围。

📊 原创爆文推荐
2026年05月06日至2026年05月12日的原创爆款文章
```

#### HTML页面生成

在对话中完整输出所有文章数据后，自动生成HTML页面：

```bash
python scripts/generate_hot_html.py --temp_file temp_articles.json --output "原创爆文_榜单.html" --display_count 20
```

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

**生成前置条件**：生成HTML前必须自检对话回复中是否已逐条展示了 `--limit` 指定数量的文章。

#### 订阅服务

主动询问用户是否需要订阅特定分类。用户选择订阅后，每天19:30推送最新一期原创爆文数据。

### 命令速查表

| 场景 | 命令示例 |
|------|----------|
| 总榜查询 | `python scripts/fetch_articles.py --type "总排名" --limit 20` |
| 分类查询 | `python scripts/fetch_articles.py --type "科技数码" --limit 20` |
| 日期查询 | `python scripts/fetch_articles.py --type "总排名" --start_date "2026-05-03" --limit 20` |
| 生成HTML | `python scripts/generate_hot_html.py --temp_file temp_articles.json --output "原创爆文_榜单.html" --display_count 20` |

## 5. 使用场景

### 场景一：原创作者学习爆文写法

**角色**：公众号原创写手
**需求**：研究近期原创爆款文章的标题、选题和结构，提升写作水平
**使用方式**：查询全领域或特定领域原创爆文Top20，逐条阅读分析
**预期收益**：学习头部原创文章的成功模式，提升自身内容原创力和吸引力

### 场景二：垂直领域内容对标

**角色**：垂直领域公众号运营
**需求**：了解本领域原创爆文的最新趋势和竞争格局
**使用方式**：按分类查询，如"健康养生"，输出该领域Top20原创爆文
**预期收益**：精准对标同领域头部内容，掌握领域内容风向

### 场景三：历史爆文回顾研究

**角色**：内容策略分析师
**需求**：研究某个特定时间段（如节假日）的原创爆文特征
**使用方式**：使用日期查询功能，指定具体日期获取当日原创爆文
**预期收益**：发现时间周期性的爆文规律，制定更精准的内容日历

### 场景四：每日订阅持续追踪

**角色**：自媒体创业者
**需求**：持续追踪原创爆文动态，不错过任何内容趋势变化
**使用方式**：订阅每日推送，每天19:30自动获取最新原创爆文
**预期收益**：保持对公众号原创内容生态的持续感知，及时调整创作方向

## 6. 项目架构

### 目录结构

```
wechat-original-hot/
├── SKILL.md                        # 技能描述文件
├── scripts/
│   ├── fetch_articles.py           # 原创爆文数据获取脚本
│   └── generate_hot_html.py        # HTML页面生成脚本
└── references/
    └── category_mapping.md         # 分类映射表
```

### 技术栈

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

### 核心模块说明

| 模块 | 功能 |
|------|------|
| `fetch_articles.py` | 获取原创爆款文章数据，支持分类查询和日期查询，保存到临时JSON文件 |
| `generate_hot_html.py` | 从临时JSON文件读取数据，生成公众号风格HTML页面 |
| `category_mapping.md` | 分类映射表，包含22个标准分类和泛化关键词 |

### 资源索引

- 脚本: 见 [scripts/fetch_articles.py](scripts/fetch_articles.py)（用途: 获取原创爆款文章数据，支持分类查询和日期查询）
- 脚本: 见 [scripts/generate_hot_html.py](scripts/generate_hot_html.py)（用途: 从临时JSON文件读取数据，生成公众号风格HTML页面）
- 参考: 见 [references/category_mapping.md](references/category_mapping.md)（用途: 分类映射表，包含22个标准分类和泛化关键词）

## 7. 常见问答

### 安装相关

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

**Q: 是否需要安装第三方依赖？**
A: 不需要。脚本使用Python标准库（json, argparse, os, sys, urllib, ssl），无需额外安装。

### 使用相关

**Q: 为什么查询"今日"的文章返回的是前天的？**
A: 数据每日19:30同步前一天数据。如果在19:30之前查询，前一天数据尚未同步，系统会自动查询前天的数据并给出提示。

**Q: 对话中输出的文章数量为什么和limit参数不一致？**
A: 本技能强制要求 `limit=20` 就必须逐条输出全部20条。如发现缺少文章，说明智能体执行出错，需要重新调用脚本。

**Q: 和 wechat-10w-hot 有什么区别？**
A: wechat-original-hot 专注**原创**爆款文章（对应来源"公众号文章原创之王"），wechat-10w-hot 收录所有**10w+阅读**文章（包含转载和非原创内容）。

**Q: 如何按日期查询？**
A: 使用 `--start_date` 参数，如 `--start_date "2026-05-03"`。脚本会自动计算 `endDate = startDate + 1天`。

### 故障排除

**Q: 分类查询匹配不到正确分类？**
A: 请参考 `references/category_mapping.md` 中的分类映射表。如果用户输入的关键词不在映射表中，可以提示用户从23个标准分类中选择。

**Q: HTML生成后文章数量不对？**
A: 使用 `--display_count` 参数确保HTML展示数量与对话中一致。生成前必须自检对话中展示的文章数量。

**Q: 查询返回空数据？**
A: 可能原因：1) 该分类在查询时间段内无原创爆文；2) 查询日期超出30天回溯范围；3) 查询日期早于最早可用数据。系统会给出相应提示。