公众号热门文章查询

SKILL.md 节选

# 公众号热门文章查询

## 1. 简介

公众号热门爆款文章查询工具，支持按关键词搜索微信公众号爆款文章，并基于相关性、热度、时效三维评分智能排序推荐。专注服务于公众号内容创作者、新媒体运营者和自媒体团队，帮助用户快速发现热门选题、分析爆款规律、获取创作灵感。

## 2. 功能特性

- 🔍 **关键词智能搜索** — 支持关键词精确搜索和多关键词组合查询（逗号分隔），覆盖全品类公众号文章
- 📊 **三维评分排序** — 基于相关性（满分10分）、热度（满分3分）、时效（满分2分）加权计算总分（满分15分），智能排序推荐
- ⏱️ **灵活时间范围** — 默认查询最近7天，支持自动拓展时间（1天→7天→30天），数据每日早上7点更新
- 🧠 **赛道词识别与拓展** — 自动识别泛化赛道词并推荐10个细分方向，帮助用户精准定位
- 🔥 **热门推荐文章** — 结果较少时自动展示近期热门推荐文章和热门话题
- 📩 **定时订阅推送** — 支持创建日历订阅任务，到达设定时间自动推送最新爆款文章
- 📄 **HTML 报告生成** — 可选生成 HTML 可视化文件，方便独立查看和分享
- 📋 **数字智能格式化** — 万级以上阅读数自动转换（如 `10.0w`），总分字段加粗突出显示

## 3. 一键安装

### 鉴权

#### 获取 API Key

请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=skillhub) 获取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..."
```

### 依赖安装

本 Skill 使用 Python 3.13+ 纯标准库（urllib.request、json、os、sys、argparse、datetime），无需安装任何第三方依赖。

### 环境变量配置

| 环境变量 | 说明 | 是否必填 | 获取方式 |
| -------- | ---- | -------- | -------- |
| `REDFOX_API_KEY` | 红狐数据 API Key | 是 | [红狐hub](https://redfox.hk/settings/api-keys?source=skillhub) |

## 4. 使用指南

### 基础使用（3 步完成查询）

**Step 1 — 提取关键词**：从用户描述中提取搜索关键词，判断是赛道词还是细分词。

- **赛道词**：较大的分类词，如"职场""情感""亲子""美妆"等
- **非赛道词**：具体细分词，如"职场沟通技巧""异地恋怎么维持"等

**Step 2 — 调用脚本**：

```bash
python scripts/fetch_gzh_trends.py --keyword <关键词> --start-date <日期>
```

- 有赛道关键词：`python scripts/fetch_gzh_trends.py --keyword <关键词> --start-date <日期>`
- 无赛道关键词（查询全站热门）：`python scripts/fetch_gzh_trends.py --keyword "" --start-date <日期>`
- 多个关键词用逗号分隔：`python scripts/fetch_gzh_trends.py --keyword "职场沟通,恋爱技巧,亲子教育" --start-date <日期>`

**⚠️ 防重复调用规则（强制）**：

- ❌ **禁止**先用 `head`/`tail`/`2>/dev/null | head -5` 等方式"试运行"或"预览"脚本输出
- ❌ **禁止**在同一次查询中对同一参数多次调用脚本
- ✅ **每次查询只执行一次脚本命令**，直接读取完整的 stdout 输出
- ✅ 唯一允许多次调用的场景：数据不足时按规定的自动拓展时间（近1天→近7天→近30天），每次使用不同的 `--start-date`

**Step 3 — 查看结果**：脚本返回结构化 JSON 数据，按本指南规定的展示策略输出结果。

---

### 高级使用

#### 赛道词处理流程（仅当识别为赛道词时执行）

**第一步：识别并询问用户（⚠️ 仅当用户明确要求时才执行）**

```
我识别到「职场」是较大的分类，已查询近期热门趋势，推荐以下细分方向：
工作、打工人、职场穿搭、职场干货、成长、冷门职业、向上管理、职场焦虑、升职、财务自由

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 6 个文件，合计 62.3 KiB