公众号账号诊断

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

---

简介

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

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

---

功能特性

核心能力

功能	说明
📊 四维度评分	四维度诊断评分（内容健康度/用户活跃度/核心数据/运营规范性），v4.1分类自适应（6类账号自动调整权重/阈值），爆款率（10万+）显式计分
🏆 智能评级	S/A/B/C/D/E 六级评级（S≥80分）+ 行业对标分析
📈 数据可视化	近期作品数据表格，阅读/点赞/评论/在看一目了然
💡 优化建议	分紧急/重点/持续三级，每条建议含预期量化效果
🔍 相似账号	自动匹配同赛道对标账号，横向对比找差距
🔗 可跳转链接	账号名称、作品标题均支持一键跳转微信

特色亮点

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

---

一键安装

前置条件

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

安装步骤

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

   pip install requests
   

3. 配置 API Key（见下方）

配置 API Key

获取 API Key

1. 访问 红狐Hub 官网 了解服务详情
2. 前往 注册页面 注册账号
3. 新注册用户将获赠免费积分，可立即开始使用
4. 注册登录后，在个人中心获取 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 标识须与模板严格一致。违反模板的输出视为不合格。

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

---

使用场景

场景一：号主自检优化

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

使用方式：

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

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

---

场景二：竞品对标分析

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

使用方式：

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

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

---

场景三：MCN 批量评估

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

使用方式：

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

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

---

场景四：内容策略制定

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

使用方式：

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

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

---

项目架构

目录结构

公众号账号诊断/
├── SKILL.md                     # 技能说明文档（本文件）
├── scripts/
│   ├── wechat_analyzer.py       # 入口点：argparse 命令路由（query/sync/generate_html）
│   ├── api_client.py             # HTTP 通信层：红狐 API 凭证管理 + POST 请求封装
│   ├── scoring.py                # 评分引擎：作品辅助函数 + 四维度评分 + 等级判定
│   ├── analyzer.py               # 分析编排：单账号评分处理 + 查询/同步命令
│   ├── report.py                 # HTML 报告：模板替换 + 单账号/多账号报告生成
│   └── test_wechat_analyzer.py   # 单元测试：辅助函数 + 评分函数容错（42 个测试）
├── references/
│   ├── core_workflow.md         # 核心工作流（Agent执行参考）
│   ├── workflow_guide.md        # 工作流详细指南
│   └── api_guide.md             # API接口与评分逻辑说明
├── 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

核心模块

模块文件	函数	职责
wechat_analyzer.py	main	argparse 入口，路由到各子命令
api_client.py	https_post	红狐 API HTTP POST 请求封装
api_client.py	_get_credential	环境变量 → shell 配置文件读取 API Key
scoring.py	_score_content_health	内容健康度（6子项加权，0-10分）
scoring.py	_score_user_activity	用户活跃度（5子项加权，0-10分）
scoring.py	_score_core_data	核心数据表现（6子项，0-31分）
scoring.py	_score_operation_compliance	运营规范性（3子项，0-10分）
analyzer.py	cmd_query	API 查询 + 原始数据保存
analyzer.py	_analyze_single_account	四维度评分计算 + 结构化输出
analyzer.py	cmd_sync_notes	同步账号作品数据（订阅推送）
report.py	cmd_generate_html	单账号 HTML 报告生成
report.py	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接口，诊断结果仅反映接口返回的数据。如有疑问可联系红狐平台确认数据准确性。

---

获取帮助

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