# 抖音账号诊断宗师核心工作流

> Agent 执行抖音账号诊断任务时的完整技术参考，包含 API、评分算法、输出模板和行为约束。

---

## 1. 工作流步骤

### 步骤1：识别输入
- 用户提供抖音昵称（中文）或抖音号（unique_id/short_id/uid）
- 中文昵称 → 使用 `accountNames` 参数查询（模糊匹配）
- 抖音号/ID → 使用 `accountIds` 参数查询（精确匹配）

### 步骤2：查询数据

调用红狐API接口：
```
POST https://redfox.hk/story/api/dyUser/query
Headers: Content-Type: application/json, X-API-KEY: {REDFOX_API_KEY}
Body: {"accountNames": ["昵称"], "source": "抖音账号诊断宗师-ClawHub"}
或
Body: {"accountIds": ["抖音号"], "source": "抖音账号诊断宗师-ClawHub"}
```

### 步骤3：处理查询结果

**成功时**（code: 2000, data非空）：
- 取 data[0] 作为诊断对象
- 按第3节评分体系计算四维度得分
- 按第5节输出模板生成诊断报告

**未找到时**（code: 2000, data为空数组）：
- 输出收录引导文案（见SKILL.md「未查询到账号时的提示」章节）
- **严禁生成无依据报告**

**API错误时**（code非2000）：
- code=3201：积分不足，降级为联网搜索并标注数据来源
- 其他错误：提示用户稍后重试

### 步骤4：生成报告
- 严格按照第5节输出模板格式输出
- 所有数值从API返回数据中取值，禁止自行编造
- 所有评分精确到1位小数

---

## 2. API 调用配置

### 接口地址

| 用途 | 地址 |
|------|------|
| 查询接口 | `POST https://redfox.hk/story/api/dyUser/query` |

### 请求配置

- **请求方式**：POST
- **请求头**：`Content-Type: application/json` + `X-API-KEY: {REDFOX_API_KEY}`
- **认证方式**：Header `X-API-KEY`，值从环境变量 `REDFOX_API_KEY` 获取（格式 `ak_xxx`）
- **积分消耗**：每次查询0.6积分

### 查询接口

**请求体**：
```json
{
  "accountIds": ["Dailytaste"],
  "accountNames": ["人民日报"],
  "source": "抖音账号诊断宗师-ClawHub"
}
```

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| accountIds | List\<String\> | 否* | 抖音号（unique_id/short_id/uid） |
| accountNames | List\<String\> | 否* | 抖音昵称（模糊匹配） |
| source | String | 否 | 来源标识，默认抖音账号诊断宗师-GitHub |

> *accountIds和accountNames至少传一个

**账号级返回字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| nickname | String | 昵称 |
| accountId | String | 抖音号 |
| uid | String | 用户唯一ID |
| signature | String | 简介 |
| gender | String | 性别 |
| age | Integer | 年龄（可为null） |
| country | String | 国家 |
| province | String | 省份 |
| city | String | 城市 |
| ipLocation | String | IP属地（可为null） |
| followerCount | Long | 粉丝数 |
| awemeCount | Integer | 作品总数 |
| totalFavorited | Long | 获赞总数 |
| crawlTime | String | 数据抓取时间 |
| redfoxIndex | Double | 红狐指数（可为null） |
| works | List | 近7天作品列表 |
| similarAccounts | List | 相似账号列表 |

**作品级返回字段（works）**：

| 字段 | 类型 | 说明 |
|------|------|------|
| awemeId | String | 作品唯一ID |
| title | String | 作品标题 |
| coverUrl | String | 作品封面链接 |
| desc | String | 作品描述（可能为空） |
| createTime | String | 发布时间（如 "2026-06-03 21:57:03"） |
| diggCount | Long | 点赞数 |
| commentCount | Long | 评论数 |
| shareCount | Long | 分享数 |
| playCount | Long/null | 播放量（常为null） |
| interactiveCount | Long | 互动总数 |
| workUrl | String | 作品链接 |

**相似账号字段（similarAccounts）**：

| 字段 | 类型 | 说明 |
|------|------|------|
| nickname | String | 昵称 |
| displayId | String | 显示ID |
| uid | String | 用户唯一ID |
| avatarUrl | String | 头像链接 |
| followerCount | Long | 粉丝数 |
| awemeCount | Integer | 作品数 |
| totalFavorited | Long | 获赞总数 |
| signature | String | 账号简介 |
| accountClassifyFirst | String | 账号分类（需映射，见第6节分类映射表） |
| newrankIndex | Double | 新榜指数 |

---

## 3. 四维度评分体系（100分制）

### 设计原则

1. **仅依赖API可返回字段** — 所有指标均来自API返回数据
2. **兼容playCount=null** — 不将播放量作为必要计算因子
3. **0换算** — 每项直接评分，无需乘系数/换算
4. **不重复** — 同一指标只在一个维度出现

---

### 维度一：账号体量（35分）

**评估账号的基础规模和粉丝价值**

| 指标 | 满分 | 评分标准 | 数据来源 |
|------|------|---------|---------|
| 粉丝数 | 22分 | 见下表 | followerCount |
| 获赞总数 | 8分 | 见下表 | totalFavorited |
| 获赞/粉丝比 | 5分 | 见下表 | totalFavorited/followerCount |

#### 粉丝数评分（22分）

| 得分 | 粉丝数 | 量级 |
|------|--------|------|
| 22分 | ≥5000万 | 超头部 |
| 19分 | 1000-5000万 | 头部 |
| 16分 | 500-1000万 | 准头部 |
| 12分 | 100-500万 | 中腰部 |
| 9分 | 50-100万 | 中小 |
| 5分 | 10-50万 | 小型 |
| 2分 | 1-10万 | 微型 |
| 0分 | <1万 | 新号 |

#### 获赞总数评分（8分）

| 得分 | 获赞数 |
|------|--------|
| 8分 | ≥10亿 |
| 6分 | 1-10亿 |
| 5分 | 1000万-1亿 |
| 3分 | 100-1000万 |
| 1分 | 10-100万 |
| 0分 | <10万 |

#### 获赞/粉丝比评分（5分）

| 得分 | 比值 | 说明 |
|------|------|------|
| 5分 | ≥15 | 粉丝质量极高（历史爆款多） |
| 4分 | 10-15 | 粉丝质量高 |
| 3分 | 5-10 | 正常 |
| 2分 | 2-5 | 偏低（新号或粉丝活跃度低） |
| 1分 | <2 | 极低 |

---

### 维度二：内容表现（35分）

**基于近7天作品数据评估内容市场表现，使用diggCount/commentCount/shareCount替代playCount依赖**

| 指标 | 满分 | 数据来源 | 说明 |
|------|------|---------|---------|
| 平均点赞数 | 13分 | avg(works.diggCount) | 内容认可度 |
| 平均评论数 | 9分 | avg(works.commentCount) | 用户参与深度 |
| 平均分享数 | 7分 | avg(works.shareCount) | 传播力 |
| 传播系数 | 6分 | avg(shareCount/diggCount) | 分享/点赞比，衡量自发传播力 |

> 若近7天无作品（works为空），内容表现维度得0分

#### 平均点赞数评分（13分）

| 得分 | 平均点赞 | 对应量级 |
|------|---------|---------|
| 13分 | ≥100万 | 现象级 |
| 11分 | 50-100万 | 超爆款 |
| 9分 | 10-50万 | 爆款 |
| 7分 | 1-10万 | 优秀 |
| 4分 | 1000-1万 | 中等 |
| 2分 | 100-1000 | 偏低 |
| 0分 | <100 | 较低 |

#### 平均评论数评分（9分）

| 得分 | 平均评论 |
|------|---------|
| 9分 | ≥1万 |
| 7分 | 5000-1万 |
| 5分 | 1000-5000 |
| 3分 | 100-1000 |
| 1分 | 10-100 |
| 0分 | <10 |

#### 平均分享数评分（7分）

| 得分 | 平均分享 |
|------|---------|
| 7分 | ≥10万 |
| 6分 | 1-10万 |
| 4分 | 1000-1万 |
| 2分 | 100-1000 |
| 1分 | 10-100 |
| 0分 | <10 |

#### 传播系数评分（6分）

传播系数 = 分享数 / 点赞数（衡量用户自发传播意愿）

| 得分 | 传播系数 | 说明 |
|------|---------|------|
| 6分 | ≥15% | 极强自发传播 |
| 5分 | 10-15% | 强传播力 |
| 4分 | 5-10% | 良好 |
| 2分 | 2-5% | 中等 |
| 1分 | <2% | 偏弱 |

---

### 维度三：运营活跃度（20分）

**评估账号运营规范和活跃程度**

| 指标 | 满分 | 评分标准 | 数据来源 |
|------|------|---------|---------|
| 更新频率 | 8分 | 近7天发布数 | len(works) |
| 发布时段 | 4分 | 是否在黄金时段 | works.createTime |
| 账号完整度 | 4分 | 简介是否非空 | signature |
| 作品总量 | 4分 | 历史作品数 | awemeCount |

#### 更新频率评分（8分）

| 得分 | 近7天发布数 | 节奏 |
|------|-----------|------|
| 8分 | ≥7条 | 日更 |
| 6分 | 4-6条 | 高频 |
| 4分 | 2-3条 | 中频 |
| 2分 | 1条 | 低频 |
| 0分 | 0条 | 停更 |

#### 发布时段评分（4分）

| 得分 | 时段 |
|------|------|
| 4分 | 黄金时段（11-13点/18-21点） |
| 3分 | 次优时段（7-9点/21-23点） |
| 1分 | 其他时段 |
| 0分 | 无作品可判断 |

#### 账号完整度评分（4分）

| 得分 | 条件 |
|------|------|
| 4分 | 简介非空且>5字 |
| 2分 | 简介非空但≤5字 |
| 0分 | 简介为空 |

#### 作品总量评分（4分）

| 得分 | 作品数 |
|------|--------|
| 4分 | ≥300 |
| 3分 | 100-300 |
| 2分 | 30-100 |
| 1分 | 10-30 |
| 0分 | <10 |

---

### 维度四：平台指数（10分）

**基于平台权威指数评估账号影响力**

| 指标 | 满分 | 评分标准 | 数据来源 |
|------|------|---------|---------|
| 红狐指数 | 10分 | 见下表 | redfoxIndex |

> 若API未返回redfoxIndex（值为null），平台指数维度得0分

#### 红狐指数评分（10分）

| 得分 | 红狐指数 | 影响力等级 |
|------|---------|-----------|
| 10分 | ≥900 | 顶级影响力 |
| 8分 | 800-900 | 头部影响力 |
| 6分 | 700-800 | 中上影响力 |
| 4分 | 600-700 | 中等影响力 |
| 2分 | 500-600 | 初级影响力 |
| 0分 | <500 | 待提升 |

---

### 综合评分计算

```
综合评分 = 账号体量(0-35分) + 内容表现(0-35分) + 运营活跃度(0-20分) + 平台指数(0-10分)
```

### 评级标准

| 得分 | 评级 | 说明 |
|------|------|------|
| **90-100** | 🏆 S级 | 标杆账号，行业领先 |
| **80-89** | ⭐ A级 | 优质账号，竞争力强 |
| **70-79** | ✅ B级 | 健康账号，有优化空间 |
| **60-69** | 📊 C级 | 中等账号，需重点优化 |
| **50-59** | ⚠️ D级 | 亚健康，需要调整 |
| **<50** | ❌ E级 | 问题账号，急需优化 |

---

## 4. 优势/短板/建议生成逻辑

### 优势判断

| 条件 | 优势文案 |
|------|----------|
| 账号体量≥28 | 账号体量雄厚 |
| 账号体量≥18 | 粉丝基础扎实 |
| 内容表现≥28 | 内容数据突出 |
| 内容表现≥18 | 内容表现良好 |
| 运营活跃度≥16 | 运营节奏健康 |
| 平台指数≥8 | 平台指数优秀 |
| 平台指数≥4 | 平台影响力良好 |
| 以上均不满足 | 有基础运营框架 |

取前2条输出，使用列表格式（`+` 前缀）。

### 短板判断

| 条件 | 短板文案 |
|------|----------|
| 账号体量<12 | 账号体量偏小 |
| 内容表现<10 | 近期内容表现较弱 |
| 内容表现==0 | 近7天无作品数据 |
| 运营活跃度<8 | 运营活跃度不足 |
| 平台指数==0 | 无平台指数数据 |
| 以上均不满足 | 整体表现均衡，持续优化即可 |

取前2条输出，使用列表格式（`+` 前缀）。

### 建议生成

按短板优先级排序，至少3条：

| 条件 | 问题 | 建议 |
|------|------|------|
| 内容表现==0 | 近7天无作品更新 | 恢复稳定发布节奏，建议至少周更2-3条 |
| 内容表现<12 | 内容互动数据偏低 | 优化视频前3秒吸引力，增加互动引导话术 |
| 账号体量<12 | 粉丝基数偏小 | 通过热点内容+Dou+投放加速涨粉，聚焦垂直领域深耕 |
| 账号体量<22 | 账号体量有提升空间 | 持续产出爆款内容扩大影响力，探索跨平台引流 |
| 运营活跃度<10 | 运营活跃度不足 | 制定内容排期表保持日更或高频更新，完善账号简介 |
| 运营活跃度<16 | 运营节奏可优化 | 聚焦黄金时段（11-13点/18-21点）发布，提升内容曝光概率 |
| 平台指数==0 | 平台指数数据缺失 | 持续稳定运营以积累平台指数，提升内容质量与互动率 |
| 平台指数<4 | 平台指数偏低 | 提升内容质量与互动率，保持稳定更新以提升红狐指数 |
| 以上均不满足（兜底） | 持续优化方向 | 深耕垂直内容建立差异化标签，开启直播增强粉丝粘性 |

---

## 5. 输出模板

**使用说明：** 严格按模板输出，不可省略章节。所有评分精确到1位小数。以下为「人民日报」真实诊断报告示例：

**重要：** 在诊断报告之前，必须先输出评分计算明细（纯文本格式，分值以实际数据为准）：

```
**维度一：账号体量（35分）**
+ 粉丝数 201,242,077（≥5000万）→ 22分
+ 获赞总数 18,112,283,863（≥10亿）→ 8分
+ 获赞/粉丝比 ≈ 90.0（≥15）→ 5分
+ **小计：35分（满分）**

**维度二：内容表现（35分）**
+ 20条作品：总点赞5,457,017 / 总评论133,195 / 总分享937,749
+ 平均点赞 ≈ 272,851（10-50万）→ 9分
+ 平均评论 ≈ 6,660（5000-1万）→ 7分
+ 平均分享 ≈ 46,887（1-10万）→ 6分
+ 传播系数 ≈ 17.2%（≥15%）→ 6分
+ **小计：28分**

**维度三：运营活跃度（20分）**
+ 更新频率 20条（≥7条）→ 8分
+ 发布时段 14/20条为黄金时段 → 4分
+ 账号完整度 简介非空且>5字 → 4分
+ 作品总量 10,992（≥300）→ 4分
+ **小计：20分（满分）**

**维度四：平台指数（10分）**
+ 红狐指数 920.5（≥900）→ 10分
+ **小计：10分（满分）**

**综合评分：93.0分 — 🏆 S级 标杆账号**
```

以下为正式诊断报告：

```markdown
> 以下诊断结果是基于人民日报上周在抖音平台发布的作品进行分析得出。

## 📋 人民日报 - 抖音账号诊断报告

### 基本信息

| 昵称 | 抖音号 | 地域 | 粉丝数 | 获赞 | 作品数 | 红狐指数 | 数据时间 |
|------|--------|------|--------|------|--------|---------|----------|
| 人民日报 | rmrbxmt | 中国·北京·北京 | 2.0亿 | 181.1亿 | 10,992 | 920.5 | 2026-06-02 00:17:31 |

**简介：** 参与、沟通、记录时代。

---

### 📊 核心数据

**账号体量：**
- 粉丝数 2.0亿 | 获赞 181.1亿 | 获赞/粉丝比 90.0

**近7天作品（20条，展示最近7条）：**

| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 传播系数 |
|---|---------|------|------|------|------|------|----------|
| 🥇 | 2026-06-03 21:57 | [盗狗嫌疑人落网！小狗等主人下班时…](https://www.douyin.com/video/7647167835424263478) | 10.1万 | 54 | 1.1万 | 11.5万 | 11.1% |
| 🥈 | 2026-06-03 21:12 | [抓捕现场，在逃人员突然逃窜…](https://www.douyin.com/video/7647156256674680105) | 26.2万 | 32 | 5191 | 27.5万 | 2.0% |
| 🥉 | 2026-06-03 21:02 | [什么是正确政绩观？](https://www.douyin.com/video/7647153886305832232) | 6821 | 119 | 214 | 7562 | 3.1% |
| 4 | 2026-06-03 20:59 | ["世界向东看"！100秒看大国外交](https://www.douyin.com/video/7647152982408203555) | 1.6万 | 137 | 728 | 1.8万 | 4.6% |
| 5 | 2026-06-03 20:01 | [女子网购填写假地址调包退货…](https://www.douyin.com/video/7647138018230291748) | 2.9万 | 128 | 2386 | 3.3万 | 8.1% |
| 6 | 2026-06-03 19:59 | [货车备胎掉落高速，路过司机搬离](https://www.douyin.com/video/7647137552830385427) | 7.7万 | 122 | 938 | 8.1万 | 1.2% |
| 7 | 2026-06-03 18:52 | [女子被困阳台向派出所"隔空喊话"](https://www.douyin.com/video/7647120288076827945) | 11.7万 | 61 | 1617 | 12.3万 | 1.4% |

> 若playCount非null，追加"播放量"和"点赞率"列

---

### 🏆 综合评分

**总分：94.0 / 100分** — 🏆 标杆账号 S级

| 维度 | 得分 | 满分 | 得分率 |
|------|------|------|--------|
| 账号体量 | 35.0 | 35分 | 100.0% |
| 内容表现 | 29.0 | 35分 | 82.9% |
| 运营活跃度 | 20.0 | 20分 | 100.0% |
| 平台指数 | 10.0 | 10分 | 100.0% |
| **综合** | **94.0** | **100分** | **94.0%** |

**💪 优势：**

+ 账号体量雄厚
+ 平台指数优秀

**⚠️ 短板：**

+ 整体表现均衡，持续优化即可

---

### 💡 优化建议

1. **平均点赞有提升空间** → 增加轻量化、情感化选题比例，提升单条作品爆款率，拉高平均点赞至50万+
2. **评论互动深度可强化** → 在热点新闻末尾增加互动引导话术（如"你怎么看？"），提升用户评论参与度
3. **持续优化方向** → 深耕垂直内容建立差异化标签，开启直播增强粉丝粘性

---

*诊断时间：2026-06-04 | 数据来源：红狐数据 API | 数据更新：2026-06-02 00:17:31*
```

---

## 6. 账号分类映射

API返回的 `accountClassifyFirst` 字段需映射为输出新词：

| API原词 | 输出新词 | API原词 | 输出新词 |
|---------|---------|---------|---------|
| 全部 | 全部 | 美食 | 美食 |
| 才艺技能 | 个人才艺 | 美妆 | 化妆美容 |
| 生活 | 生活vlog | 萌宠 | 动物 |
| 财经 | 财富理财 | 母婴亲子 | 亲子 |
| 二次元 | 二次元 | 汽车 | 汽车 |
| 家居家装 | 居家装修 | 情感心理 | 情感 |
| 教育培训 | 学习教育 | 三农 | 三农 |
| 剧情演绎 | 小剧场 | 医疗健康 | 健康医学 |
| 科技数码 | 数码科技 | 时尚 | 潮流风尚 |
| 旅游 | 旅行 | 舞蹈 | 舞蹈才艺 |
| 颜值 | 颜值造型 | 人文社科 | 人文 |
| 音乐 | 音乐 | 影视综艺 | 影视 |
| 健身 | 身体锻炼 | 体育 | 体育 |
| 明星八卦 | 明星娱乐 | 游戏 | 游戏 |

---

## 7. Agent 行为规范（强制）

### 数据来源限制
- 🔒 所有账号信息和作品数据**必须通过红狐API获取**
- ❌ 严禁从其他渠道自主获取或估算数据
- ❌ playCount为null时不估算播放量，不计算点赞率/互动率等依赖播放量的指标
- ✅ 所有诊断分析必须基于API返回的真实数据

### 未查询到账号
- 输出收录引导文案（见SKILL.md「未查询到账号时的提示」章节）
- **严禁生成无依据报告**

### 输出格式铁律
- **在诊断报告之前，必须先输出评分计算明细**（纯文本格式，分值以实际数据为准）
- **在诊断报告最前面必须输出数据说明**：`> 以下诊断结果是基于{账号昵称}上周在抖音平台发布的作品进行分析得出。`
- 诊断报告必须严格按照第5节输出模板的章节顺序输出
- 章节顺序：数据说明 → 基本信息 → 核心数据 → 综合评分 → 优化建议
- 不输出账号头像
- 每个章节内部的格式必须与模板一致
- 所有评分精确到1位小数
- 禁止输出评分明细表格，仅保留四维度汇总表

### 输出禁止项
- 🚫 禁止输出各指标的评分明细表格
- 🚫 禁止从第三方渠道补充或估算API未返回的字段
- 🚫 禁止生成无依据的诊断报告

### 数字格式化规范
- ≥1亿：显示为 `X.X亿`
- ≥1万：显示为 `X.X万`
- <1万：显示为带千分位的整数，如 `9,876`

### 特殊场景处理
- **works为空（近7天无作品）**：内容表现得0分，运营活跃度中更新频率和发布时段均为0分
- **playCount为null**：如实标注"API未返回"，不估算
- **redfoxIndex为null**：平台指数维度得0分
- **similarAccounts为空**：不输出相似账号板块