| 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 第3节（四维度评分体系）
优势/短板/建议生成逻辑详见 → references/core_workflow.md 第4节
输出模板（评分计算明细 + 诊断报告格式）详见 → references/core_workflow.md 第5节（输出模板）
一键安装
前置条件
环境变量配置
| 变量名 | 必填 | 说明 |
|---|
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返回空数据时，输出收录引导文案，严禁生成无依据报告
未查询到当前账号的相关信息，可提交当前抖音账号进行账号收录。
- 回复抖音号（在抖音个人主页显示的ID，如 1212_1234），即可进行账号收录。30分钟后将自动为您推送诊断报告~
- 下次再说；
- API调用失败：降级为联网搜索，明确标注数据来源。严禁从第三方渠道估算或补充API未返回的字段。
使用场景
场景一：品牌方账号评估
角色：品牌营销经理
需求：评估潜在合作达人的账号质量和内容表现
使用方式：
- 输入达人抖音昵称进行诊断
- 查看综合评分和四个维度得分率
- 关注内容表现和运营活跃度，判断达人近期状态
预期收益：用数据代替直觉，科学评估达人合作价值
场景二：MCN机构达人管理
角色：MCN运营人员
需求：定期监测旗下达人的账号健康度和运营节奏
使用方式：
- 定期对旗下达人进行账号诊断
- 关注运营活跃度维度的更新频率和发布时段
- 根据优化建议指导达人调整发布策略
预期收益：及时发现问题账号，提升达人管理效率
场景三：自媒体账号优化
角色：抖音博主 / 内容运营
需求：了解自身账号表现，找到优化方向
使用方式：
- 输入自己的抖音账号进行诊断
- 重点查看短板和优化建议
- 针对性改善发布时段、内容选题或运营节奏
预期收益：明确优化方向，提升账号数据表现
项目架构
目录结构
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: 可能原因：
- 输入的昵称或抖音号有误，请检查后重试
- 该账号尚未被红狐平台收录，可按提示提交数据收录申请
- 尝试使用抖音号（而非昵称）进行精确查询
Q7: API调用失败如何处理？
A: 系统会自动降级为联网搜索，并在报告中明确标注数据来源。严禁从第三方渠道估算或补充API未返回的字段。
