菜单
公众号热门账号推荐快速获取微信公众号综合实力排行榜TOP50，支持按日榜/周榜/月榜及垂直领域筛选，展示综合评分以及详细数据。支持深度分析单个账号、导出HTML可视化报告、订阅日/周/月榜推送。当用户需要查询公众号实力排行、按时间或领域筛选、查看互动指标、获取榜单解读、导出图表或接收定期推送时使用。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/redfox-data/redfox-community --skill wechat-top-account命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
文旅B站信息源 — 搜索文旅相关B站热门视频，按点赞量筛选最火内容，生成精美 HTML 报告。当用户需要文旅B站、旅游攻略、景区热度、文旅资讯、文旅爆款内容时使用。触发词：文旅B站、文旅信息源、文旅资讯、旅游B站、景区视频、文旅爆款。
文旅抖音信息源 — 搜索文旅相关抖音热门作品，按点赞量筛选最火内容，生成精美 HTML 报告。当用户需要文旅抖音、旅游攻略、景区热度、文旅资讯、文旅爆款内容时使用。触发词：文旅抖音、文旅信息源、文旅资讯、旅游抖音、景区视频、文旅爆款。
文旅公众号信息源 — 搜索文旅相关公众号热门文章，按阅读量筛选最火内容，生成精美 HTML 报告。当用户需要文旅公众号、旅游攻略、景区热度、文旅资讯、文旅爆款内容时使用。触发词：文旅公众号、文旅信息源、文旅资讯、旅游公众号、景区文章、文旅爆款。
基于 SOC 职业分类
正在显示 SKILL.md
| name | wechat-top-account |
| description | 公众号热门账号推荐快速获取微信公众号综合实力排行榜TOP50，支持按日榜/周榜/月榜及垂直领域筛选，展示综合评分以及详细数据。支持深度分析单个账号、导出HTML可视化报告、订阅日/周/月榜推送。当用户需要查询公众号实力排行、按时间或领域筛选、查看互动指标、获取榜单解读、导出图表或接收定期推送时使用。 |
公众号热门账号推荐是一款微信公众号综合实力排行查询工具，帮助用户快速获取同赛道头部账号的阅读与互动数据，支撑运营对标与竞品跟踪。
通过对话或命令行，你可以：
适用于公众号运营者、MCN 机构、品牌营销人员及需跟踪公众号竞争格局的内容团队。
REDFOX_API_KEY 从环境变量获取，格式 ak_xxxxxxxx。脚本采用三级认证回退：
| 优先级 | 来源 | 说明 |
|---|---|---|
| 1 | 环境变量 REDFOX_API_KEY | 直接读取当前会话的环境变量 |
| 2 | Shell 配置文件 | 自动读取 ~/.zshrc / ~/.bashrc / ~/.bash_profile / PowerShell Profile 中的配置 |
| 3 | 用户输入 | 若以上均未检测到，提示用户手动配置 |
macOS / Linux：
echo 'export REDFOX_API_KEY=<你的apikey>' >> ~/.zshrc
source ~/.zshrc
Windows（PowerShell）：
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的apikey>", "User")
或将以下内容写入 PowerShell Profile：
$env:REDFOX_API_KEY = "<你的apikey>"
配置后需重启终端。验证：echo $REDFOX_API_KEY（macOS/Linux）或 $env:REDFOX_API_KEY（Windows PowerShell）。
requests 库：pip install requestsak_xxxxxxxxopenclaw skills install wechat-top-account 或 clawhub install wechat-top-account安装完成后，请先完成 鉴权 配置 API Key，重启终端即可在对话中发起查询。
无需安装技能包，配置好 API Key 后可直接运行 scripts/ 下脚本：
pip install requests
python scripts/gzh_growth_fetcher.py --list_categories
| 变量名 | 必填 | 说明 |
|---|---|---|
REDFOX_API_KEY | 是 | 红狐Hub API 访问密钥，格式 ak_xxxxxxxx |
详细获取与配置步骤见上方 鉴权 章节。
在对话中输入查询需求，系统自动识别榜单类型和分类：
用户：查询科技类公众号日榜
助手：输出科技数码分类日榜 TOP50 表格（含综合评分、阅读与互动指标），并附功能询问文案。
榜单数据直接输出，无需确认。每条结果包含排名、账号名称（可跳转）、综合评分、发布数/文章数、总阅读、头条阅读、最高阅读、总点赞、总在看、总转发。
用户：本周美食类公众号排名
助手：输出美食餐饮周榜 TOP50，标注数据时间周期与更新时间。
榜单输出后，可按需选择后续服务：
用户：1
助手：基于 TOP50 数据输出内容生态变化、热点影响、蓝海赛道三类分析。
回复 1 获取分析、2 生成 HTML 报告、3 或「订阅日/周/月榜」开启定时推送。
通过 --category 或 --keyword 精确匹配分类，--rank_date 指定查询日期（超出范围自动调整）：
# 首次查询时必须同时保存到临时文件（唯一一次API调用）
python scripts/gzh_growth_fetcher.py --rank_type week --category "美食餐饮" --top_n 50 > /tmp/gzh_result.json 2>/dev/null
python scripts/gzh_growth_fetcher.py --rank_type month --keyword "财经" --rank_date 2026-04-01 --top_n 50 > /tmp/gzh_result.json 2>/dev/null
用户选择 HTML 功能后，使用已保存的数据生成可导出图片/PDF 的页面（不调用API）：
python scripts/gen_gzh_html.py --input_json_file /tmp/gzh_result.json --top 50
用户确认后，基于当前 TOP50 全量数据输出三段式分析：内容生态变化、热点影响力量化、蓝海赛道挖掘。
用户回复「订阅日榜」「订阅周榜」「订阅月榜」或「全部订阅」，系统将按对应更新时间推送最新榜单。
完整参数、输出模板与日期校验逻辑见 核心工作流程。
| 命令 | 功能 |
|---|---|
python scripts/gzh_growth_fetcher.py --rank_type day --keyword "科技" --top_n 50 > /tmp/gzh_result.json 2>/dev/null | 科技类日榜 TOP50（首次查询，同时保存文件） |
python scripts/gzh_growth_fetcher.py --rank_type week --category "美食餐饮" --top_n 50 > /tmp/gzh_result.json 2>/dev/null | 美食餐饮周榜 TOP50（首次查询，同时保存文件） |
python scripts/gzh_growth_fetcher.py --rank_type month --keyword "财经" --top_n 50 > /tmp/gzh_result.json 2>/dev/null | 财经类月榜 TOP50（首次查询，同时保存文件） |
python scripts/gzh_growth_fetcher.py --list_categories | 列出全部可用分类 |
python scripts/gen_gzh_html.py --input_json_file /tmp/gzh_result.json --top 50 | 用预取数据生成 HTML（不调用API） |
python scripts/gzh_growth_fetcher.py --input_json_file /tmp/gzh_result.json | 用预取数据重新分析（不调用API） |
角色：公众号运营者
需求：了解所属赛道头部账号的内容产出与互动表现
使用方式：
预期收益：明确对标账号，优化选题与发布节奏
角色：品牌营销经理
需求：跟踪竞品公众号排名与互动变化
使用方式：
预期收益：及时掌握竞品内容发力方向，调整自身策略
角色：内容创业者
需求：评估候选赛道的竞争度与阅读需求
使用方式：
预期收益：选择竞争度低、需求旺盛的方向切入
角色：MCN 机构运营人员
需求：为内部复盘或客户汇报提供可视化数据
使用方式：
预期收益：提升汇报效率，数据口径统一可追溯
wechat-top-account/
├── SKILL.md # 产品说明文档
├── references/
│ └── core_workflow.md # 核心工作流程（模板、逻辑、步骤）
├── scripts/
│ ├── gzh_growth_fetcher.py # 榜单数据抓取
│ └── gen_gzh_html.py # HTML 可视化报告生成
└── assets/ # 静态资源
| 项目 | 说明 |
|---|---|
| 运行环境 | Python 3.8+ |
| 核心依赖 | requests |
| 数据来源 | 红狐Hub API |
| 部署方式 | SkillHub / ClawHub / 命令行脚本 |
| 模块 | 职责 |
|---|---|
gzh_growth_fetcher.py | 通过 红狐Hub API 获取榜单数据，支持关键词匹配分类、日期校验与三级认证回退 |
gen_gzh_html.py | 将榜单数据渲染为可导出图片和 PDF 的 HTML 页面 |
core_workflow.md | 输出格式模板、Checklist、日期计算逻辑、完整操作步骤 |
| 榜单 | 更新时间 | 数据范围 |
|---|---|---|
| 日榜 | 每日 17:30 | 昨日数据，近 7 天 |
| 周榜 | 每周一 17:30 | 上周数据，近 3 周 |
| 月榜 | 每月 3 号 23:00 | 上月数据，近 3 个月 |
Q1：未检测到 API Key 怎么办？
按 鉴权 章节步骤注册 红狐Hub 并配置 REDFOX_API_KEY 环境变量。新注册用户有免费积分。
Q2：如何验证配置已生效？
执行 echo $REDFOX_API_KEY，确认输出格式为 ak_xxxxxxxx。若未生效，检查终端是否已重启。
Q3：支持哪些部署方式？
支持 SkillHub、ClawHub 平台安装，也可直接运行 scripts/ 下 Python 脚本独立调用。
Q4：支持哪些分类？
共 23 个分类：总排名、乐活生活、人文资讯、企业品牌、体育娱乐、健康养生、创投商业、学术研究、情感心理、房产楼市、搞笑幽默、教育考试、文摘精选、旅游出行、时尚潮流、民生资讯、汽车交通、知识百科、科技数码、美容美体、美食餐饮、职场发展、财富理财。
Q5：数据可回溯多久？
日榜近 7 天、周榜近 3 周、月榜近 3 个月。超出范围时系统自动调整至最近可用数据。
Q6：榜单与 HTML 报告数据是否一致？
两者共用同一 API 接口，数据完全一致。
Q7：数据多久更新一次？
日榜每日 17:30、周榜每周一 17:30、月榜每月 3 日 23:00 更新。
Q8：查询返回空数据？
确认分类名称准确（可用 --list_categories 列出全部分类），检查查询日期在有效范围内。
Q9：HTML 生成失败？
确认已安装 requests 库且 API Key 有效，查看脚本错误输出定位原因。
Q10：API Key 如何保管？
REDFOX_API_KEY 仅通过环境变量读取，请勿写入代码仓库或公开分享。Key 泄露可能导致积分被消耗。
Q11：数据来源与使用范围？
榜单数据由 红狐Hub 平台提供，仅供运营分析、竞品跟踪等合法商业用途，请遵守平台服务条款。
输出格式模板、数据校验规则、日期计算逻辑、操作步骤及使用示例详见 references/core_workflow.md。
执行任务时须严格遵循 core_workflow.md 中的：
--input_json_file 读取，禁止重复调用 APIformatted_markdown 字段已包含完整的标准模板格式，直接原样输出即可，禁止自行拼装或修改格式