{"skill":{"slug":"gzh-growth-rank","displayName":"公众号黑马账号推荐","summary":"每日账号推荐速览直接对接官方最具“黑马体质”的阅读增长榜单，按日期查看公众号阅读增长率TOP榜。每个作者只展示最高阅读那篇，标题做成可点击链接，一秒直达原文。","description":"---\r\nname: wechat-fastest-growing\r\ndescription: 每日账号推荐速览直接对接官方最具“黑马体质”的阅读增长榜单，按日期查看公众号阅读增长率TOP榜。每个作者只展示最高阅读那篇，标题做成可点击链接，一秒直达原文。\r\nversion: 1.0.0\r\n---\r\n\r\n# 公众号黑马账号推荐\r\n\r\n## 简介\r\n\r\n公众号黑马账号推荐是一款面向内容运营与新媒体研究的**阅读增长率排行**查询工具，通过脚本拉取官方榜单数据，帮助用户快速发现近期阅读量增速快的公众号与代表作。\r\n\r\n通过本 Skill，你可以：\r\n\r\n- 📊 **同作者爆文 vs 最低阅读文对比**：针对同一个账号，对比其“爆文”和“最低阅读文”在选题、标题、切入点上的差异。直接告诉你可以复制的具体打法。\r\n- 📈 **高增长账号类型分析**：分析近期高增长账号的赛道分布和共同策略，判断当下真实流量风向，并给出哪些能迁移到其他平台的建议。\r\n\r\n适用于公众号运营找高增长对标、编辑选题复盘、研究者观察赛道热度等角色。\r\n\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **📊 增长率榜单**：按日期查询公众号阅读增长率排行数据（脚本输出 Markdown 表格）\r\n- **🔗 可点击标题**：表格中标题已为原文链接，便于跳转核对\r\n- **📌 指标说明**：榜单含「综合评分指数」等字段；公式与加权定义见 [references/core_workflow.md](references/core_workflow.md)\r\n- **📈 增长分析**：基于**同一份脚本输出**完成三点输出（爆文表、作品类型表、300–500 字总结），字段与条数上限以核心流程为准\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⏰ 日期语义**：支持口语化「最新/昨天」与指定日；`rankDate` 支持 `\"yesterday\"`、`\"today\"`、`\"YYYY-MM-DD\"`（映射与默认规则见核心流程）\r\n- **🔒 数据真实性**：强制走 `scripts/fetch_growth_rank.py`；**脚本 stdout 须原样展示**，不得改写或重排表格\r\n- **📅 查询窗口**：仅支持**最近 30 天内**的 `rankDate`；查最新时若昨日无数据会**自动向前追溯**（逐天查询，找到即停，见核心流程）\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- Python 3.8 及以上版本\r\n- `requests` 库：`pip install requests`\r\n- 红狐Hub API Key，格式 `ak_xxxxxxxx`\r\n\r\n### 安装方式\r\n\r\n#### SkillHub\r\n\r\n1. 前往 [SkillHub](https://skillhub.cn)\r\n2. 搜索 **wechat-fastest-growing** 或 **公众号黑马账号推荐**\r\n3. 按平台指引完成安装（支持对话安装或本地 Zip 导入）\r\n\r\n#### ClawHub\r\n\r\n1. 前往 [ClawHub](https://clawhub.ai)\r\n2. 搜索 **wechat-fastest-growing** 或 **公众号黑马账号推荐**\r\n3. 可使用 CLI：`openclaw skills install wechat-fastest-growing` 或 `clawhub install wechat-fastest-growing`，或下载 skill 包本地导入\r\n\r\n#### 方式二：命令行独立使用\r\n\r\n无需安装技能包，配置好 API Key 后可直接运行脚本：\r\n\r\n```bash\r\npip install requests\r\npython scripts/fetch_growth_rank.py --rankDate yesterday\r\n```\r\n\r\n安装完成后，访问 [红狐 Hub](https://redfox.hk/)网站 [登录](https://redfox.hk/login) 注册并获取 API Key（新用户获赠免费积分），配置环境变量 `REDFOX_API_KEY`（见下方），重启终端即可在对话中发起查询。\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|---|---|---|\r\n| `REDFOX_API_KEY` | 是 | 红狐 Hub API 访问密钥，格式 `ak_xxxxxxxx` |\r\n| `COZE_REDFOX_API_7633629455969337344` | 否 | 兼容旧变量名（脚本自动回退读取） |\r\n\r\n**macOS / Linux**：\r\n\r\n```bash\r\necho 'export REDFOX_API_KEY=<你的apikey>' >> ~/.zshrc\r\nsource ~/.zshrc\r\n```\r\n\r\n**Windows**（PowerShell）：\r\n\r\n```powershell\r\n[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<你的apikey>\", \"User\")\r\n```\r\n\r\n配置后需重启终端。验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows）。\r\n\r\n> **三级回退机制**：脚本读取 API Key 时，按环境变量 → shell 配置文件（~/.bashrc / ~/.zshrc / ~/.bash_profile / ~/.profile）→ 提示用户配置的顺序自动获取，无需显式传入。\r\n\r\n## 鉴权\r\n\r\n### 获取 API Key\r\n\r\n1. 访问 [红狐Hub 官网](https://redfox.hk/) 了解服务详情\r\n2. 前往 [注册页面](https://redfox.hk/login) 注册账号\r\n3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务\r\n4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`\r\n\r\n### 配置 API Key\r\n\r\n- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`\r\n- 脚本支持三级回退读取：环境变量 → shell 配置文件自动探测 → 提示手动配置\r\n- 推荐通过环境变量持久化配置（详见上方 [环境变量配置](#环境变量配置)）\r\n\r\n## 使用指南\r\n\r\n\r\n### 基础使用\r\n\r\n#### 1. 发起增长榜查询\r\n\r\n在对话中说明日期需求（可省略，默认查昨日）：\r\n\r\n> 用户：公众号增长榜\r\n>\r\n> 助手：已按核心流程使用 `rankDate=\"yesterday\"`拉取；以下为脚本输出的完整表格（原样）。…\r\n\r\n#### 2. 查看榜单结果\r\n\r\n助手运行 `scripts/fetch_growth_rank.py`，将 **stdout 全文原样** 展示（Markdown 表格不得省略、不得自行重算或替换为「摘要表」）。脚本失败或无数据时如实说明，**禁止虚构排名或阅读数**。\r\n\r\n#### 3. 增长趋势分析（按需）\r\n\r\n当用户需要「特点、规律、为什么增长快」等解读时，在已展示的真实榜单基础上，按核心流程完成 **3 块输出**（爆文分析表 ≤5 条、作品类型分析表 ≤5 条、总结 300–500 字）。\r\n\r\n### 高级使用\r\n\r\n#### 1. 指定日期与参数\r\n\r\n根据用户说法确定 `rankDate`。日期超出最近 30 天时说明不支持，**不得编造**榜单。\r\n\r\n> 用户：看下 3 月 15 号的增长榜\r\n>\r\n> 助手：使用 `rankDate=\"2026-03-15\"` 调用脚本；以下为 stdout 原样表格。…\r\n\r\n#### 2. 命令行直接拉榜\r\n\r\n在项目目录执行（参数名与取值须一致）：\r\n\r\n```bash\r\npython scripts/fetch_growth_rank.py --rankDate \"\"\r\n```\r\n\r\n#### 3. 结构化增长解读\r\n\r\n> 用户：最近哪些号增长快，有什么共性？\r\n>\r\n> 助手：先输出脚本榜单（原样），再按核心流程给出两张分析表与一段总结。…\r\n\r\n#### 4. 遵循核心流程硬性约束\r\n\r\n执行榜单获取与增长分析前，须打开并遵循 [references/core_workflow.md](references/core_workflow.md)（用户意图 → `rankDate` → 脚本参数 → 三点分析）。不得跳过其中的硬性约束。\r\n\r\n### 常用命令速查\r\n\r\n| 用户说法 / 命令 | 功能 |\r\n|---|---|\r\n| 「最新 / 今日 / 公众号增长榜」 | `rankDate` 按核心流程映射（多为 `yesterday`） |\r\n| 「昨天 / 指定某日期的增长榜」 | `rankDate` 为 `YYYY-MM-DD` 或规则允许的别名 |\r\n| 「增长趋势 / 特点 / 规律」 | 脚本表格原样 + 核心流程规定的 3 段分析 |\r\n| `python scripts/fetch_growth_rank.py --rankDate yesterday` | 命令行拉取昨日增长榜 |\r\n\r\n## 使用场景\r\n\r\n### 场景一：找高增长对标\r\n\r\n**角色**：公众号运营\r\n\r\n**需求**：想看近期阅读量增速快的账号与代表作\r\n\r\n**使用方式**：\r\n\r\n1. 按日期跑脚本拉取增长榜\r\n2. 原样展示表格，点击标题跳转原文核对\r\n3. 可选追问增长特点与共性分析\r\n\r\n**预期收益**：快速锁定对标账号与爆款选题方向\r\n\r\n---\r\n\r\n### 场景二：选题与复盘\r\n\r\n**角色**：内容编辑\r\n\r\n**需求**：结合榜单看爆款标题与账号策略\r\n\r\n**使用方式**：\r\n\r\n1. 拉取指定日或「最新」增长榜\r\n2. 按核心流程输出爆文分析表与作品类型表\r\n3. 阅读 300–500 字总结提炼规律\r\n\r\n**预期收益**：为下一轮选题提供可验证的数据参考\r\n\r\n---\r\n\r\n### 场景三：指定日复盘\r\n\r\n**角色**：分析师 / 管理者\r\n\r\n**需求**：核对某一天的增长排行是否异常\r\n\r\n**使用方式**：\r\n\r\n1. 使用 `rankDate=\"YYYY-MM-DD\"` 查询（注意 30 天窗口）\r\n2. 对比综合评分指数与阅读、互动指标\r\n3. 对异常条目跳转原文二次核实\r\n\r\n**预期收益**：发现单日数据波动与潜在运营动作\r\n\r\n---\r\n\r\n### 场景四：赛道观察\r\n\r\n**角色**：研究者\r\n\r\n**需求**：粗看哪些账号在增速榜上集中出现\r\n\r\n**使用方式**：\r\n\r\n1. 连续多日拉榜，观察重复出现的账号\r\n2. 先看原样榜单，需要时再要结构化分析\r\n3. 结合作品类型表归纳赛道内容形态\r\n\r\n**预期收益**：把握赛道热度迁移与内容形态变化\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n\r\n```\r\nwechat-fastest-growing/\r\n├── SKILL.md # 产品说明文档\r\n├── references/\r\n│ ├── core_workflow.md # 标准流程、公式、分析字段与硬性约束\r\n│ └── api-spec.md # 红狐 Hub API 参数与响应说明\r\n└── scripts/\r\n └── fetch_growth_rank.py # 调用 API 获取榜单并输出 Markdown 表格\r\n```\r\n\r\n### 技术栈\r\n\r\n| 项目 | 说明 |\r\n|---|---|\r\n| 运行环境 | Python 3.8+ |\r\n| 核心依赖 | `requests`（其余为标准库） |\r\n| 数据来源 | 红狐 Hub API（`getGzhCozeSkillDataRaise`） |\r\n| 部署方式 | SkillHub / ClawHub / 命令行脚本 |\r\n\r\n### 核心模块\r\n\r\n| 模块 | 职责 |\r\n|---|---|\r\n| `fetch_growth_rank.py` | 解析 `rankDate`、调用红狐 Hub API、输出 Markdown 榜单表格（标题为可点击链接） |\r\n| `core_workflow.md` | 用户意图映射、`rankDate` 规则、stdout 原样约束、三点分析模板与条数上限 |\r\n| `api-spec.md` | 接口地址、鉴权、请求参数与字段说明 |\r\n\r\n\r\n## 常见问答\r\n\r\n### 安装相关问题\r\n\r\n**Q1：未检测到 API Key 怎么办？**\r\n\r\n按 [一键安装](#一键安装) 注册红狐Hub 并配置 `REDFOX_API_KEY`。新注册用户有免费积分。\r\n\r\n**Q2：如何验证配置已生效？**\r\n\r\n执行 `echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确认输出为 `ak_` 开头。若未生效，重启终端。\r\n\r\n**Q3：支持哪些部署方式？**\r\n\r\n支持 SkillHub、ClawHub 平台安装，也可直接运行 `scripts/fetch_growth_rank.py` 独立调用。\r\n\r\n---\r\n\r\n### 使用相关问题\r\n\r\n**Q4：`rankDate` 支持哪些写法？**\r\n\r\n支持 `\"yesterday\"`、`\"today\"`、`\"YYYY-MM-DD\"`。口语「最新/增长榜」等多映射为 `yesterday`；数据为空时自动向前一天追溯，逐天查询直到找到有数据的日期，找到后立即停止（见核心流程）。\r\n\r\n**Q5：可以查询多久以前的数据？**\r\n\r\n仅支持**最近 30 天**内；超出范围脚本会报错，请勿让模型编造榜单。\r\n\r\n**Q6：增长分析包含哪些内容？**\r\n\r\n在用户需要解读时：爆文分析表（≤5 条）、作品类型分析表（≤5 条）、300–500 字总结；均须基于脚本真实输出，不得幻觉。\r\n\r\n**Q7：表格里的「综合评分指数」怎么算？**\r\n\r\n公式：8 + 2 × ((加权值/阅读数 - 0.2) / 0.8)，范围 8–10；加权值 = 转发×10×0.35 + 在看×5×0.25 + 点赞×2×0.15 + 阅读×1×0.25。详见 [core_workflow.md](references/core_workflow.md)。\r\n\r\n---\r\n\r\n### 故障排除\r\n\r\n**Q8：脚本返回空数据或失败？**\r\n\r\n确认 `REDFOX_API_KEY` 有效、日期在 30 天窗口内。查看脚本 stderr 错误信息，勿用模型补齐排行。\r\n\r\n---\r\n\r\n### 安全与许可\r\n\r\n**Q9：API Key 如何保管？**\r\n\r\n`REDFOX_API_KEY` 仅通过环境变量读取，请勿写入代码仓库或公开分享。\r\n\r\n**Q10：数据使用边界？**\r\n\r\n榜单仅以脚本成功输出为准；引用外链与标题时遵守平台与版权规范，不对未经验证的数据做夸大承诺。\r\n\r\n## 核心工作流程\r\n\r\n完整流程**必须先读取** [references/core_workflow.md](references/core_workflow.md) 并遵循其中的规则、脚本路径与输出约束；正文以下为提纲与召回用说明。\r\n\r\n输出格式、用户意图映射、脚本参数、三点分析字段与注意事项详见 [references/core_workflow.md](references/core_workflow.md)。\r\n\r\n执行任务时须严格遵循，包括但不限于：\r\n\r\n- 必须调用 `scripts/fetch_growth_rank.py`，禁止模型自行生成榜单\r\n- 脚本 stdout Markdown 表格须**原样**呈现\r\n- 增长解读的三表一条数、字数上限以核心流程为准\r\n\r\n## 注意事项\r\n\r\n- **数据**：榜单仅以脚本成功输出为准；不可用模型幻觉补齐排行、阅读量或链接\r\n- **输出**：标题列已为可点击链接，勿改成纯文本以免丢跳转\r\n- **日期**：仅支持最近 30 天内查询；「最新」场景下昨日无数据时回退前天\r\n- **合规**：遵守平台与版权规范；不对未经验证的数据做夸大或虚假效果承诺\r\n","topics":["WeChat"],"tags":{"latest":"1.0.4","wechat":"1.0.3"},"stats":{"comments":0,"downloads":549,"installsAllTime":21,"installsCurrent":1,"stars":1,"versions":5},"createdAt":1778317318417,"updatedAt":1780630459943},"latestVersion":{"version":"1.0.4","createdAt":1780630459943,"changelog":"- Renamed the skill from \"gzh-growth-rank\" to \"wechat-fastest-growing\" and updated the description and product presentation to focus on黑马账号推荐 and reading growth rate ranking.\n- Added detailed user and developer English/Chinese README files, expanding installation, usage, API Key configuration, and troubleshooting information.\n- Clarified and updated the workflow, scenarios, technical stack, and table output requirements for better usability and clarity.\n- Removed \"skill-card.md\" in favor of more comprehensive READMEs.\n- Enhanced instructions for authentication, command-line usage, and platform-specific deployment.","license":"MIT-0"},"metadata":null,"owner":{"handle":"if530770","userId":"s17dj64hf08x3mak1j99vesphd84gs9c","displayName":"if530770","image":"https://avatars.githubusercontent.com/u/46310539?v=4"},"moderation":null}