# Wechat Account Analyzer

> 公众号账号诊断工具是对任意公众号账号进行四维度量化评分（内容健康度、用户活跃度、内容核心数据、运营规范性），对标行业平均水平，输出可落地的运营优化建议。

- Skill: `redfox-data/wechat-account-analyzer` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds add redfox-data/wechat-account-analyzer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/redfox-data/wechat-account-analyzer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: redfox-data (https://skillmd.com/u/redfox-data)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/redfox-data/wechat-account-analyzer

---


# 公众号账号诊断

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

---

## 简介

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

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

---

## 功能特性

### 核心能力

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

### 特色亮点

- **⚡ 一句话诊断**：输入公众号名称即可获取完整报告，无需复杂配置
- **🔄 多账号对比**：支持同时诊断多个账号并生成对比报告
- **📋 强制格式输出**：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】，该账号可能尚未收录或名称有误，请核实公众号名称后重试。

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

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

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

---

## 使用场景

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

**使用方式**：
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/](https://redfox.hk/)
- 技能实现细节：参见 [核心工作流](references/core_workflow.md)