wechat-account-search

name	wechat-account-search
description	公众号账号搜索工具。输入关键词就能搜到微信公众号博主账号，账号名称、账号ID、账号简介一览无余。当用户需要搜索公众号账号、查找公众号博主、了解公众号创作者时使用。触发词：公众号账号搜索、公众号博主、搜公众号、公众号查询、公众号KOL、公众号达人。

公众号账号搜索

📝 简介

输入关键词就能搜到微信公众号博主账号，账号名称、账号ID、账号简介一览无余。

✨ 功能特性

功能模块	能力描述	核心价值
关键词搜索	输入关键词搜索公众号博主账号	精准发现目标领域的公众号
数据展示	展示账号名称、账号ID、账号简介	快速了解账号定位和内容方向
翻页浏览	每页展示多条结果，支持多页翻看	不遗漏任何一个账号

🎯 适用对象

• 🔍 内容创作者 — 找同领域公众号，研究对标账号的内容方向和运营思路。
• 📊 运营 / 数据分析 — 快速摸清某个品类在公众号上有哪些头部账号，掌握竞争格局。
• 🏢 品牌 / MCN — 筛选潜在合作账号，按领域评估账号价值，辅助合作决策。
• 📝 文案策划 — 搜索细分赛道的公众号，寻找选题灵感和内容参考。

🔑 鉴权

获取 API Key

请前往 红狐hub 获取 API KEY

配置 API Key

方案1: 以 OpenClaw 为例，将 REDFOX_API_KEY 添加到 ~/.openclaw/openclaw.json 中：

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

方案2: 终端配置

export REDFOX_API_KEY="ak_xxxx..."

🔄 工作流程

Step 1：理解用户意图，提取关键词

⚠️ 核心规则：语义理解优先，优先提取细分方向词，而非泛化大类词

1. 提取关键词

• 从用户描述中提取 2~6 字的细分关键词
• 过滤冗余修饰词：用户说的"xx博主""xx公众号""xx账号""xx达人"，搜索关键词仅取核心部分 xx，去除末尾的"博主""公众号""账号""达人"等类别修饰词。例如"财经博主" → 搜索"财经"，"科技公众号" → 搜索"科技"
• 若用户意图模糊（如"帮我搜公众号"），主动询问：「请问你想搜索哪个方向或领域的公众号？」
• 不得在用户未提供关键词时擅自猜测并调用脚本

2. 识别页码参数（用户未指定时使用默认值）

• 页码（--page）：默认 1
  • 用户提到"下一页"、"第2页" → 对应页码
  • 用户提到"上一页" → 当前页 - 1
  • 未提及页码 → 1（默认）

Step 2：调用搜索脚本

python3 ~/.agents/skills/wechat-account-search/scripts/search_gzh_account.py "<关键词>" [--page 页码]

参数说明：

参数	可选值	含义
keyword	任意字符串	搜索关键词
--page	正整数	页码，从1开始（默认1）
--cursor	整数	翻页游标，从 JSON 输出的 cursor 字段获取

脚本以 JSON 格式输出：

字段	说明
accounts	匹配的账号列表（保持接口原始顺序）
page	当前页码
has_next	是否有下一页（true/false）
total	当前页返回条数
cursor	翻页游标值，供下一页查询使用

⚠️ 完整数据读取规则： 脚本输出 JSON 数据量较大时，终端可能截断中间内容并显示 // This is the omitted part。此时必须读取 Bash 输出中提示的完整文件路径（如 Full output saved to: /path/to/file），使用 Read 工具获取完整 JSON 后再生成表格，确保所有字段数据完整可见，不遗漏任何记录。

每条账号字段：

字段	说明
nickname	账号名称
account_id	账号ID
introduction	账号简介
profile_url	账号跳转链接（account_id 非空时有值，已 URL 编码）

Step 3：判断结果并展示

情况 A：accounts 数量 > 0（有匹配结果）

A1. 告知用户查询范围

📊 关键词「XXX」查询到 N 个公众号账号（第 {page} 页），以下是详细数据：

A2. 渲染 Markdown 表格（全部展示）

| #   | 账号名称         | 账号ID          | 账号简介                                           |
| --- | ---------------- | --------------- | -------------------------------------------------- |
| 1   | [占豪](https://open.weixin.qq.com/qr/code?username=zhanhao668) | zhanhao668 | 国际局势·财经投资·国学哲学丨连续6年新媒体百大人物...     |

账号名称规则： 完整展示，不截断

账号名称链接规则： 当 profile_url 非空时，账号名称附带可点击跳转 [昵称](profile_url)；当 profile_url 为空时，账号名称仅显示纯文本，禁用跳转

账号ID规则： 完整展示原始值

简介规则： 完整展示，不截断

A3. 翻页提示（⚠️ 紧接在表格之后，不可省略，每次必须输出）

• 若 has_next 为 true：

📄 当前第 {page} 页。回复「下一页」继续查看。

• 若 has_next 为 false（已是最后一页）：

📄 当前第 {page} 页，已无更多数据。

翻页时「下一页」调用规则： 若用户回复「下一页」，必须从上一轮 JSON 输出中提取 cursor 值，调用脚本：

python3 ~/.agents/skills/wechat-account-search/scripts/search_gzh_account.py "<关键词>" --page {page+1} --cursor {上一轮返回的cursor值}

⚠️ A1~A3 缺一不可，必须在同一轮输出中连续完成。若缺少 A3，视为执行错误，必须重新补充输出。

情况 B：accounts 数量 = 0（无匹配结果）

B1. 抱歉提示

😔 抱歉，未找到与「XXX」直接相关的公众号账号。

⚠️ B1 必须在同一轮输出中完成，不得中断。

Step 4：结束输出

全部内容展示完毕后，不等待、立刻结束输出。