shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 数据与分析需要 API Key

公众号热门账号推荐

公众号生态的先看后挖式实力情报系统——先给你全局TOP50榜单看清版图，再按需深挖分析、分步导出HTML、订阅推送，不塞一屏幕信息，听指令办事。

person作者: user_ebee0fcchubcommunity
download下载资源包

公众号热门账号推荐

简介

公众号热门账号推荐是一款微信公众号综合实力排行查询工具，帮助用户快速获取同赛道头部账号的阅读与互动数据，支撑运营对标与竞品跟踪。

通过对话或命令行，你可以：

  • 📊 查询 23 个垂直分类的 TOP50 榜单，支持日榜、周榜、月榜切换
  • 📈 查看综合评分（满分 100）及发布数、阅读分布、点赞、在看、转发等指标
  • 🔍 获取内容生态、热点影响、蓝海赛道三类数据解读
  • 📄 导出 HTML 可视化报告（支持图片/PDF）
  • 🔔 订阅日/周/月榜，按更新时间自动推送

适用于公众号运营者、MCN 机构、品牌营销人员及需跟踪公众号竞争格局的内容团队。

功能特性

🎯 核心功能

  • 📊 多维排行查询：按日榜、周榜、月榜查询 23 个分类 TOP50，输入关键词自动匹配分类
  • 📈 综合评分体系：基于阅读、点赞、在看、转发等指标计算综合评分，满分 100
  • 🔍 深度分析：提供内容生态变化、热点影响力量化、蓝海赛道挖掘三种解读视角
  • 📄 HTML 报告：生成可视化榜单页面，支持导出图片和 PDF
  • 🔔 定时订阅：支持订阅日榜、周榜、月榜，按更新时间自动推送

✨ 特色亮点

  • ⚡ 定时更新：日榜每日 17:30、周榜每周一 17:30、月榜每月 3 日 23:00 自动刷新
  • 📅 有限回溯：日榜近 7 天、周榜近 3 周、月榜近 3 个月，超出范围自动调整并提示
  • 🔗 数据一致：榜单表格与 HTML 报告共用同一 API，顺序与内容完全一致
  • 🔒 API 接入：通过红狐Hub API Key 调用

鉴权

获取 API Key

  1. 访问 红狐Hub 官网 了解服务详情
  2. 前往 注册页面 注册账号
  3. 新注册用户将获赠免费积分，可立即开始使用 API 服务
  4. 注册登录后，在个人中心获取 API Key，格式为 ak_xxxxxxxx

配置 API Key

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）。

一键安装

前置条件

  • Python 3.8 及以上版本
  • requests 库：pip install requests
  • 红狐Hub API Key，格式 ak_xxxxxxxx

安装方式

SkillHub

  1. 前往 SkillHub
  2. 搜索 wechat-top-account 或 公众号热门账号推荐
  3. 安装说明
  • 可通过「通过对话安装」方式安装
  • 如未安装 SkillHub 商店，先安装商店再安装 skill
  • 支持下载 Zip 包到本地，通过本地导入方式安装

ClawHub

  1. 前往 ClawHub
  2. 搜索 wechat-top-account 或 公众号热门账号推荐
  3. 安装说明
  • 支持使用 CLI 命令安装：openclaw skills install wechat-top-account 或 clawhub install wechat-top-account
  • 支持下载 skill 包到本地并导入安装
  • 安装成功后可在对应客户端直接使用

安装完成后，请先完成 鉴权 配置 API Key，重启终端即可在对话中发起查询。

方式二：命令行独立使用

无需安装技能包，配置好 API Key 后可直接运行 scripts/ 下脚本：

pip install requests
python scripts/gzh_growth_fetcher.py --list_categories

环境变量配置

| 变量名 | 必填 | 说明 | |---|---|---| | REDFOX_API_KEY | 是 | 红狐Hub API 访问密钥，格式 ak_xxxxxxxx |

详细获取与配置步骤见上方 鉴权 章节。

使用指南

基础使用

1. 发起榜单查询

在对话中输入查询需求，系统自动识别榜单类型和分类：

用户：查询科技类公众号日榜

助手：输出科技数码分类日榜 TOP50 表格（含综合评分、阅读与互动指标），并附功能询问文案。

2. 查看榜单结果

榜单数据直接输出，无需确认。每条结果包含排名、账号名称（可跳转）、综合评分、发布数/文章数、总阅读、头条阅读、最高阅读、总点赞、总在看、总转发。

用户：本周美食类公众号排名

助手：输出美食餐饮周榜 TOP50，标注数据时间周期与更新时间。

3. 选择扩展功能

榜单输出后，可按需选择后续服务：

用户：1

助手：基于 TOP50 数据输出内容生态变化、热点影响、蓝海赛道三类分析。

回复 1 获取分析、2 生成 HTML 报告、3 或「订阅日/周/月榜」开启定时推送。

高级使用

1. 指定分类与日期

通过 --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

2. 生成 HTML 可视化报告

用户选择 HTML 功能后，使用已保存的数据生成可导出图片/PDF 的页面（不调用API）：

python scripts/gen_gzh_html.py --input_json_file /tmp/gzh_result.json --top 50

3. 获取深度分析解读

用户确认后，基于当前 TOP50 全量数据输出三段式分析：内容生态变化、热点影响力量化、蓝海赛道挖掘。

4. 订阅定时推送

用户回复「订阅日榜」「订阅周榜」「订阅月榜」或「全部订阅」，系统将按对应更新时间推送最新榜单。

完整参数、输出模板与日期校验逻辑见 核心工作流程。

常用命令速查

| 命令 | 功能 | |---|---| | 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） |

使用场景

场景一：日常运营参考

角色：公众号运营者

需求：了解所属赛道头部账号的内容产出与互动表现

使用方式：

  1. 查询所属分类日榜或周榜
  2. 对比发布频率、单篇阅读与互动率
  3. 选择分析功能提取内容策略参考

预期收益：明确对标账号，优化选题与发布节奏

场景二：竞品追踪

角色：品牌营销经理

需求：跟踪竞品公众号排名与互动变化

使用方式：

  1. 按周查询竞品所在分类榜单
  2. 关注排名波动与阅读/转发变化
  3. 订阅周榜定时接收更新

预期收益：及时掌握竞品内容发力方向，调整自身策略

场景三：赛道研判

角色：内容创业者

需求：评估候选赛道的竞争度与阅读需求

使用方式：

  1. 查询多个候选分类的月榜数据
  2. 选择蓝海赛道分析功能
  3. 对比上榜账号数量与平均阅读/评分

预期收益：选择竞争度低、需求旺盛的方向切入

场景四：定期数据汇报

角色：MCN 机构运营人员

需求：为内部复盘或客户汇报提供可视化数据

使用方式：

  1. 订阅日榜和周榜保持数据更新
  2. 按月导出 HTML 报告（图片/PDF）
  3. 结合分析功能撰写复盘结论

预期收益：提升汇报效率，数据口径统一可追溯

项目架构

目录结构

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 中的：

  • 格式优先级声明与分阶段输出规则
  • 输出前必检 Checklist
  • 榜单标准模板与按需输出模板
  • 榜单类型判断与分类匹配规则
  • 日榜 / 周榜 / 月榜日期校验逻辑
  • 数据获取与格式化输出流程
  • API 调用次数上限（同一轮查询仅允许 1 次 API 调用）

注意事项

  • 热门账号推荐榜直接输出，无需确认；分析、HTML、订阅须用户选择后方可生成
  • 榜单表格与 HTML 报告须使用同一数据源，禁止修改接口返回顺序
  • 同一轮查询（榜单+分析+HTML）全过程只允许调用 1 次 API 接口，首次获取数据时必须同时保存到临时文件，后续操作一律使用 --input_json_file 读取，禁止重复调用 API
  • 未收到明确查询指令时，禁止自动调用脚本或输出榜单内容
  • 禁止折叠输出
  • 脚本输出的 formatted_markdown 字段已包含完整的标准模板格式，直接原样输出即可，禁止自行拼装或修改格式