抖音账号诊断宗师

简介

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

通过简单的账号输入，你可以：

• 📊 获取四维度量化评分（100分制），告别主观判断
• 📋 自动生成评分计算明细 + 完整诊断报告
• 💡 获得针对性的优势/短板分析和优化建议

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

触发方式：

• "诊断抖音账号"、"抖音账号分析"、"抖音体检"
• "抖音评估"、"查看XX抖音数据"
• 直接输入抖音名称 + "诊断/分析"

功能特性

🎯 核心功能

| 功能 | 说明 |

|------|------|

| 📊 四维度评分 | 账号体量(35分) + 内容表现(35分) + 运营活跃度(20分) + 平台指数(10分) = 100分 |

| 📋 诊断报告 | 自动生成评分计算明细 + 完整诊断报告（基本信息/核心数据/综合评分/优化建议） |

| 🔍 账号查询 | 支持按昵称（模糊匹配）或抖音号（精确匹配）查询 |

| 💡 优化建议 | 基于评分数据自动生成优势/短板分析和3条优化建议 |

✨ 特色亮点

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

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

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

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

一键安装

前置条件

• 已获取红狐API Key（前往 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 第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 第6节（账号分类映射）

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

常见问答

安装相关问题

Q1: 如何获取红狐API Key？

A: 前往 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未返回的字段。