wechat-account-analyzer

---
name: wechat-account-analyzer
description: 公众号账号诊断工具是对任意公众号账号进行四维度量化评分（阅读数、互动率、更新频率、红狐指数），对标行业平均水平，输出可落地的运营优化建议。
---

# 公众号账号诊断

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

---

## 简介

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

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

---

## 功能特性

### 核心能力

| 功能 | 说明 |
|------|------|
| 📊 **四维评分** | 内容健康度 + 用户活跃度 + 核心数据 + 运营规范性，每维百分制 |
| 🏆 **智能评级** | S/A/B/C/D/E 六级评级 + 行业对标分析 |
| 📈 **数据可视化** | 近7天作品数据表格，阅读/点赞/评论/在看一目了然 |
| 💡 **优化建议** | 分紧急/重点/持续三级，每条建议含预期量化效果 |
| 🔍 **相似账号** | 自动匹配同赛道对标账号，横向对比找差距 |
| 🔗 **可跳转链接** | 账号名称、作品标题均支持一键跳转微信 |

### 特色亮点

- **⚡ 一句话诊断**：输入公众号名称即可获取完整报告，无需复杂配置
- **🎯 红狐锚定评分**：以权威红狐指数为锚点，确保评分客观可比
- **🔄 多账号对比**：支持同时诊断多个账号并生成对比报告
- **📋 强制格式输出**：5章节固定模板，章节/顺序/格式强制锁定，不得偏离

---

## 一键安装

### 前置条件
- 已安装 Python 3.8+
- 已注册 [红狐Hub](https://redfox.hk/) 账号并获取 API Key

### 安装步骤

1. 将技能文件夹放入你的 Skills 目录
2. 安装 Python 依赖：
   ```bash
   pip install requests
   ```
3. 配置 API Key（见下方）

### 配置 API Key

#### 获取 API Key
1. 访问 [红狐Hub 官网](https://redfox.hk/) 了解服务详情
2. 前往 [注册页面](https://redfox.hk/login) 注册账号
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"的公众号信息。请输入准确的公众号名称或公众号ID重新查询。

### ⚠️ 输出格式强制规范

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

> 详细技术规范、评分算法、输出格式模板请参见 **[核心工作流](references/core_workflow.md)**

---

## 使用场景

### 场景一：号主自检优化
**需求**：了解自己公众号在行业中的水平，找到优化方向

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

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

---

### 场景二：竞品对标分析
**需求**：分析竞品账号的运营策略和数据表现

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

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

---

### 场景三：MCN 批量评估
**需求**：评估旗下或潜在签约账号的价值

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

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

---

### 场景四：内容策略制定
**需求**：根据账号诊断结果制定内容规划

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

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

---

## 项目架构

### 目录结构

```
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接口，诊断结果仅反映接口返回的数据。如有疑问可联系红狐平台确认数据准确性。

---

### 获取帮助

- 红狐Hub 官网：[https://redfox.hk/](https://redfox.hk/)
- 技能实现细节：参见 [核心工作流](references/core_workflow.md)