douyin-account-diagnosis · diff
git:20260609.f1cb0b0 to git:20260805.1db3e09
100 added, 191 removed. Audit A to A.
---
name: douyin-account-diagnosis
- description: 抖音账号诊断宗师，输入抖音账号名称或账号ID，通过红狐API获取账号数据和作品数据，从账号体量、内容表现、运营活跃度、平台指数四个维度进行全面诊断分析。当用户提到"诊断抖音账号"、"抖音账号分析"、"抖音体检"、"抖音评估"、"查看XX抖音数据"时使用。
+ description: "一键诊断抖音账号运营健康度。基于红狐数据服务获取账号画像与近期作品数据，从账号基础画像、内容生产力、互动健康度、内容质量、内容趋势、粉丝质量六个维度进行量化诊断，输出100分制综合评分、维度得分明细、六类风险预警和针对性优化建议。触发词：当用户提到'诊断抖音账号'、'抖音账号分析'、'抖音体检'、'抖音账号评估'、'查看XX抖音数据'、'分析这个抖音号'时使用"
---
- # 抖音账号诊断宗师
-
- ## 简介
-
- 抖音账号诊断宗师是一款专业的抖音账号数据分析工具，通过红狐API接口获取账号精确数据，从四个维度进行全面诊断评估。
-
- 通过简单的账号输入，你可以：
- - 📊 获取四维度量化评分（100分制），告别主观判断
- - 📋 自动生成评分计算明细 + 完整诊断报告
- - 💡 获得针对性的优势/短板分析和优化建议
+ # 抖音账号诊断
- 适用于品牌方、MCN机构、自媒体从业者、内容运营人员等需要评估抖音账号表现的场景。
+ ## 📝 简介
- **触发方式：**
- - "诊断抖音账号"、"抖音账号分析"、"抖音体检"
- - "抖音评估"、"查看XX抖音数据"
- - 直接输入抖音名称 + "诊断/分析"
+ 抖音账号诊断帮助你快速摸清一个抖音账号的运营底数。只需提供账号昵称或抖音号，即可一键获取账号画像与近期作品数据，从六个维度完成量化诊断，输出100分制综合评分、得分明细、风险预警和优化方向。
- ---
+ 无论是自查账号健康度、评估竞品实力，还是筛查合作账号的真实质量，都能在几分钟内拿到一份结构清晰的诊断报告。
- ## 功能特性
+ ## ✨ 功能特性
- ### 🎯 核心功能
+ ### 核心功能
- | 功能 | 说明 |
- |------|------|
- | 📊 四维度评分 | 账号体量(35分) + 内容表现(35分) + 运营活跃度(20分) + 平台指数(10分) = 100分 |
- | 📋 诊断报告 | 自动生成评分计算明细 + 完整诊断报告（基本信息/核心数据/综合评分/优化建议） |
- | 🔍 账号查询 | 支持按昵称（模糊匹配）或抖音号（精确匹配）查询 |
- | 💡 优化建议 | 基于评分数据自动生成优势/短板分析和3条优化建议 |
+ | 功能模块 | 能力描述 | 核心价值 |
+ |---------|---------|----------|
+ | 一键数据获取 | 输入昵称或抖音号，自动获取账号画像与近期作品数据 | 无需手动搜集数据，即查即诊 |
+ | 六维度量化诊断 | 覆盖账号画像、生产力、互动、质量、趋势、粉丝质量 | 全面体检，不留盲区 |
+ | 100分制综合评分 | 加权计算综合得分并给出四级评级 | 一个数字看懂账号水平 |
+ | 风险预警 | 自动识别僵尸粉、刷量、衰退、限流、断更、单条依赖六类风险 | 提前发现问题，避免踩坑 |
+ | 近期作品明细 | 默认输出全部近期作品的互动数据，标题可点击跳转直达作品 | 诊断结论有据可查 |
- ### ✨ 特色亮点
+ ### 特色亮点
- - **⚡ 精准数据**：基于红狐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节（输出模板）
+ 本技能为标准 Skill 文件包，兼容所有支持 Skill 机制的 AI Agent 平台。选择你使用的平台，按对应方式安装即可：
- ---
+ ### Qoder
- ## 一键安装
+ 1. 确保已安装 Qoder 客户端
+ 2. 将 `douyin-account-diagnosis` 目录放入你的 Skills 文件夹
+ 3. 重启 Qoder 即可使用
- ### 前置条件
+ ### OpenClaw / WorkBuddy
- - 已获取红狐API Key（前往 [redfox.hk](https://redfox.hk) 申请，格式 `ak_xxx`）
+ 1. 将 `douyin-account-diagnosis` 目录放入 OpenClaw 或 WorkBuddy 的 Skills 目录（通常为 `~/.openclaw/skills/` 或 `~/.workbuddy/skills/`）
+ 2. 重启对应客户端即可生效
- ### 环境变量配置
+ ### Codex / Claude Code
- | 变量名 | 必填 | 说明 |
- |--------|------|------|
- | `REDFOX_API_KEY` | 是 | 红狐API访问密钥，格式 `ak_xxx` |
+ 1. 将 `douyin-account-diagnosis` 目录放入对应的 Skills 目录中
+ 2. Codex 默认路径：项目根目录下的 `.codex/skills/`
+ 3. Claude Code 默认路径：项目根目录下的 `.claude/skills/`
+ 4. 重启 Agent 会话即可加载
- ### API配置
+ ### 其他支持 Skill 的平台
- | 配置项 | 值 |
- |--------|-----|
- | 接口地址 | `POST https://redfox.hk/story/api/dyUser/query` |
- | 认证方式 | 请求头 `X-API-KEY` |
- | 积分消耗 | 每次查询0.6积分 |
- | 来源标识 | `抖音账号诊断宗师-GitHub` |
+ 只要平台支持标准的 Skill 文件格式（SKILL.md + 配套资源），将 `douyin-account-diagnosis` 目录放入其 Skills 目录下即可使用。
- > 完整的请求参数与响应字段详见 → [references/core_workflow.md](references/core_workflow.md) 第2节（API调用配置）
+ ## 📖 使用指南
- ---
+ ### 🔑 鉴权
- ## 使用指南
+ > 本技能自动接入红狐后台服务，无需手动配置即可使用。
+ >
+ > 如需使用自己的额度，可前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API KEY，并通过以下任一方式配置：
+ >
+ > 1. 设置环境变量 `REDFOX_API_KEY`
+ > 2. 使用命令行参数 `--api-key`
### 基础使用
- #### 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. 针对性改善发布时段、内容选题或运营节奏
-
- **预期收益**：明确优化方向，提升账号数据表现
-
- ---
-
- ## 项目架构
-
- ### 目录结构
+ #### 1. 发起诊断
- ```
- 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配置、分类映射 |
+ #### 2. 查看诊断报告
- ### 数据流转
+ 诊断完成后输出 Markdown 结构化报告，包含：
- ```
- 用户输入(昵称/抖音号) → API客户端 → 红狐API → 原始数据
- ↓
- 诊断报告 ← 报告生成器 ← 评分计算 ← 数据解析
- ```
+ - 开头总结句（昵称 + 综合评分 + 评级，一眼看懂结论）
+ - 基本信息表格（昵称、抖音号、UID、粉丝数、作品数等）
+ - 六维度评分表格（维度、得分、满分、一句话评价，标注核心短板）
+ - 风险预警（僵尸粉、刷量、衰退、限流、断更、单条依赖，含具体数据解读）
+ - 关键发现（优势与短板两组要点，每条附数据佐证）
+ - 近期作品表格（发布时间、标题、赞/评/转/总互动，标题为可点击跳转链接）
+ - 优化建议（按优先级排列，结合诊断数据给出具体方向）
- > 完整的账号分类映射详见 → [references/core_workflow.md](references/core_workflow.md) 第6节（账号分类映射）
+ #### 3. 补充分析（可选）
- > 完整的Agent行为规范详见 → [references/core_workflow.md](references/core_workflow.md) 第7节（Agent行为规范）
+ 如需进一步了解某个维度，可继续追问：
- ---
+ > 用户：互动健康度偏低，怎么改善？
+ >
+ > 助手：结合诊断报告中的短板维度与预警信息，给出针对性优化建议。
- ## 常见问答
+ ### 常用说法速查
- ### 安装相关问题
+ | 意图 | 示例话术 | 效果 |
+ |------|---------|------|
+ | 按昵称诊断 | "诊断抖音账号 XX" | 模糊匹配昵称并输出完整报告 |
+ | 按抖音号诊断 | "分析这个抖音号 66456544107" | 精确匹配抖音号并输出完整报告 |
+ | 账号体检 | "给 XX 做个抖音体检" | 输出六维度诊断报告 |
+ | 查看数据 | "查看 XX 的抖音数据" | 输出账号画像与近期作品数据 |
+ | 评估账号 | "评估一下这个抖音账号值不值得合作" | 输出评分、评级与风险预警 |
- **Q1: 如何获取红狐API Key？**
+ ## 🔄 工作流程
- A: 前往 [redfox.hk](https://redfox.hk) 注册账号，在控制台申请API Key，格式为 `ak_xxx`。
+ 1. **提供账号**：输入抖音昵称或抖音号
+ 2. **数据获取**：一键获取账号画像与近期作品数据
+ 3. **六维度诊断**：按评分体系逐项计算得分
+ 4. **输出报告**：综合评分 + 评级 + 风险预警 + 近期作品详情
+ 5. **补充分析**：针对短板维度提供优化建议（可选）
- **Q2: 每次查询消耗多少积分？**
+ > 完整执行流程详见 `references/core_workflow.md`，详细评分规则详见 `references/diagnosis_rules.md`
- A: 每次查询消耗0.6积分。积分不足时（API返回code=3201），系统会降级为联网搜索并标注数据来源。
+ ## 🔗 接口文档
- ### 使用相关问题
+ > 接口详情详见 `references/api_reference.md`
- **Q3: 昵称查询和抖音号查询有什么区别？**
+ ## ❓ 常见问答
- A: 昵称查询使用 `accountNames` 参数，为模糊匹配，可能返回多个结果（取第一个）；抖音号查询使用 `accountIds` 参数，为精确匹配。
+ ### 使用相关
- **Q4: 为什么红狐指数显示0.0？**
+ **Q：昵称和抖音号都能查吗？**
+ A：都可以。含中文的输入按昵称模糊匹配，纯数字/英文的输入按抖音号精确匹配。
- A: 部分账号可能未被红狐平台收录或数据未更新，此时 redfoxIndex 返回0.0或null，平台指数维度得0分。
+ **Q：报告会包含近期作品明细吗？**
+ A：会。近期作品详情默认输出，包含每条作品的发布时间、点赞/评论/分享/总互动数，标题为可点击跳转链接，点击即可直达对应作品。
- **Q5: 诊断报告中为什么没有播放量？**
+ **Q：评分是怎么算出来的？**
+ A：六个维度先各自计分，再归一化到100分制后按权重加权求和，每项规则详见 `references/diagnosis_rules.md`。
- A: 红狐API返回的 playCount 字段常为null，本工具不估算播放量，也不计算依赖播放量的指标（如点赞率）。
+ **Q：可以只诊断某个维度吗？**
+ A：诊断默认输出全部六个维度。如果只关注某一项，可以在拿到报告后针对该维度追问。
### 故障排除
- **Q6: 提示"未查询到账号"怎么办？**
+ **Q：提示"未查询到该账号"怎么办？**
+ A：请核对昵称或抖音号是否正确。昵称查询为模糊匹配，建议使用账号完整昵称。
- A: 可能原因：
- 1. 输入的昵称或抖音号有误，请检查后重试
- 2. 该账号尚未被红狐平台收录，可按提示提交数据收录申请
- 3. 尝试使用抖音号（而非昵称）进行精确查询
+ **Q：提示积分不足怎么办？**
+ A：前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 充值后重试即可。
- **Q7: API调用失败如何处理？**
+ **Q：某些字段显示"未知"是异常吗？**
+ A：不是。平台未返回的字段（如省份、年龄）会按"未知"处理，不影响其他维度的诊断结果。
- A: 系统会自动降级为联网搜索，并在报告中明确标注数据来源。**严禁从第三方渠道估算或补充API未返回的字段。**
+ ## 📚 参考文档
- ---
+ - 详细执行工作流：`references/core_workflow.md`
+ - 详细评分规则：`references/diagnosis_rules.md`
+ - 接口文档：`references/api_reference.md`
+