\r \r

抖音账号诊断宗师\r

\r

简介\r

\r 抖音账号诊断宗师是一款专业的抖音账号数据分析工具，通过红狐API接口获取账号精确数据，从四个维度进行全面诊断评估。\r \r 通过简单的账号输入，你可以：\r

• 📊 获取四维度量化评分（100分制），告别主观判断\r
• 📋 自动生成评分计算明细 + 完整诊断报告\r
• 💡 获得针对性的优势/短板分析和优化建议\r \r 适用于品牌方、MCN机构、自媒体从业者、内容运营人员等需要评估抖音账号表现的场景。\r \r 触发方式：\r
• "诊断抖音账号"、"抖音账号分析"、"抖音体检"\r
• "抖音评估"、"查看XX抖音数据"\r
• 直接输入抖音名称 + "诊断/分析"\r \r ---\r \r

功能特性\r

\r

🎯 核心功能\r

\r | 功能 | 说明 |\r |------|------|\r | 📊 四维度评分 | 账号体量(35分) + 内容表现(35分) + 运营活跃度(20分) + 平台指数(10分) = 100分 |\r | 📋 诊断报告 | 自动生成评分计算明细 + 完整诊断报告（基本信息/核心数据/综合评分/优化建议） |\r | 🔍 账号查询 | 支持按昵称（模糊匹配）或抖音号（精确匹配）查询 |\r | 💡 优化建议 | 基于评分数据自动生成优势/短板分析和3条优化建议 |\r \r

✨ 特色亮点\r

\r

• ⚡ 精准数据：基于红狐API接口，所有数据来源可追溯，严禁估算编造\r
• 📈 标准化评分：统一的评分标准，横向可比，避免主观判断\r
• 🔧 兼容null值：playCount为null时不影响评分，传播系数使用分享/点赞比替代\r
• 🏷️ 分类映射：API返回的账号分类自动映射为统一输出名称\r \r

完整的评分标准、评分细则表、综合评级标准详见 → references/core_workflow.md 第3节（四维度评分体系）\r \r 优势/短板/建议生成逻辑详见 → references/core_workflow.md 第4节\r \r 输出模板（评分计算明细 + 诊断报告格式）详见 → references/core_workflow.md 第5节（输出模板）\r \r ---\r \r

一键安装\r

\r

前置条件\r

\r

• 已获取红狐API Key（前往 redfox.hk 申请，格式 ak_xxx）\r \r

环境变量配置\r

\r | 变量名 | 必填 | 说明 |\r |--------|------|------|\r | REDFOX_API_KEY | 是 | 红狐API访问密钥，格式 ak_xxx |\r \r

API配置\r

\r | 配置项 | 值 |\r |--------|-----|\r | 接口地址 | POST https://redfox.hk/story/api/dyUser/query |\r | 认证方式 | 请求头 X-API-KEY |\r | 积分消耗 | 每次查询0.6积分 |\r | 来源标识 | 抖音账号诊断宗师-GitHub |\r \r

完整的请求参数与响应字段详见 → references/core_workflow.md 第2节（API调用配置）\r \r ---\r \r

使用指南\r

\r

基础使用\r

\r

1. 输入账号\r

\r 告诉助手你想诊断的抖音账号：\r \r

用户：诊断抖音账号"良田"\r 助手：🔍 正在查询抖音账号：良田...\r \r

2. 查看评分明细\r

\r 系统自动计算四维度得分并输出评分计算过程：\r \r

**维度一：账号体量（35分）**\r
+ 粉丝数 21,434,182（1000-5000万）→ 19分\r
+ 获赞总数 589,189,024（1-10亿）→ 6分\r
+ 获赞/粉丝比 ≈ 27.5（≥15）→ 5分\r
+ **小计：30分**\r
...\r
```\r
\r
#### 3. 查看诊断报告\r
\r
评分明细之后自动输出完整诊断报告，包含基本信息、核心数据、综合评分和优化建议。\r
\r
### 命令速查\r
\r
| 输入方式 | 示例 | 说明 |\r
|----------|------|------|\r
| 按昵称查询 | 诊断抖音账号"良田" | 模糊匹配昵称 |\r
| 按抖音号查询 | 诊断抖音号 liangtian5147 | 精确匹配抖音号 |\r
| 按名称+操作 | 良田 抖音分析 | 自然语言触发 |\r
\r
### 特殊情况\r
\r
- **未查询到账号**：API返回空数据时，输出收录引导文案，**严禁生成无依据报告**\r
  > 当前未查询到该账号的相关信息，可提交抖音账号进行数据收录。\r
  > 1. 回复抖音号或抖音昵称（在抖音个人主页显示的ID，如 xxx_1234），即可进行数据收录。30分钟后将自动为您推送诊断报告；\r
  > 2. 下次再说；\r
- **API调用失败**：降级为联网搜索，明确标注数据来源。**严禁从第三方渠道估算或补充API未返回的字段。**\r
\r
---\r
\r
## 使用场景\r
\r
### 场景一：品牌方账号评估\r
\r
**角色**：品牌营销经理\r
\r
**需求**：评估潜在合作达人的账号质量和内容表现\r
\r
**使用方式**：\r
1. 输入达人抖音昵称进行诊断\r
2. 查看综合评分和四个维度得分率\r
3. 关注内容表现和运营活跃度，判断达人近期状态\r
\r
**预期收益**：用数据代替直觉，科学评估达人合作价值\r
\r
---\r
\r
### 场景二：MCN机构达人管理\r
\r
**角色**：MCN运营人员\r
\r
**需求**：定期监测旗下达人的账号健康度和运营节奏\r
\r
**使用方式**：\r
1. 定期对旗下达人进行账号诊断\r
2. 关注运营活跃度维度的更新频率和发布时段\r
3. 根据优化建议指导达人调整发布策略\r
\r
**预期收益**：及时发现问题账号，提升达人管理效率\r
\r
---\r
\r
### 场景三：自媒体账号优化\r
\r
**角色**：抖音博主 / 内容运营\r
\r
**需求**：了解自身账号表现，找到优化方向\r
\r
**使用方式**：\r
1. 输入自己的抖音账号进行诊断\r
2. 重点查看短板和优化建议\r
3. 针对性改善发布时段、内容选题或运营节奏\r
\r
**预期收益**：明确优化方向，提升账号数据表现\r
\r
---\r
\r
## 项目架构\r
\r
### 目录结构\r
\r
```\r
douyin-account-diagnosis/\r
├── SKILL.md                          # 技能定义文件（本文件）\r
├── CONFIG.json                       # 技能配置（版本/评分维度/API配置/分类映射）\r
├── references/\r
│   └── core_workflow.md              # 核心工作流（完整技术参考）\r
└── scripts/\r
    ├── douyin_api_client.py          # 红狐API调用客户端\r
    └── generate_diagnosis_report.py  # 诊断报告生成器\r
```\r
\r
### 核心模块\r
\r
| 模块 | 文件 | 职责 |\r
|------|------|------|\r
| 技能定义 | SKILL.md | 触发场景、功能介绍、使用指南 |\r
| 核心工作流 | references/core_workflow.md | 完整的API配置、评分体系、输出模板、行为规范 |\r
| API客户端 | scripts/douyin_api_client.py | 红狐API调用、数据获取、降级处理 |\r
| 报告生成器 | scripts/generate_diagnosis_report.py | 四维度评分计算、诊断报告格式化输出 |\r
| 技能配置 | CONFIG.json | 版本信息、评分维度、API配置、分类映射 |\r
\r
### 数据流转\r
\r
```\r
用户输入(昵称/抖音号) → API客户端 → 红狐API → 原始数据\r
                                              ↓\r
诊断报告 ← 报告生成器 ← 评分计算 ← 数据解析\r
```\r
\r
> 完整的账号分类映射详见 → [references/core_workflow.md](references/core_workflow.md) 第6节（账号分类映射）\r
\r
> 完整的Agent行为规范详见 → [references/core_workflow.md](references/core_workflow.md) 第7节（Agent行为规范）\r
\r
---\r
\r
## 常见问答\r
\r
### 安装相关问题\r
\r
**Q1: 如何获取红狐API Key？**\r
\r
A: 前往 [redfox.hk](https://redfox.hk) 注册账号，在控制台申请API Key，格式为 `ak_xxx`。\r
\r
**Q2: 每次查询消耗多少积分？**\r
\r
A: 每次查询消耗0.6积分。积分不足时（API返回code=3201），系统会降级为联网搜索并标注数据来源。\r
\r
### 使用相关问题\r
\r
**Q3: 昵称查询和抖音号查询有什么区别？**\r
\r
A: 昵称查询使用 `accountNames` 参数，为模糊匹配，可能返回多个结果（取第一个）；抖音号查询使用 `accountIds` 参数，为精确匹配。\r
\r
**Q4: 为什么红狐指数显示0.0？**\r
\r
A: 部分账号可能未被红狐平台收录或数据未更新，此时 redfoxIndex 返回0.0或null，平台指数维度得0分。\r
\r
**Q5: 诊断报告中为什么没有播放量？**\r
\r
A: 红狐API返回的 playCount 字段常为null，本工具不估算播放量，也不计算依赖播放量的指标（如点赞率）。\r
\r
### 故障排除\r
\r
**Q6: 提示"未查询到账号"怎么办？**\r
\r
A: 可能原因：\r
1. 输入的昵称或抖音号有误，请检查后重试\r
2. 该账号尚未被红狐平台收录，可按提示提交数据收录申请\r
3. 尝试使用抖音号（而非昵称）进行精确查询\r
\r
**Q7: API调用失败如何处理？**\r
\r
A: 系统会自动降级为联网搜索，并在报告中明确标注数据来源。**严禁从第三方渠道估算或补充API未返回的字段。**\r
\r
---