Wechat Account Analyzer Agent Skill

公众号账号诊断

> 基于多维度数据分析，为公众号提供全面的账号健康诊断和优化建议

简介

公众号账号诊断 是一款智能分析工具，通过红狐 API 获取公众号真实运营数据，基于内容健康度、用户活跃度、核心数据表现、运营规范性四维度进行评分诊断，自动生成对标行业水平的优化建议。

• 核心价值：告别主观判断，用数据驱动公众号运营决策。一次诊断即可看清账号全貌，明确优化方向
• 适用对象：公众号号主、新媒体运营、MCN机构、品牌方、内容创作者
• 技术基础：基于红狐数据平台，结合智能评分引擎自动生成诊断报告

功能特性

核心能力

| 功能 | 说明 |

|------|------|

| 📊 四维评分 | 内容健康度 + 用户活跃度 + 核心数据 + 运营规范性，每维百分制 |

| 🏆 智能评级 | S/A/B/C/D/E 六级评级（S≥85分）+ 行业对标分析 |

| 📈 数据可视化 | 近期作品数据表格，阅读/点赞/评论/在看一目了然 |

| 💡 优化建议 | 分紧急/重点/持续三级，每条建议含预期量化效果 |

| 🔍 相似账号 | 自动匹配同赛道对标账号，横向对比找差距 |

| 🔗 可跳转链接 | 账号名称、作品标题均支持一键跳转微信 |

特色亮点

• ⚡ 一句话诊断：输入公众号名称即可获取完整报告，无需复杂配置
• 🔄 多账号对比：支持同时诊断多个账号并生成对比报告
• 📋 强制格式输出：5章节固定模板，章节/顺序/格式强制锁定，不得偏离

一键安装

前置条件

• 已安装 Python 3.8+
• 已注册 红狐Hub 账号并获取 API Key

安装步骤

• 将技能文件夹放入你的 Skills 目录
• 安装 Python 依赖：

   pip install requests

• 配置 API Key（见下方）

配置 API Key

获取 API Key

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

设置环境变量

REDFOX_API_KEY 需从环境变量获取。若未设置，Agent 会主动帮你配置：

• macOS/Linux：将 export REDFOX_API_KEY=<值> 追加到 ~/.zshrc 或 ~/.bashrc，然后 source 对应文件
• Windows：使用 [Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User") 设置用户级永久环境变量（需重启终端）

配置完成后验证：echo $REDFOX_API_KEY（macOS/Linux）或 echo %REDFOX_API_KEY%（Windows）

使用指南

触发方式

当用户提到以下任意关键词时自动激活：

• "诊断公众号"、"账号分析"、"公众号体检"
• "账号评估"、"查看XX公众号数据"、"分析XX账号"
• 直接输入公众号名称 + "诊断/分析"（如"十点读书 诊断"）

首次交互时 Agent 会主动打招呼并引导用户输入账号。

常用命令速查

| 命令 | 说明 |

|------|------|

| 诊断"公众号名称" | 输入名称即可获取完整诊断报告 |

| 对比诊断"A"和"B" | 多账号横向对比 + 差异化建议 |

| 诊断公众号ID"xxx" | 通过公众号ID查询（非中文名） |

使用示例

示例1：标准诊断

> 用户：诊断"十点读书"公众号

> AI：输出完整诊断报告（账号信息→综合评分→作品数据→优化建议→行业对标）

示例2：多账号对比

> 用户：对比诊断"十点读书"和"洞见"

> AI：分别输出两个诊断报告 + 横向对比总结表格 + 差异化建议

示例3：未查到账号

> 用户：诊断“不存在的公众号123”

> AI：未查询到账号【不存在的公众号123】，该账号可能名称有误或暂无数据，请核实公众号名称后重试。

⚠️ 输出格式强制规范

诊断报告必须且仅能以5章节固定模板输出：一、账号信息 → 二、综合评分 → 三、近期作品数据 → 四、优化建议 → 五、行业对标分析。章节不可省略、顺序不可调换、格式不可偏离。所有字段名、表格结构、emoji 标识须与模板严格一致。违反模板的输出视为不合格。

> 详细技术规范、评分算法、输出格式模板请参见 核心工作流

使用场景

场景一：号主自检优化

需求：了解自己公众号在行业中的水平，找到优化方向

使用方式：

• 直接输入自己的公众号名称进行诊断
• 查看四维度评分找到短板
• 按优化建议的优先级逐步改进

预期收益：明确账号健康度，量化优化效果，避免盲目运营

场景二：竞品对标分析

需求：分析竞品账号的运营策略和数据表现

使用方式：

• 诊断目标竞品公众号
• 查看行业对标和相似账号
• 对比分析差异化优势与差距

预期收益：掌握竞品动态，借鉴成功经验，调整自身策略

场景三：MCN 批量评估

需求：评估旗下或潜在签约账号的价值

使用方式：

• 逐个诊断候选账号
• 横向对比综合评分和核心指标
• 结合优化建议评估成长潜力

预期收益：数据驱动签约决策，量化账号商业价值

场景四：内容策略制定

需求：根据账号诊断结果制定内容规划

使用方式：

• 诊断账号获取质量稳定性、内容垂直度等评分
• 根据"待优化模块"确定改进重点
• 参考行业基准调整内容方向和发布策略

预期收益：有据可依的内容规划，提升整体运营效率

项目架构

目录结构

公众号账号诊断/
├── SKILL.md                     # 技能说明文档（本文件）
├── scripts/
│   └── wechat_analyzer.py       # 核心脚本：数据查询+评分引擎+报告生成
├── references/
│   ├── core_workflow.md         # 核心工作流（Agent执行参考）
│   └── workflow_guide.md        # 工作流详细指南
├── assets/
│   └── report_template.html     # 单账号HTML报告模板
└── output/                      # 输出目录（运行时自动生成）
    ├── raw_data.json            # API原始数据
    └── report_data.json         # 结构化诊断数据

技术栈

| 组件 | 技术 |

|------|------|

| 运行环境 | Python 3.8+ |

| HTTP 客户端 | requests（原生） |

| 数据源 | 红狐API (redfox.hk) |

| 输出格式 | Markdown + JSON + HTML |

| 认证方式 | Header X-API-KEY + 环境变量 REDFOX_API_KEY |

核心模块

| 模块 | 职责 |

|------|------|

| cmd_query | API 查询 + 原始数据保存 |

| _analyze_single_account | 四维度评分计算 + 结构化输出 |

| _score_content_health | 内容健康度（6子项加权，0-10分） |

| _score_user_activity | 用户活跃度（5子项加权，0-10分） |

| _score_core_data | 核心数据表现（6子项，0-43分） |

| _score_operation_compliance | 运营规范性（3子项，0-10分） |

| cmd_generate_html | 单账号 HTML 报告生成 |

常见问答

安装相关

Q1: 提示"未找到 REDFOX_API_KEY"怎么办？

A: 请按「一键安装 → 配置 API Key」中的步骤设置环境变量。如果不会配置，直接告诉 Agent，它会帮你操作。

Q2: 需要安装什么依赖？

A: 只需 requests 库：pip install requests。Python 3.8+ 即可运行。

使用相关

Q3: 支持按公众号ID查询吗？

A: 支持。如果知道公众号ID（如 gh_xxxxxxxx），Agent 会自动识别并使用 ID 查询。

Q4: 可以同时诊断多个账号吗？

A: 可以。输入"对比诊断 A 和 B"即可获得多账号对比报告。

Q5: 数据多久更新一次？

A: 数据来自红狐API，时效性取决于API缓存策略。报告末尾会标注数据置信度。

故障排除

Q6: 提示"未查询到该公众号信息"？

A: 可能原因：① 账号名称输入有误；② 该账号暂无相关数据。请检查名称准确性后重试。

Q7: 数据看起来不对怎么办？

A: 所有数据来自红狐API接口，诊断结果仅反映接口返回的数据。如有疑问可联系红狐平台确认数据准确性。

获取帮助

• 红狐Hub 官网：https://redfox.hk/
• 技能实现细节：参见 核心工作流