---
name: douyin-account-diagnosis
description: 抖音账号诊断宗师，输入抖音账号名称或账号ID，通过红狐API获取账号数据和作品数据，从账号体量、内容表现、运营活跃度、平台指数四个维度进行全面诊断分析。当用户提到"诊断抖音账号"、"抖音账号分析"、"抖音体检"、"抖音评估"、"查看XX抖音数据"时使用。
---

# 抖音账号诊断宗师

## 简介

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

通过简单的账号输入，你可以：
- 📊 获取四维度量化评分（100分制），告别主观判断
- 📋 自动生成评分计算明细 + 完整诊断报告
- 💡 获得针对性的优势/短板分析和优化建议

适用于品牌方、MCN机构、自媒体从业者、内容运营人员等需要评估抖音账号表现的场景。

**触发方式：**
- "诊断抖音账号"、"抖音账号分析"、"抖音体检"
- "抖音评估"、"查看XX抖音数据"
- 直接输入抖音名称 + "诊断/分析"

---

## 功能特性

### 🎯 核心功能

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

### ✨ 特色亮点

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

> 完整的评分标准、评分细则表、综合评级标准详见 → [references/core_workflow.md](references/core_workflow.md) 第3节（四维度评分体系）

> 优势/短板/建议生成逻辑详见 → [references/core_workflow.md](references/core_workflow.md) 第4节

> 输出模板（评分计算明细 + 诊断报告格式）详见 → [references/core_workflow.md](references/core_workflow.md) 第5节（输出模板）

---

## 一键安装

### 前置条件

- 已获取红狐API Key（前往 [redfox.hk](https://redfox.hk) 申请，格式 `ak_xxx`）

### 环境变量配置

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

### API配置

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

> 完整的请求参数与响应字段详见 → [references/core_workflow.md](references/core_workflow.md) 第2节（API调用配置）

---

## 使用指南

### 基础使用

#### 1. 输入账号

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

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

#### 2. 查看评分明细

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

```
**维度一：账号体量（35分）**
+ 粉丝数 21,434,182（1000-5000万）→ 19分
+ 获赞总数 589,189,024（1-10亿）→ 6分
+ 获赞/粉丝比 ≈ 27.5（≥15）→ 5分
+ **小计：30分**
...
```

#### 3. 查看诊断报告

评分明细之后自动输出完整诊断报告，包含基本信息、核心数据、综合评分和优化建议。

### 命令速查

| 输入方式 | 示例 | 说明 |
|----------|------|------|
| 按昵称查询 | 诊断抖音账号"良田" | 模糊匹配昵称 |
| 按抖音号查询 | 诊断抖音号 liangtian5147 | 精确匹配抖音号 |
| 按名称+操作 | 良田 抖音分析 | 自然语言触发 |

### 特殊情况

- **未查询到账号**：API返回空数据时，输出收录引导文案，**严禁生成无依据报告**
  > 未查询到当前账号的相关信息，可提交当前抖音账号进行账号收录。
  > 1. 回复抖音号（在抖音个人主页显示的ID，如 1212_1234），即可进行账号收录。30分钟后将自动为您推送诊断报告~
  > 2. 下次再说；
- **API调用失败**：降级为联网搜索，明确标注数据来源。**严禁从第三方渠道估算或补充API未返回的字段。**

---

## 使用场景

### 场景一：品牌方账号评估

**角色**：品牌营销经理

**需求**：评估潜在合作达人的账号质量和内容表现

**使用方式**：
1. 输入达人抖音昵称进行诊断
2. 查看综合评分和四个维度得分率
3. 关注内容表现和运营活跃度，判断达人近期状态

**预期收益**：用数据代替直觉，科学评估达人合作价值

---

### 场景二：MCN机构达人管理

**角色**：MCN运营人员

**需求**：定期监测旗下达人的账号健康度和运营节奏

**使用方式**：
1. 定期对旗下达人进行账号诊断
2. 关注运营活跃度维度的更新频率和发布时段
3. 根据优化建议指导达人调整发布策略

**预期收益**：及时发现问题账号，提升达人管理效率

---

### 场景三：自媒体账号优化

**角色**：抖音博主 / 内容运营

**需求**：了解自身账号表现，找到优化方向

**使用方式**：
1. 输入自己的抖音账号进行诊断
2. 重点查看短板和优化建议
3. 针对性改善发布时段、内容选题或运营节奏

**预期收益**：明确优化方向，提升账号数据表现

---

## 项目架构

### 目录结构

```
douyin-account-diagnosis/
├── SKILL.md                          # 技能定义文件（本文件）
├── CONFIG.json                       # 技能配置（版本/评分维度/API配置/分类映射）
├── references/
│   └── core_workflow.md              # 核心工作流（完整技术参考）
└── scripts/
    ├── douyin_api_client.py          # 红狐API调用客户端
    └── generate_diagnosis_report.py  # 诊断报告生成器
```

### 核心模块

| 模块 | 文件 | 职责 |
|------|------|------|
| 技能定义 | SKILL.md | 触发场景、功能介绍、使用指南 |
| 核心工作流 | references/core_workflow.md | 完整的API配置、评分体系、输出模板、行为规范 |
| API客户端 | scripts/douyin_api_client.py | 红狐API调用、数据获取、降级处理 |
| 报告生成器 | scripts/generate_diagnosis_report.py | 四维度评分计算、诊断报告格式化输出 |
| 技能配置 | CONFIG.json | 版本信息、评分维度、API配置、分类映射 |

### 数据流转

```
用户输入(昵称/抖音号) → API客户端 → 红狐API → 原始数据
                                              ↓
诊断报告 ← 报告生成器 ← 评分计算 ← 数据解析
```

> 完整的账号分类映射详见 → [references/core_workflow.md](references/core_workflow.md) 第6节（账号分类映射）

> 完整的Agent行为规范详见 → [references/core_workflow.md](references/core_workflow.md) 第7节（Agent行为规范）

---

## 常见问答

### 安装相关问题

**Q1: 如何获取红狐API Key？**

A: 前往 [redfox.hk](https://redfox.hk) 注册账号，在控制台申请API Key，格式为 `ak_xxx`。

**Q2: 每次查询消耗多少积分？**

A: 每次查询消耗0.6积分。积分不足时（API返回code=3201），系统会降级为联网搜索并标注数据来源。

### 使用相关问题

**Q3: 昵称查询和抖音号查询有什么区别？**

A: 昵称查询使用 `accountNames` 参数，为模糊匹配，可能返回多个结果（取第一个）；抖音号查询使用 `accountIds` 参数，为精确匹配。

**Q4: 为什么红狐指数显示0.0？**

A: 部分账号可能未被红狐平台收录或数据未更新，此时 redfoxIndex 返回0.0或null，平台指数维度得0分。

**Q5: 诊断报告中为什么没有播放量？**

A: 红狐API返回的 playCount 字段常为null，本工具不估算播放量，也不计算依赖播放量的指标（如点赞率）。

### 故障排除

**Q6: 提示"未查询到账号"怎么办？**

A: 可能原因：
1. 输入的昵称或抖音号有误，请检查后重试
2. 该账号尚未被红狐平台收录，可按提示提交数据收录申请
3. 尝试使用抖音号（而非昵称）进行精确查询

**Q7: API调用失败如何处理？**

A: 系统会自动降级为联网搜索，并在报告中明确标注数据来源。**严禁从第三方渠道估算或补充API未返回的字段。**

---