---
name: gzh-explosive-content-detector
description: 为公众号文章创作打造的专业数据洞察工具。全网持续收录每日爆款文章，收录依据：低粉高阅读、阅读靠前、数据增长中、原创靠前，助力号主获取数据参考。
dependency:
  python:
    - requests>=2.28.0
  system:
---

# 公众号爆款文章查询

---

## 简介

面向公众号选题与创作的数据洞察 Skill：持续收录全网爆款文章，按「低粉高阅读、阅读靠前、数据增长中、原创靠前」等维度筛选，为号主提供可参考的爆款样本。

**能做什么？**

- 🔍 **关键词探测**：按赛道/细分词查询最匹配的公众号爆款内容
- 📊 **智能筛选**：结合用户意图与内容相关性，从候选中挑出最多 10 条高质量推荐
- 🃏 **双形态展示**：Markdown 卡片 + HTML 网格卡片，便于阅读与分享
- 🧭 **细分引导**：展示结果后主动给出 10 个可继续深挖的细分赛道词

**适合谁用？**

- 公众号运营 / 编辑 —— 找选题、看对标
- 内容创作者 —— 了解近期高热话题与标题范式
- MCN / 增长 —— 批量观察某一垂类的爆款特征

**运行依赖**：Python `requests>=2.28.0`。

---

## 功能特性

### 核心功能

- **爆款文章探测**：搜索全站热门的公众号文章
- **时间窗口**：默认最近 7 天；最多可查询近30天公众号爆款数据
- **泛化词治理**：识别大类泛词后必须先给细分推荐并等待用户「拓展 / 不拓展」，禁止同轮继续跑脚本
- **输出产物**：脚本生成 `{keyword}_爆款数据.html`；筛选逻辑可参考 `{keyword}_爆款数据.json`（若脚本产出）

### 特色亮点

- **意图优先**：优先提取用户描述中的细分方向词，避免只用「职场」「情感」等过大类词一查了之
- **数据诚实**：非实时快照； today / 超 30 天等诉求有固定话术说明边界
- **禁止凑数**：最多 10 条，少于 10 条如实展示，禁止编造
- **展示闭环**：每条含推荐理由（≥15 字、禁止空话模板）；文末必须附 10 个细分词引导下一轮查询

---

## 使用场景

当用户提出下列类型需求时，应调用本 Skill：

| 用户可能会问                            | Agent 行为概要                                   |
| --------------------------------------- | ------------------------------------------------ |
| 「最近有什么爆款」「看看全站热门」      | 关键词传 `""`，按默认时间窗查询全站热门          |
| 「职场 / 情感领域有什么爆款」（大类词） | 走泛化词流程：先给细分词 + 等待「拓展 / 不拓展」 |
| 「职场沟通技巧」「亲子教育选题」        | 视为细分词，可直接调用脚本（无需拓展询问）       |
| 「近 15 天的 xxx」                      | 将口语映射为 `startDate = 今天 - N 天` 后查询    |
| 「要高赞 / 高分享的」                   | 意图类型归为数据需求型，筛选时侧重互动与数据表现 |

### 典型示例

**场景一：无赛道浏览**

> 用户：最近公众号有什么爆款文章？
> 助手：`--keyword ""` 拉全站热门 → 展示卡片与 HTML → 再给 10 个热门赛道细分词。

**场景二：大类词需拓展**

> 用户：帮我看看职场类的爆款。
> 助手：识别「职场」为泛化词 → 仅回复细分词列表并说明「拓展 / 不拓展」→ **本轮不调用脚本** → 用户回复后再执行查询。

**场景三：自带细分描述**

> 用户：我是情感号，做恋爱、婚姻、婆媳方向，给我热门参考。
> 助手：提取「情感、恋爱技巧、婚姻经营、婆媳关系」等多词逗号查询 → 意图筛选 → 展示 ≤10 条。

---

## 重要数据说明

**时间与实时性**

- **数据时间差说明**：文章互动数据截止为 **数据获取时间**，互动量可能持续增长，后续会持续更新。
- 默认时间范围：**最近 7 天**（`startDate = 今天 - 7 天`）；数据不足时 **自动扩展范围**，并按下文固定话术 **告知用户**。

**边界话术（须原文使用）**

- 用户提及「今天 / 今日」：**「非常抱歉，今天的数据暂未更新，已为您展示最近可用的数据」**
- 用户要求的时间超出 30 天：**「非常抱歉，当前仅支持最近30天的数据，已为您展示最接近的数据」**

---

## 核心执行规则（必须遵守）

1. **泛化词必须先问再查**：识别为泛化词时 **禁止直接调用脚本**；须先输出细分词推荐并等待用户选择。
2. **正确顺序**：关键词提取 → 判断是否泛化词 → 泛化词则询问 → **用户回复后再调用脚本**。
3. **强制等待**：输出细分推荐后 **必须停止本轮脚本执行**；不得在同一 assistant 回合内继续调用脚本。

**泛化词 vs 具体词（定义须保留，用于判定）**

- **泛词**：抽象层级高、覆盖范围广的概括性词汇，无具体场景/属性修饰，常为行业大类；语义为上位概念（如「职场」含工作/打工人；「情感」含恋爱/婚姻；如 AI）；上下文中常搭配「领域」「类型」等（如「职场领域」「情感类型」）。
- **具体词**：抽象层级低、指向明确，含场景/属性修饰，为某泛词的直接子类；语义为下位概念（如「职场沟通」属职场技能子类；「恋爱技巧」属情感子类）；结构常含修饰（如「婆媳」→「婆媳关系」；「亲子」→「亲子教育」）。

---

## 项目架构

### 目录与脚本（参考）

```
gzh-explosive-content-detector/
├── SKILL.md                          # 本技能文档
├── scripts/
│   └── fetch_gzh_trends.py           # 数据拉取与 HTML 生成入口
└── （运行产出）{keyword}_爆款数据.html
    （若脚本生成）{keyword}_爆款数据.json
```

### 数据流（概念）

```
用户请求 → 意图/关键词/泛化词判定 → fetch_gzh_trends.py → HTML（+ JSON）
                ↓
        筛选与卡片渲染说明 ← 意图 + 相关性 + 数据分
```

---

## 常见问答

**Q1：用户只说「职场」，能不能直接查？**
A：**不能**。须先走泛化词拓展并等待「拓展 / 不拓展」，同一轮禁止脚本。

**Q2：什么时候关键词传空？**
A：用户 **未给出任何赛道或主题词**，仅泛泛要看爆款 / 热门时，传 `""` 查全站。

**Q3：数据为空怎么办？**
A：提示关键词较为冷门，建议更换为更热门的赛道关键词；**不得**因数据少而改用无关关键词或误触发泛化词拓展流程。

---

## 更新日志

### v1.1.1

- 与原版执行逻辑对齐校验：补回固定话术、筛选步骤、卡片示例、自检原文及「拓展=逗号多词」等约束，避免重构引入歧义

### v1.1.0

- 参照模板重构文档结构（简介 / 场景 / 指南 / 架构 / FAQ）
- 合并重复的数据说明与展示要求，修正泛化词示例代码块格式

### v1.0.0

- 爆款探测、泛化词治理、筛选与双形态展示、细分推荐与自检清单