| 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. 翻页提示（⚠️ 紧接在表格之后，不可省略，每次必须输出）
📄 当前第 {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：结束输出
全部内容展示完毕后，不等待、立刻结束输出。
