| name | wechat-account-analyzer |
| description | 公众号账号诊断工具是对任意公众号账号进行四维度量化评分（阅读数、互动率、更新频率、红狐指数），对标行业平均水平，输出可落地的运营优化建议。 |
公众号账号诊断
基于多维度数据分析，为公众号提供全面的账号健康诊断和优化建议
简介
公众号账号诊断 是一款智能分析工具，通过红狐指数 API 获取公众号真实运营数据，基于内容健康度、用户活跃度、核心数据表现、运营规范性四维度进行评分诊断，自动生成对标行业水平的优化建议。
- 核心价值：告别主观判断，用数据驱动公众号运营决策。一次诊断即可看清账号全貌，明确优化方向
- 适用对象：公众号号主、新媒体运营、MCN机构、品牌方、内容创作者
- 技术基础：基于红狐API实时数据 + Python评分引擎 + Agent智能建议生成
功能特性
核心能力
| 功能 | 说明 |
|---|
| 📊 四维评分 | 内容健康度 + 用户活跃度 + 核心数据 + 运营规范性，每维百分制 |
| 🏆 智能评级 | S/A/B/C/D/E 六级评级 + 行业对标分析 |
| 📈 数据可视化 | 近7天作品数据表格，阅读/点赞/评论/在看一目了然 |
| 💡 优化建议 | 分紧急/重点/持续三级，每条建议含预期量化效果 |
| 🔍 相似账号 | 自动匹配同赛道对标账号，横向对比找差距 |
| 🔗 可跳转链接 | 账号名称、作品标题均支持一键跳转微信 |
特色亮点
- ⚡ 一句话诊断：输入公众号名称即可获取完整报告，无需复杂配置
- 🎯 红狐锚定评分：以权威红狐指数为锚点，确保评分客观可比
- 🔄 多账号对比：支持同时诊断多个账号并生成对比报告
- 📋 强制格式输出：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"的公众号信息。请输入准确的公众号名称或公众号ID重新查询。
⚠️ 输出格式强制规范
诊断报告必须且仅能以5章节固定模板输出：一、账号信息 → 二、综合评分 → 三、近7天作品数据 → 四、优化建议 → 五、行业对标分析。章节不可省略、顺序不可调换、格式不可偏离。所有字段名、表格结构、emoji 标识须与模板严格一致。违反模板的输出视为不合格。
详细技术规范、评分算法、输出格式模板请参见 核心工作流
使用场景
场景一：号主自检优化
需求：了解自己公众号在行业中的水平，找到优化方向
使用方式：
- 直接输入自己的公众号名称进行诊断
- 查看四维度评分找到短板
- 按优化建议的优先级逐步改进
预期收益：明确账号健康度，量化优化效果，避免盲目运营
场景二：竞品对标分析
需求：分析竞品账号的运营策略和数据表现
使用方式：
- 诊断目标竞品公众号
- 查看行业对标和相似账号
- 对比分析差异化优势与差距
预期收益：掌握竞品动态，借鉴成功经验，调整自身策略
场景三：MCN 批量评估
需求：评估旗下或潜在签约账号的价值
使用方式：
- 逐个诊断候选账号
- 横向对比综合评分和核心指标
- 结合优化建议评估成长潜力
预期收益：数据驱动签约决策，量化账号商业价值
场景四：内容策略制定
需求：根据账号诊断结果制定内容规划
使用方式：
- 诊断账号获取质量稳定性、内容垂直度等评分
- 根据"待优化模块"确定改进重点
- 参考行业基准调整内容方向和发布策略
预期收益：有据可依的内容规划，提升整体运营效率
项目架构
目录结构
wechat-account-analyzer/
├── SKILL.md # 技能说明文档（本文件）
├── scripts/
│ └── wechat_analyzer.py # 核心脚本：数据查询+评分引擎+报告生成
├── references/
│ ├── core_workflow.md # 核心工作流（Agent执行参考）
│ ├── workflow_guide.md # 工作流详细指南
│ └── api_guide.md # API接口与评分逻辑说明
├── assets/
│ ├── report_template.html # 单账号HTML报告模板
│ └── multi_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 报告生成 |
cmd_generate_multi_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接口，诊断结果仅反映接口返回的数据。如有疑问可联系红狐平台确认数据准确性。
获取帮助
