Wechat Account Analyzer

公众号账号诊断

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

---

简介

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

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

---

功能特性

核心能力

特色亮点

• ⚡ 一句话诊断：输入公众号名称即可获取完整报告，无需复杂配置
• 🎯 红狐锚定评分：以权威红狐指数为锚点，确保评分客观可比
• 🔄 多账号对比：支持同时诊断多个账号并生成对比报告
• 📋 强制格式输出：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 会主动打招呼并引导用户输入账号。

常用命令速查

使用示例

示例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         # 结构化诊断数据

技术栈

核心模块

---

常见问答

安装相关

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/
• 技能实现细节：参见 核心工作流

WeChat Account Diagnostics / wechat-account-analyzer

---

Introduction

Perform a four-dimension quantitative scoring on any WeChat Official Account, benchmark it against industry averages, and receive actionable optimization suggestions — so your operations are driven by data, not guesswork.

Core Value

• Four-dimension quantitative diagnosis: Content health, user engagement, core data performance, and operational compliance — each scored on a 100-point scale, giving you a complete picture in one go
• Industry benchmarking: Anchored to the RedFox index, automatically matches peer accounts in the same vertical for side-by-side comparison
• Tiered optimization suggestions: Urgent / Key / Ongoing three-level prioritization, with each suggestion including an expected quantitative outcome — ready to act on immediately
• Multi-account comparison: Diagnose multiple accounts simultaneously and generate a side-by-side comparison report

Target Users

• 📱 Account owners / Content creators — Identify weaknesses in a single diagnosis and quantify improvement directions
• 📊 New-media operators / Brand teams — Drive content strategy with data instead of experience-based guesswork
• 🏢 MCN agencies — Batch-evaluate in-house or prospective accounts to assess commercial value

---

Features

Core Capabilities

• Four-dimension scoring: Content health + User engagement + Core data + Operational compliance, producing an overall 100-point score and S/A/B/C/D/E six-tier rating
• Recent content data summary: A table of the last 7 days' reads, likes, comments, and "Top Reads" figures for each article
• Tiered optimization suggestions: Urgent / Key / Ongoing priority levels with quantified expected outcomes per suggestion
• Peer account matching: Automatically matches similar accounts in the same vertical for gap analysis and growth path reference
• Multi-account comparison: Supports multiple accounts in one request, generating parallel diagnostic reports with a cross-account summary

---

API Key Acquisition & Security

• This skill requires the environment variable: REDFOX_API_KEY.
• REDFOX_API_KEY is provided by RedFoxHub (https://redfox.hk).
• Register at RedFoxHub to obtain your REDFOX_API_KEY.
• Set REDFOX_API_KEY as a device environment variable before using this skill.
• Before sharing your key, confirm its source, scope, expiry, and whether it supports reset/revocation.
• Never hard-code or expose the key in code, prompts, logs, or output files.

---

Usage Guide

Simply describe your request in natural language — no commands to memorize.

Quick Phrase Reference

Output Example

After diagnosis you will receive a fixed five-section report:

I. Account Info — Account name (clickable), bio, follower count, and other basic details

II. Overall Score — Four-dimension scores + overall rating (S/A/B/C/D/E) + industry benchmark comparison

III. Last 7 Days' Content Data — Article titles (clickable), reads / likes / comments / Top Reads data table

IV. Optimization Suggestions — Urgent / Key / Ongoing three-tier suggestions, each with expected quantitative outcomes

V. Industry Benchmark Analysis — Automatically matched peer accounts in the same vertical for side-by-side gap analysis

---

Use Cases

公众号账号诊断 / wechat-account-analyzer

---

简介

对任意公众号账号进行四维度量化评分，对标行业平均水平，输出可落地的运营优化建议，让公众号运营告别主观判断、用数据说话。

核心价值

• 四维度量化诊断：内容健康度、用户活跃度、核心数据表现、运营规范性，每项百分制评分，账号全貌一次看清
• 行业对标：以红狐指数为锚点，自动匹配同赛道对标账号，横向找差距
• 分级优化建议：紧急 / 重点 / 持续三级优先级，每条建议含预期量化效果，直接可执行
• 多账号对比：支持同时诊断多个账号，生成横向对比报告

适用对象

• 📱 公众号号主 / 内容创作者 — 一次诊断明确账号短板，量化改进方向
• 📊 新媒体运营 / 品牌方 — 数据驱动内容策略，摆脱经验式运营
• 🏢 MCN 机构 — 批量评估旗下或潜在签约账号商业价值

---

功能特性

核心功能

• 四维度评分：内容健康度 + 用户活跃度 + 核心数据 + 运营规范性，综合生成百分制总分及 S/A/B/C/D/E 六级评级
• 近期作品数据汇总：近7天作品阅读、点赞、评论、在看数据表格，一目了然
• 分级优化建议：按紧急 / 重点 / 持续三个优先级输出可执行建议，每条含预期量化效果
• 同赛道对标账号：自动匹配相似账号，横向对比找差距与成长路径
• 多账号对比诊断：支持同时输入多个账号，生成并排对比报告

---

密钥获取与安全说明

• 本技能需要使用环境变量：REDFOX_API_KEY。
• REDFOX_API_KEY 由 红狐 hub (https://redfox.hk)提供。
• 请前往 红狐 hub 注册账号，获取 REDFOX_API_KEY。
• 配置设备环境变量 REDFOX_API_KEY 后使用本技能。
• 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
• 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。

---

使用指南

直接用自然语言说出账号名称或诊断需求即可，无需记忆命令格式。

常用说法速查

输出示例

完成诊断后将收到5章节固定格式报告：

一、账号信息 — 账号名称（可跳转）、简介、粉丝量等基础信息

二、综合评分 — 四维度百分制评分 + 综合评级（S/A/B/C/D/E）+ 行业对标

三、近7天作品数据 — 作品标题（可跳转）、阅读 / 点赞 / 评论 / 在看数据表格

四、优化建议 — 紧急 / 重点 / 持续三级建议，每条含预期量化效果

五、行业对标分析 — 自动匹配同赛道相似账号，横向对比找差距

---

使用场景

API接口与评分逻辑

接口请求

查询接口

请求方式：POST 请求地址：https://redfox.hk/story/api/gzhUser/query

请求体示例：

{
  "accountNames": ["日食记"],
  "source": "公众号账号诊断-GitHub"
}

同步接口

请求方式：POST 请求地址：https://redfox.hk/story/api/gzhUser/syncUserNotes

接口响应字段

账号数据（List格式）

文章数据（works数组）

🎯 双维度诊断体系

维度一：内容健康度（权重 50%）

评估账号内容生产能力和质量稳定性

计算公式：

内容健康度 = 更新稳定性×0.15 + 内容垂直度×0.15 + 原创能力×0.10 + 质量稳定性×0.10 + 内容深度×0.05 + 形式创新×0.05

---

维度二：用户活跃度（权重 50%）

评估粉丝粘性和互动质量

计算公式：

用户活跃度 = 互动率×0.20 + 留言质量×0.10 + 分享传播力×0.10 + 阅读完成率×0.05 + 活跃时段×0.05

---

综合评分体系（100分制）

以红狐指数百分制为基准，结合其他维度微调，确保综合评分与红狐指数极度相近

综合评分公式

综合评分 = 红狐指数百分制 + 调整分
红狐指数百分制 = 红狐指数 / 10
调整分 = (其他维度百分制 - 红狐指数百分制) x 0.1
调整分范围：[-5, +5]

其中"其他维度百分制"由3部分加权计算：

• 内容核心数据（不含红狐指数）百分制 x 0.4
• 双维度诊断（内容健康度+用户活跃度平均）百分制 x 0.35
• 运营规范性百分制 x 0.25

评分结构

1. 内容健康度（0-10分原始分）

作为综合评分调整分输入之一

计算公式： 内容健康度 = 更新稳定性x0.15 + 内容垂直度x0.15 + 原创能力x0.10 + 质量稳定性x0.10 + 内容深度x0.05 + 形式创新x0.05

2. 用户活跃度（0-10分原始分）

作为综合评分调整分输入之一

计算公式： 用户活跃度 = 互动率x0.20 + 留言质量x0.10 + 分享传播力x0.10 + 阅读完成率x0.05 + 活跃时段x0.05

3. 内容核心数据表现（0-43分原始分）

红狐指数作为综合评分基准，其余5项作为调整分输入

4. 运营规范性（0-10分）

作为综合评分调整分输入之一

综合评级标准（100分制）

---

输出格式

诊断报告输出规范

严格按照以下5个章节顺序输出，不可省略任何章节。所有数值从脚本输出的JSON中对应字段取值，禁止自行编造。

JSON字段映射表

脚本输出的JSON结构为 {header, scores, content_health, user_activity, works, similar_accounts}，报告各章节取值如下：

一、账号信息（键值对，不使用表格）

• 账号名称： {header.账号名}
• 公众号ID： {header.账号ID}
• 运营主体： {header.认证信息}
• 账号简介： {header.账号简介}
• 红狐指数： {header.红狐指数}
• 行业标签： {header.账号标识}

二、综合评分

总分：{scores.综合评分} / 100分 — {scores.综合评级}（{scores.综合等级}）

行业对标表格： 从scores.行业对标读取各指标的3个值（本账号/行业均值/头部账号），差距分析由智能体根据数据对比撰写。

三、近7天作品数据（最近5条）

从works数组读取，每条作品输出6列。标题字段已包含Markdown超链接格式，直接原样输出。阅读数超过100000显示为"10w+"，不足5条按实际条数输出，禁止增加其他列。

若works_hint字段不为空（即红狐指数低于500且近7天无作品数据），则不输出表格，仅输出works_hint中的提示文字。

四、优化建议

分3个级别输出，基于各维度评分数据生成具体可执行建议：

紧急优化（1-2项） 1. [具体问题] → [可执行建议]（预期：[量化效果]）

重点优化（2-3项） 1. [具体问题] → [可执行建议]（预期：[量化效果]）

持续优化（1-2项） 1. [优化方向] → [策略建议]（预期：[长期收益]）

五、行业对标分析

对标结论：

• 综合评级：{scores.综合评级图标} {scores.综合等级}（{scores.综合评分}分），[行业地位描述]
• 核心优势： [基于评分数据分析列出2-3个核心优势]
• 与头部差距： [说明与头部账号的差距]
• 优化方向： [基于评分数据分析列出2-3个优化方向]

相似账号： 从similar_accounts数组读取，最多5条。

---

诊断时间：[YYYY-MM-DD] | 数据来源：红狐API接口 | 置信度：[高/中] | 阅读数>10万显示为10w+ | 禁止输出西瓜指数

---

⚠️ 注意事项

数据来源限制（重要）

• 🔒 接口数据唯一性： 所有账号信息（基础信息、运营数据、红狐指数等）和内容文章数据（阅读数、点赞数、评论数等）必须通过API接口获取
• ❌ 禁止自主采集： 严禁从其他渠道（如新榜、清博、微信后台、第三方平台等）自主获取或估算数据
• ✅ 接口优先原则： 所有诊断分析必须基于接口返回的真实数据，不得使用估算值或推测值
• 📊 数据准确性： 接口返回的数据为唯一可信数据源，所有评分和诊断结论必须基于此
• 📖 阅读数显示规则： 阅读数超过100000时显示为"10w+"而非具体数字

数据准确性

• 📊 接口数据： 所有数据来自红狐API接口，确保权威性和准确性
• ⏰ 时效性： 标注数据采集时间，提醒用户数据可能随时间变化
• 🔍 置信度标注： 在报告末尾标注数据置信度（高=接口实时数据，中=接口缓存数据）
• ⚠️ 未查询到账号： 当接口返回空结果时，明确告知用户"未查询到该公众号信息"，并提示"请输入准确的公众号名称或公众号ID重新查询"，严禁生成估算报告

诊断客观性

• ✅ 优势+问题并重： 既要指出问题，也要肯定优势，避免片面评价
• 📝 数据支撑： 所有诊断结论需有数据或现象支撑，不可主观臆断
• 🎯 可操作建议： 建议必须具体可执行，包含预期效果，避免空泛表述
• ⚖️ 评分一致性： 同类型账号评分标准保持一致，确保横向可比

特殊场景处理

• ❌ 未查询到账号： 当无法找到用户输入的公众号信息，或没有查询到公众号ID时，明确告知用户"未查询到该公众号信息"，并提示"请输入准确的公众号名称或公众号ID重新查询"，严禁生成估算报告
• 🔍 新账号（<6个月）： 数据样本不足，降低诊断置信度至"中"或"低"，侧重内容方向评估
• 📉 停更账号： 标注"账号已停更"，基于历史数据分析，提示数据时效性
• 🎭 矩阵账号： 如属MCN矩阵，说明团队协作特点，评估需考虑资源协同效应
• 💼 企业号vs个人号： 企业号侧重品牌传播和客户服务，个人号侧重IP打造和内容质量
• 📰 媒体号vs自媒体： 媒体号有采编团队，标准更高；自媒体侧重个人特色和用户粘性

输出规范

• 输出综合评分总分（100分制），不输出评分维度表格、优势模块和待优化模块
• 🚫 禁止输出内容健康度明细分析，不得出现"内容健康度分析"独立章节或子项评分表格
• 🚫 禁止输出用户活跃度明细分析，不得出现"用户活跃度分析"独立章节或子项评分表格
• 📊 评分需精确到小数点后1位（如7.3/10）
• 💡 优化建议按优先级分3级（紧急/重点/持续），数量分别为1-2项、2-3项、1-2项
• 📈 行业对标需包含5个核心指标：综合评分、红狐指数、平均阅读量、互动率、更新频率
• 📝 对标结论需包含：综合评级、核心优势、与头部差距、优化方向
• 🎨 严格遵循Markdown格式，确保表格对齐、标题层级正确
• 🔒 所有数据必须来自接口，不得使用估算值或外部数据源

常见行业基准参考（2024-2026）

---

📚 使用示例

示例1：完整诊断（标准场景）

用户：诊断"十点读书"公众号
AI：[输出完整诊断报告，包含基本信息、核心数据、双维度诊断、优化建议、行业对标]

示例2：快速评估（简化场景）

用户：分析一下"咪蒙"这个号
AI：[输出完整诊断报告，可适当简化数据表格，但必须包含双维度诊断和优化建议]

示例3：对比诊断（多账号场景）

用户：对比诊断"十点读书"和"洞见"
AI：[分别输出两个账号的完整诊断报告] + [横向对比总结表格] + [差异化建议]

示例4：使用公众号ID查询

用户：诊断公众号ID为"isdushu"的账号
AI：[先确认账号名称，再输出完整诊断报告]

示例5：特殊场景处理

用户：帮我看看"XX公众号"怎么样
AI：[检测到新账号/停更账号等特殊情况，在报告中标注置信度和特殊说明]

示例6：未查询到账号

用户：诊断"不存在的公众号123"
AI：抱歉，未查询到"不存在的公众号123"的公众号信息。请输入准确的公众号名称或公众号ID重新查询。

公众号诊断核心工作流

Agent 执行诊断任务时的完整技术参考，包含 API、评分算法、输出规范和行为约束。

---

1. 工作流步骤

步骤1：识别输入

• 用户提供公众号名称（中文）或公众号ID（纯数字/字母数字组合）
• 中文名称 → 使用 --account_names 参数查询
• 纯数字/字母数字组合 → 使用 --account_ids 参数查询

首次交互开场白：

你好！我是公众号账号诊断宗师，可以帮你深度拆解公众号账号的运营数据和商业价值。

请提供你想分析的公众号ID或公众号昵称均可。

步骤2：查询数据

按名称查询：

python scripts/wechat_analyzer.py query --account_names "公众号昵称"

按ID查询：

python scripts/wechat_analyzer.py query --account_ids "账号ID"

• 脚本自动保存 output/raw_data.json 和 output/report_data.json
• 脚本输出结构化 JSON，包含 status、query_type、message

步骤3：处理查询结果

成功时（status: "success", query_type: "single"）：

• 读取 output/report_data.json，按第4节输出格式生成诊断报告

未找到时（status: "success", query_type: "not_found"）：

• 告知用户"未查询到该公众号信息，请输入准确的公众号名称或公众号ID重新查询"
• 严禁生成估算报告

错误时（status: "error"）：

• 检查错误信息，如为凭证问题则引导配置 REDFOX_API_KEY

步骤4：生成报告

• 严格按照第4节输出格式的5个章节顺序输出
• 所有数值从 report_data.json 对应字段取值，禁止自行编造

---

2. API 调用配置

接口地址

请求配置

• 请求方式：POST
• 请求头：Content-Type: application/json + X-API-KEY: {REDFOX_API_KEY}
• 认证方式：Header X-API-KEY，值从环境变量 REDFOX_API_KEY 获取

查询接口

请求体：

{
  "accountIds": ["rishi-ji", "isdushu"],
  "accountNames": ["日食记", "夜听"],
  "source": "公众号账号诊断-GitHub"
}

返回字段：

---

3. 评分体系

3.1 双维度诊断体系

维度一：内容健康度（权重 50%）

内容健康度 = 更新稳定性×0.15 + 内容垂直度×0.15 + 原创能力×0.10 + 质量稳定性×0.10 + 内容深度×0.05 + 形式创新×0.05

维度二：用户活跃度（权重 50%）

用户活跃度 = 互动率×0.20 + 留言质量×0.10 + 分享传播力×0.10 + 阅读完成率×0.05 + 活跃时段×0.05

3.2 综合评分体系（100分制）

以红狐指数为锚点，其他维度微调，确保综合评分与红狐指数百分制极度相近。

综合评分 = 红狐指数百分制 + 调整分
调整分 = (其他维度百分制 - 红狐百分制) × 0.1
调整分范围: [-5, +5]

• 红狐指数百分制 = 红狐指数 / 10（如红狐650 = 65分）
• 其他维度百分制 = 内容核心数据(不含红狐)百分制×0.4 + 双维度诊断百分制×0.35 + 运营规范性百分制×0.25

各维度原始评分：

3.3 综合评级标准

---

4. 诊断报告输出格式（强制规范）

🔴 铁律：必须逐章逐节按以下模板输出，章节不可省略、顺序不可调换、格式不可偏离、字段名不可改写。所有数值从 `output/report_data.json` 中对应字段取值，禁止自行编造。凡不按此格式输出的诊断报告均视为不合格。

JSON 数据结构

脚本输出的 JSON 结构为 {header, scores, content_health, user_activity, works, similar_accounts}。

JSON 字段映射表

---

一、账号信息

使用表格格式输出：

二、综合评分

整体评级：「{scores.综合评分}」 / 100分 — {scores.综合评级}（{scores.综合等级}）

综合评分保留1位小数，使用中文书名号包裹评分值。

核心指标对标表（差距分析由 Agent 根据数据对比撰写，优于行业用 🔺 前缀，低于行业用 🔻 前缀，持平用 ➖ 前缀）：

三、近7天作品数据（最近5条）

从 works 数组读取，标题含 Markdown 超链接直接输出。阅读数>100000显示为"10w+"。不足5条按实际输出。

若 works_hint 不为空，不输出表格，以引用块输出提示文字。

若作品数据中存在明显异常（如大量0阅读但发布时间为近期），在表格后添加 ⚠️ 注意说明。

四、优化建议

分3级，使用 emoji 标识优先级。每项包含：问题 → 建议 → 预期 三段结构：

🔺 紧急优化（1-2项） 1. {具体问题}

• 问题：[问题描述]
• 建议：[可执行建议]
• 预期：[量化效果]

📌 重点优化（2-3项） 1. {具体问题}

• 问题：[问题描述]
• 建议：[可执行建议]
• 预期：[量化效果]

✅ 持续优化（1-2项） 1. {优化方向}

• 建议：[策略建议]
• 预期：[长期收益]

五、行业对标分析

对标结论采用分段结构，包含：综合评级、核心优势（2-3个）、与头部差距、优化方向（2-3个）：

综合评级：[具体描述]

核心优势：

- [优势1]

- [优势2]

与头部差距：[差距描述]

优化方向：

- [方向1]

- [方向2]

相似账号：从 similar_accounts 读取，最多5条。账号名称必须添加可点击跳转链接，格式为 [{similar_accounts[i].账号名称}](https://open.weixin.qq.com/qr/code?username={similar_accounts[i].账号ID})。如发现账号矩阵等有趣现象，在表格后追加"💨 有意思的发现"段落。

---

诊断报告末尾必须依次添加以下两段提醒：

诊断时间：[YYYY-MM-DD] | 数据来源：红狐API接口（redfox.hk） | 置信度：[高/中/低] | 阅读数>10万显示为10w+

💡 订阅提醒：如需持续追踪该账号数据变化，可回复"订阅 {账号名称}"，系统将自动同步最新作品数据（约需30分钟）。首次订阅后可解锁完整7天作品数据。

---

5. Agent 行为规范（强制）

🔴 最高优先级：输出格式铁律

• 诊断报告必须严格按照第4节定义的5章节模板输出，一字不漏
• 章节顺序：一→二→三→四→五，不可调换、不可省略
• 每个章节内部的格式（表格/列表/引用块/emoji）必须与模板一致
• 所有字段名从 report_data.json 取值，禁止改写字段名（如不可将"整体评级"写成"综合得分"）
• 凡不遵守以上规则的输出，视为不合格，必须重新生成

数据来源限制

• 🔒 所有账号信息和文章数据必须通过API接口获取
• ❌ 严禁从其他渠道自主获取或估算数据
• ✅ 所有诊断分析必须基于接口返回的真实数据

未查询到账号

• 告知用户"未查询到该公众号信息，请输入准确的公众号名称或公众号ID重新查询"
• 严禁生成估算报告

特殊场景处理

• 新账号（<6个月）：数据样本不足，置信度降至"中"或"低"，侧重内容方向评估
• 停更账号：标注"账号已停更"，提示数据时效性
• 矩阵账号：说明团队协作特点，评估考虑资源协同效应
• 企业号 vs 个人号：企业号侧重品牌传播，个人号侧重IP打造
• 媒体号 vs 自媒体：媒体号标准更高，自媒体侧重个人特色

输出禁止项

• 🚫 禁止输出内容健康度明细分析独立章节
• 🚫 禁止输出用户活跃度明细分析独立章节
• 🚫 禁止输出西瓜指数相关字段或数据
• 🚫 禁止输出评分维度表格、优势模块和待优化模块
• 🚫 禁止在综合评分行使用"总分"字样，统一使用"整体评级"

输出规范

• 综合评分总分100分制，精确到小数点后1位，使用中文书名号包裹如「92.6」
• 优化建议按优先级分3级，使用 emoji 标识：🔺 紧急优化、📌 重点优化、✅ 持续优化
• 优化建议每项采用"问题→建议→预期"三段结构
• 行业对标含5个核心指标：综合评分、红狐指数、平均阅读量、互动率、更新频率
• 行业对标差距分析使用 emoji 前缀：🔺 优于行业、🔻 低于行业、➖ 持平
• 阅读数>10万显示为"10w+"
• 账号信息使用表格格式（项目 | 内容），不用键值对列表
• 作品数据存在异常时（如刚发布阅读为0），在表格后加 ⚠️ 注意说明
• 相似账号分析中发现矩阵/品牌关联等有趣现象，追加"💨 有意思的发现"段落
• 相似账号名称必须添加可点击跳转链接
• 报告末尾必须追加 💡 订阅提醒（引导用户回复"订阅 {账号名称}"）
• 空值字段处理：认证信息为空填"未认证"，简介为空填"无"

行业基准参考

公众号账号分析工作流指南

目录

1. 整体流程 2. 评分体系 3. 数据获取与脚本调用 4. 各模块分析指南 5. 水平衡量基准数据 6. 多账号对比

整体流程

步骤1：获取公众号信息

• 用户可以提供公众号ID或公众号昵称，两种方式均可查询
• 公众号ID：如 gh_xxxxxxxx、纯数字或字母数字组合
• 公众号昵称：如 十点读书、视觉志 等中文名称

⚠️ 输入识别规则：

• 用户输入为纯数字或字母数字组合时，识别为公众号ID，使用 --account_ids 参数查询
• 用户输入为中文名称时，识别为公众号昵称，使用 --account_names 参数查询

标准开场白（首次交互时输出）： "你好！我是公众号账号诊断宗师，可以帮你深度拆解公众号账号的运营数据和商业价值。 请提供你想分析的公众号ID或公众号昵称均可。"

步骤2：查询数据

按ID查询：

python scripts/wechat_analyzer.py query --account_ids "账号ID"

按昵称查询：

python scripts/wechat_analyzer.py query --account_names "公众号昵称"

• 脚本自动保存 output/raw_data.json
• 输出结构化JSON结果，包含评分和指标

⚠️ 账号数据为空处理（未查询到账号）：

• 如果脚本返回 status: "error" 且提示未查询到账号，说明该账号不在数据库中
• 立即停止后续步骤，执行以下处理：

1. 调用数据同步接口：

     python scripts/wechat_analyzer.py sync_notes --red_ids "用户输入的账号ID"

• 同步接口：https://redfox.hk/story/api/gzhUser/syncUserNotes，参数 redId 从用户输入中获取

2. 输出提示：

     非常抱歉，未查询到该账号。请检查账号id是否有误，若输入准确，可能当前账号近期发文数据未达到收录标准。
     我们将为你实时去采集数据，30min后向您推送新的诊断报告，请问是否接收？
     1. 接收推送
     2. 暂不接收

3. 用户输入编号"1"或回复"接收"后，执行订阅流程： a. 【必须】创建日程任务（使用calendar_create工具）：

• summary: 推送xxx账号诊断报告
• dtstart: 当前时间+30分钟（格式YYYYMMDDHHMM）
• description: 重新查询账号数据并推送诊断报告（python scripts/wechat_analyzer.py query --account_ids <用户输入的账号ID>）

b. 输出提示：「订阅成功！系统将在30分钟后自动向您推送该账号的诊断报告，请耐心等待」 4. 用户输入编号"2"或回复"暂不接收"，结束本次分析

⚠️ 作品数据为空处理（直接进入订阅流程）：

• 如果查询到账号但 works 为空数组，脚本返回 query_type: "need_sync" 和 need_sync 字段
• 立即停止后续步骤，不输出分析报告，直接进入订阅流程：

1. 输出提示（xxx为账号昵称）：

     为您获取作品中，30分钟后会更新数据后可向您推荐，请问是否订阅"xxx"账号？
     1. 订阅账号xxx
     2. 暂不订阅

2. 用户输入编号"1"或回复"订阅"后，执行订阅流程： a. 【必须】创建日程任务（使用calendar_create工具）：

• summary: 推送xxx账号诊断报告
• dtstart: 当前时间+30分钟（格式YYYYMMDDHHMM）
• description: 重新查询账号数据并推送诊断报告（python scripts/wechat_analyzer.py query --account_ids <redId>）

b. 日程创建成功后，调用同步接口：

        python scripts/wechat_analyzer.py sync_notes --red_ids "redId"

c. 同步接口：https://redfox.hk/story/api/gzhUser/syncUserNotes，参数 redId 从账号信息中获取 d. 输出提示：「订阅成功！系统将在30分钟后自动向您推送"xxx"账号的诊断报告，请耐心等待」 3. 用户输入编号"2"或回复"仍然执行分析"：

• 继续执行分析流程
• 在报告开头提示：「该账号暂未获取到近7天作品」
• 输出完整的分析报告（爆文能力、更新产能等模块显示为"暂无作品数据"）

4. 用户输入编号"3"或回复"暂不订阅"，结束本次分析

订阅推送机制（智能体执行）：

• 使用calendar_create工具创建日程任务
• 日程触发时间：当前时间 + 30分钟（格式YYYYMMDDHHMM）
• 日程触发后无论是否有作品数据都执行分析流程：

1. 重新查询账号数据：python scripts/wechat_analyzer.py query --account_ids <redId> 2. 如果works为空：

• 在报告开头提示：「该账号已重新同步，但暂未获取到近7天作品数据」
• 继续执行完整的分析流程，输出诊断报告

3. 如果works有数据：

• 正常输出完整的诊断报告

步骤3：在对话中输出诊断报告

基于脚本输出的数据，直接在对话中输出四维度诊断报告。

• 格式要求：严格按照本文件"评分输出格式"章节的5节模板输出（账号信息→综合评分→近7天作品→优化建议→行业对标）
• 输出位置：直接在对话中输出，不创建markdown文件

步骤4：展示相似账号

相似账号已整合在诊断报告第5版块中，与报告一体输出（无需单独展示）：

• 从脚本返回数据的 similar_accounts 字段提取最多5个相似账号
• 按表格格式展示（序号/账号名称/红狐指数/平均阅读）
• 最后输出"回复序号可继续分析！"

• 该字段值为空未填充

步骤5：用户回复序号继续分析相似账号

当用户回复序号选择某个相似账号时： 1. 从 similar_accounts 数据中获取该账号的 userId 2. 调用脚本查询该账号详情：

   python scripts/wechat_analyzer.py query --account_ids "userId"

3. 执行完整分析流程（同步骤3-5）：

• 步骤3：在对话中输出完整诊断报告
• 步骤4：直接展示相似账号
• 步骤5：生成HTML报告并展示

4. 注意：必须在对话中输出完整诊断报告，不能只输出HTML

评分体系

🎯 双维度诊断体系

维度一：内容健康度（权重 50%）

评估账号内容生产能力和质量稳定性

计算公式：

内容健康度 = 更新稳定性×0.15 + 内容垂直度×0.15 + 原创能力×0.10 + 质量稳定性×0.10 + 内容深度×0.05 + 形式创新×0.05

---

维度二：用户活跃度（权重 50%）

评估粉丝粘性和互动质量

计算公式：

用户活跃度 = 互动率×0.20 + 留言质量×0.10 + 分享传播力×0.10 + 阅读完成率×0.05 + 活跃时段×0.05

---

综合评分体系（100分制）

综合评分体系：以红狐指数百分制为基准+微调

综合评分 = 红狐指数百分制 + 调整分

• 红狐指数百分制 = 红狐指数 / 10
• 调整分 = (其他维度百分制 - 红狐指数百分制) x 0.1，范围[-5, +5]
• 其他维度百分制 = 内容核心数据(不含红狐)x0.4 + 双维度诊断(健康度+活跃度平均)x0.35 + 运营规范性x0.25

---

1. 内容健康度（0-10分原始分）

作为综合评分调整分输入之一

计算公式： 内容健康度 = 更新稳定性x0.15 + 内容垂直度x0.15 + 原创能力x0.10 + 质量稳定性x0.10 + 内容深度x0.05 + 形式创新x0.05

---

2. 用户活跃度（0-10分原始分）

作为综合评分调整分输入之一

计算公式： 用户活跃度 = 互动率x0.20 + 留言质量x0.10 + 分享传播力x0.10 + 阅读完成率x0.05 + 活跃时段x0.05

---

3. 内容核心数据表现

原始分0-43分，换算为百分制得分

---

4. 运营规范性（10分）

---

综合评分计算

综合评分 = 内容健康度(0-30) + 用户活跃度(0-25) + 内容核心数据(0-35) + 运营规范性(0-10) = 0-100

---

综合评级标准（100分制）

---

评分输出格式

严格按照以下5个章节顺序输出，不可省略任何章节。所有数值从脚本输出的JSON中对应字段取值，禁止自行编造。

JSON字段映射表

脚本输出的JSON结构为 {header, scores, content_health, user_activity, works, similar_accounts}，报告各章节取值如下：

一、账号信息（键值对，不使用表格）

• 账号名称： {header.账号名}
• 公众号ID： {header.账号ID}
• 运营主体： {header.认证信息}
• 账号简介： {header.账号简介}
• 红狐指数： {header.红狐指数}
• 行业标签： {header.账号标识}

二、综合评分

总分：{scores.综合评分} / 100分 — {scores.综合评级}（{scores.综合等级}）

行业对标表格： 从scores.行业对标读取各指标的3个值（本账号/行业均值/头部账号），差距分析由智能体根据数据对比撰写。

三、近7天作品数据（最近5条）

从works数组读取，每条作品输出6列。标题字段已包含Markdown超链接格式，直接原样输出。阅读数超过100000显示为"10w+"，不足5条按实际条数输出，禁止增加其他列。

若works_hint字段不为空（即红狐指数低于500且近7天无作品数据），则不输出表格，仅输出works_hint中的提示文字。

四、优化建议

分3个级别输出，基于各维度评分数据生成具体可执行建议：

紧急优化（1-2项） 1. [具体问题] → [可执行建议]（预期：[量化效果]）

重点优化（2-3项） 1. [具体问题] → [可执行建议]（预期：[量化效果]）

持续优化（1-2项） 1. [优化方向] → [策略建议]（预期：[长期收益]）

五、行业对标分析

对标结论：

• 综合评级：{scores.综合评级图标} {scores.综合等级}（{scores.综合评分}分），[行业地位描述]
• 核心优势： [基于评分数据分析列出2-3个核心优势]
• 与头部差距： [说明与头部账号的差距]
• 优化方向： [基于评分数据分析列出2-3个优化方向]

相似账号： 从similar_accounts数组读取，最多5条。

---

诊断时间：[YYYY-MM-DD] | 数据来源：红狐API接口 | 置信度：[高/中] | 阅读数>10万显示为10w+ | 禁止输出西瓜指数

⚠️ 注意事项

数据来源限制（重要）

• 🔒 接口数据唯一性： 所有账号信息（基础信息、运营数据、红狐指数等）和内容文章数据（阅读数、点赞数、评论数等）必须通过API接口获取
• ❌ 禁止自主采集： 严禁从其他渠道（如新榜、清博、微信后台、第三方平台等）自主获取或估算数据
• ✅ 接口优先原则： 所有诊断分析必须基于接口返回的真实数据，不得使用估算值或推测值
• 📊 数据准确性： 接口返回的数据为唯一可信数据源，所有评分和诊断结论必须基于此

数据准确性

• 📊 接口数据： 所有数据来自红狐API接口，确保权威性和准确性
• ⏰ 时效性： 标注数据采集时间，提醒用户数据可能随时间变化
• 🔍 置信度标注： 在报告末尾标注数据置信度（高=接口实时数据，中=接口缓存数据）
• ⚠️ 未查询到账号： 当接口返回空结果时，明确告知用户"未查询到该公众号信息"，并提示"请输入准确的公众号名称或公众号ID重新查询"，严禁生成估算报告

诊断客观性

• ✅ 优势+问题并重： 既要指出问题，也要肯定优势，避免片面评价
• 📝 数据支撑： 所有诊断结论需有数据或现象支撑，不可主观臆断
• 🎯 可操作建议： 建议必须具体可执行，包含预期效果，避免空泛表述
• ⚖️ 评分一致性： 同类型账号评分标准保持一致，确保横向可比

特殊场景处理

• ❌ 未查询到账号： 当无法找到用户输入的公众号信息，或没有查询到公众号ID时，明确告知用户"未查询到该公众号信息"，并提示"请输入准确的公众号名称或公众号ID重新查询"，严禁生成估算报告
• 🔍 新账号（<6个月）： 数据样本不足，降低诊断置信度至"中"或"低"，侧重内容方向评估
• 📉 停更账号： 标注"账号已停更"，基于历史数据分析，提示数据时效性
• 🎭 矩阵账号： 如属MCN矩阵，说明团队协作特点，评估需考虑资源协同效应
• 💼 企业号vs个人号： 企业号侧重品牌传播和客户服务，个人号侧重IP打造和内容质量
• 📰 媒体号vs自媒体： 媒体号有采编团队，标准更高；自媒体侧重个人特色和用户粘性

输出规范

• 输出综合评分总分（100分制），不输出评分维度表格、优势模块和待优化模块
• 🚫 禁止输出内容健康度明细分析，不得出现"内容健康度分析"独立章节或子项评分表格
• 🚫 禁止输出用户活跃度明细分析，不得出现"用户活跃度分析"独立章节或子项评分表格
• 📊 评分需精确到小数点后1位（如7.3/10）
• 💡 优化建议按优先级分3级（紧急/重点/持续），数量分别为1-2项、2-3项、1-2项
• 📈 行业对标需包含5个核心指标：综合评分、红狐指数、平均阅读量、互动率、更新频率
• 📝 对标结论需包含：综合评级、核心优势、与头部差距、优化方向
• 🎨 严格遵循Markdown格式，确保表格对齐、标题层级正确
• 🔒 所有数据必须来自接口，不得使用估算值或外部数据源
• 🚫 禁止输出西瓜指数，报告中不得出现任何与西瓜指数相关的字段或数据
• 📖 阅读数显示规则： 阅读数超过100000时显示为"10w+"而非具体数字

常见行业基准参考（2024-2026）

---

📚 使用示例

示例1：完整诊断（标准场景）

用户：诊断"十点读书"公众号
AI：[输出完整诊断报告，包含基本信息、核心数据、双维度诊断、优化建议、行业对标]

示例2：快速评估（简化场景）

用户：分析一下"咪蒙"这个号
AI：[输出完整诊断报告，可适当简化数据表格，但必须包含双维度诊断和优化建议]

示例3：对比诊断（多账号场景）

用户：对比诊断"十点读书"和"洞见"
AI：[分别输出两个账号的完整诊断报告] + [横向对比总结表格] + [差异化建议]

示例4：使用公众号ID查询

用户：诊断公众号ID为"isdushu"的账号
AI：[先确认账号名称，再输出完整诊断报告]

示例5：特殊场景处理

用户：帮我看看"XX公众号"怎么样
AI：[检测到新账号/停更账号等特殊情况，在报告中标注置信度和特殊说明]

示例6：未查询到账号

用户：诊断"不存在的公众号123"
AI：抱歉，未查询到"不存在的公众号123"的公众号信息。请输入准确的公众号名称或公众号ID重新查询。