git:20260527.20d0351 to git:20260602.08c4de8

---

name: wechat-search

description: 公众号搜索工具，支持按关键词搜索爆款文章，展示推荐热门文章，助力内容创作者把握趋势与获取灵感；当用户需要搜索公众号文章、查找爆款内容、获取创作灵感时使用

dependency:

python:

- 无第三方依赖（纯标准库：urllib.request, json, os, sys, argparse, datetime）

---

# 公众号热门文章查询

### 鉴权

#### 获取 API Key

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

#### 配置 API Key

```bash

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

```

方案2: 终端配置

```bash

export REDFOX_API_KEY="ak_xxxx..."

```

**时间范围**：

- 数据库只包含昨天至30天前的数据

- **"最近"的默认定义**：最近7天（startDate = 今天 - 7天）

- **日期计算**（将用户表达转换为 startDate）：

- 今天：直接用昨天日期，startDate = 昨天

- 最近/近7天：startDate = 今天 - 7天

- 近N天：startDate = 今天 - N天

- 示例：用户说"近15天" → startDate = 今天 - 15天

**数据不足时的自动拓展时间**：

- ✅ 每次拓展后重新调用脚本查询，直到获取到数据或拓展到30天为止

- ❌ **禁止自动扩展关键词搜索**：搜索结果不足10条时，禁止用拓展词/相关词/同义词再次调用接口搜索

- ❌ **禁止自动尝试相关搜索建议**

**超出范围或未更新数据的道歉说明**：

- 用户说"今天/今日"时：回答"非常抱歉，今天的数据暂未更新，已为您展示最近可用的数据"

- 用户要求的时间超出30天时：回答"非常抱歉，当前仅支持最近30天的数据，已为您展示最接近的数据"

**输出文件**：

- JSON数据：输出到标准输出（stdout）

- HTML文件：`{keyword}_趋势数据.html`（可选）

---

**⚠️ 强制输出规则**：

- ✅ 必须严格按照本步骤规定的格式输出

- ❌ 禁止在输出前添加任何分析或解读

- ❌ 禁止自作主张给建议或方案

- ❌ 禁止询问用户的真实目的或需求

- ✅ 直接读取脚本返回的JSON数据，按照对应策略输出即可

**数据字段说明**：

- **articles**：正常文章数据（主要展示内容）

- **latestHotArticles**：推荐热门文章（辅助内容，默认展示10条，表格不含评分字段）

- **hotTopics**：热门话题（接口返回，仅供参考，不在对话中展示）

展示内容：

1. **时间范围说明**：必须告知用户查询的时间范围，如"📅 查询时间范围：5月8日 - 5月19日"

2. 正常文章数据（按totalScore降序排序）

3. 拓词推荐（relatedSearches）

**Markdown表格格式**：

⚠️ **表格字段顺序必须严格按以下顺序展示**：

| 文章标题 | 作者 | 阅读数 | 发布时间 | 相关性 | 热度 | 时效 | **总分** |

**注意**：总分字段需要加粗显示（使用`**分数**`格式）

示例：

📅 查询时间范围：5月8日 - 5月19日

| 文章标题 | 作者 | 阅读数 | 发布时间 | 相关性 | 热度 | 时效 | **总分** |

| ------------------------------------------------------------------------- | ---------- | ------ | ---------- | ------ | ---- | ---- | -------- |

| [职场新人必看：5个让你快速融入团队的技巧](https://mp.weixin.qq.com/s/xxx) | 职场成长社 | 10.0w | 2026-05-15 | 9.8 | 3.0 | 2.0 | **14.8** |

---

**🔤 拓词推荐**：职场沟通、职场晋升、打工人

展示内容：

1. **时间范围说明**：必须告知用户查询的时间范围，如"📅 查询时间范围：5月8日 - 5月19日"

2. **提示信息**："💡当前关键词当前时间段仅找到 X 条结果，您可以尝试拓展词或者拓展时间，我们还为您推荐了近期的热门文章"

3. 正常文章数据

4. 推荐热门文章（latestHotArticles，带"推荐热门文章"标题分区，默认展示10条）

5. 推荐热门话题

6. 拓词推荐（relatedSearches）

**Markdown格式示例**：

📅 查询时间范围：5月8日 - 5月19日

> 💡当前关键词当前时间段仅找到 3 条结果，

| 文章标题 | 作者 | 阅读数 | 发布时间 | 相关性 | 热度 | 时效 | **总分** |

| ------------ | ----- | ------ | ---------- | ------ | ---- | ---- | -------- |

| [文章1](url) | 作者1 | 10.0w | 2026-05-15 | 9.8 | 3.0 | 2.0 | **14.8** |

**您可以尝试拓展词或者拓展时间，我们还为您推荐了近期的热门文章供参考**：

⚠️ 推荐热门文章表格不需要评分字段，格式为：

| 文章标题 | 作者 | 阅读数 | 发布时间 |

|---------|------|--------|----------|

| [热门文章1](url) | 作者A | 8.5w | 2026-05-14 |

| [热门文章2](url) | 作者B | 6.2w | 2026-05-13 |

**📈 推荐热门话题**：

您可以尝试搜索以下热门赛道：

人文、知识、养生、时尚、美食、生活、旅游、搞笑、情感、体育娱乐、美妆、文摘、民生资讯、财富理财、科技数码、创投商业、汽车、房产楼市、职场、教育考试、学术

**⚠️ 必须严格按照以下格式输出，禁止自作主张给建议或分析**

展示内容：

```

🔍 抱歉，爆款文章收录原则为阅读数5000+以上的文章,该搜索词在查询时间范围（5月8日 - 5月19日）内太小众，未找到与"XXX"直接相关的内容，你可以尝试用更短/宽泛的关键词重试 。

💡 或者您可以尝试搜索以下热门赛道：

人文、知识、养生、时尚、美食、生活、旅游、搞笑、情感、体育娱乐、美妆、文摘、民生资讯、财富理财、科技数码、创投商业、汽车、房产楼市、职场、教育考试、学术

我们为您推荐近期最热门的文章，您也可以关注~

```

在以上内容之后，展示latestHotArticles数据（如果有），热门推荐表格不需要评分字段：

| 文章标题 | 作者 | 阅读数 | 发布时间 |

| ---------------- | ----- | ------ | ---------- |

| [热门文章1](url) | 作者A | 8.5w | 2026-05-14 |

| [热门文章2](url) | 作者B | 6.2w | 2026-05-13 |

**输出规则**：

- ✅ 必须直接输出上述格式内容

- ❌ 禁止添加额外的分析或建议

- ❌ 禁止解释为什么搜不到数据

- ❌ 禁止主动提供其他搜索方案

- ❌ 禁止询问用户的真实目的

---

**当articles数量 > 10条时**：

1. 初始默认只展示前10条数据

2. 必须提示用户：

```

💡 当前共找到 X 条相关文章，已展示前10条。是否需要查看全部？

```

3. 等待用户回复：

- 用户回复"是"/"查看全部"/"全部" → 展示全部数据

- 用户回复"否"/"不用"/"不需要" → 不展示更多

**展示全部数据时的格式**：

```

📊 全部结果（共X条）：

| 文章标题 | 作者 | 阅读数 | 发布时间 | 相关性 | 热度 | 时效 | **总分** |

|---------|------|--------|----------|--------|------|------|------|

| ...（全部数据）...

```

---

**当articles数量 > 0时，结果输出完成后必须询问**：

```

📬 订阅服务

1️⃣ 是否需要订阅当前搜索条件文章，订阅后将定时推送给您？

2️⃣ 暂不需要

```

**处理用户回复**：

- 用户选择1️⃣ → 使用 `calendar_create` 工具创建日程，订阅当前搜索条件

- 用户选择2️⃣ → 结束当前对话

**订阅实现步骤**：

1. **告知数据更新时间并询问推送时间**：

```

📅 数据更新时间：每日早上7点更新昨日数据

请告诉我您希望推送的具体时间~

```

2. **用户选择后，调用 `calendar_create` 工具**：

- **title**：`公众号趋势订阅：{关键词}`

- **description**：记录当前搜索参数（关键词、时间范围）

- **start_time**：根据用户选择的时间设置

- **remind_type**：设置为定期提醒

- 其他参数使用当前查询参数

3. **订阅成功后提示**：

```

✅ 订阅创建成功！

📌 订阅信息：

- 关键词：{关键词}

- 时间范围：{当前时间范围}

- 推送时间：{用户选择的时间}

- 数据更新：每日早上7点更新昨日数据

到达设定时间后，将自动为您推送最新的公众号爆款文章。

```

**⚠️ 强制规则**：

- ✅ 必须在结果输出完成后立即询问

- ✅ 用户选择订阅时，必须使用 `calendar_create` 工具

- ✅ 参数必须使用当前查询参数（关键词、时间范围等）

- ❌ 禁止跳过此步骤

- ❌ 禁止在展示结果前询问

---