Gzh Toutiao Growth Rank

---
name: gzh-toutiao-growth-rank
description: 公众号头条增长榜工具。基于红狐数据，按周统计公众号头条阅读增长（本周 vs 上周），排序固定为头条增长率降序，支持 23 个作者类别筛选，最多翻 5 页（每页 20 条，逐页输出），发现正在快速涨量的公众号账号。当用户提到"公众号头条增长榜"、"头条增长榜"、"公众号黑马榜"、"黑马榜"、"公众号涨榜"、"公众号飙升榜"、"阅读增长榜"、"涨粉快的公众号"、"公众号涨量排名"时使用。
---

# 公众号头条增长榜

> 按周统计公众号头条阅读增长，发现本周快速涨量的黑马账号。

---

## 触发场景

**核心触发词：**

- "公众号头条增长榜"、"头条增长榜"（现用名）
- "公众号黑马榜"、"黑马榜"、"公众号涨榜"、"飙升榜"（原名/别名，仍有效）
- "阅读增长榜"、"涨量排名"、"本周涨得最快的公众号"
- "XX类 头条增长榜"（分类 + 榜单），如"健康养生头条增长榜"

---

## 数据说明

### 榜单口径

- **统计周期**：自然周（周一至周日）
- **更新时间**：新一期榜单每周一下午 16:30 更新
- **核心指标**：本周头条阅读 vs 上周头条阅读，输出阅读增长量与增长率
- **榜单排序（固定）**：一律按头条增长率降序输出，不支持切换
- **榜单口径（分类）**：不指定分类时查询综合全部分类总榜（跨全部 23 个作者类别统一排名）；指定分类时只查该分类榜
- **翻页**：每页固定 20 条，最多 5 页，逐页输出

### 作者类别

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

---

## 一键安装

### 前置条件

- Python 3.6+
- 红狐数据 API Key（获取方式见下方注意事项）

### 安装步骤

1. 将技能文件夹放入你的 Skills 目录
2. 配置环境变量 `REDFOX_API_KEY`（macOS/Linux：`export REDFOX_API_KEY=<你的Key>`；Windows PowerShell：`$env:REDFOX_API_KEY="<你的Key>"`）。脚本未读到环境变量时，会尝试从 `~/.zshrc` 等 shell 配置中读取
3. 无需安装额外依赖，脚本仅使用 Python 标准库

---

## 工作流程

> 核心执行流程（意图识别、脚本调用、榜单渲染规则、空结果处理等）详见 `references/core_workflow.md`，Agent 执行时必须遵循该文件中的所有规则。

---

## 使用指南

直接用自然语言描述查询需求，无需记忆命令。

| 意图 | 示例话术 | 效果 |
| ---- | -------- | ---- |
| 查看最新增长榜 | 「看公众号头条增长榜」 | 输出最新一期综合总榜（按头条增长率降序） |
| 指定分类 | 「健康养生头条增长榜」 | 只输出该分类榜单 |
| 指定期数 | 「9 月 7 日那周的榜单」 | 查询指定自然周（自动归一为周一） |
| 查看上期榜单 | 「上期榜单」 | 输出上一期榜单（相对最近一期往前推一周） |
| 翻页 | 「下一页」 | 输出下一页 20 条 |
| 查看分类 | 「有哪些分类」 | 列出全部 23 个作者类别 |

---

## 输出内容

查询成功后，榜单以 Markdown 表格形式直接在对话中完整展示：

- 标题：期数 · 分类 · 排序方式
- 统计周期、更新时间与页码信息
- 榜单表格：排名、公众号、本周头条阅读、上周头条阅读、头条增长值、头条增长率
- 翻页提示：回复「下一页」继续查看

---

## 注意事项

1. **数据真实性**：所有数值均来自榜单数据服务，如实展示，严禁估算或编造
2. **查询无果不替换**：空结果如实说明并给出可选调整方向，不自动改查其他分类或其他内容
3. **日期归一**：指定统计周内任意一天即可，自动归一为周一
4. **鉴权**：首次使用需配置环境变量 `REDFOX_API_KEY`，API Key 获取与配置详见 `references/core_workflow.md`
5. **时效说明**：榜单按周更新（每周一下午 16:30 更新新一期），展示时注明统计周期、更新时间与期数