douyin-account-diagnosis

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节（输出模板）

---

一键安装

前置条件

• 已获取红狐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未返回的字段。

---