douyin-similar-account

---
name: douyin-similar-account
description: 抖音相似账号推荐工具，输入抖音账号名称或账号ID，通过红狐API接口获取本账号数据、内容数据和相似账号推荐数据，深度分析共通点、差异点和优化建议。当用户提到"推荐抖音相似账号"、"找抖音对标"、"抖音同类账号"、"抖音竞品分析"、"找抖音同行"时使用。
---

# 抖音相似账号推荐

## 简介

抖音相似账号推荐是一款专为抖音创作者设计的智能对标匹配工具，帮助用户快速找到可参考的对标账号和可追赶的头部标杆。

通过简单的名称或ID输入，你可以：
- 📊 查询账号基本信息 + 红狐指数 + 近期作品数据
- 🎯 匹配对标账号（红狐指数向上最近最近5个账号，可直接复制玩法）
- 🚀 推荐头部账号（同分类红狐指数Top5，模式成熟可追赶）
- 🔍 深度分析共通点、差异点和优化建议

适用于抖音创作者、内容运营、账号投放决策等需要对标参考的场景。基于 [红狐Hub](https://redfox.hk/) 数据平台提供支持。

## 功能特性

### 🎯 核心功能
- **🔍 智能查询**：支持按抖音昵称、抖音号两种方式查询（自动识别昵称和抖音号）
- **📊 账号数据**：展示查询账号的基本信息、红狐指数、播放数据及近期作品
- **🎯 对标账号**：推荐红狐指数向上最近的5个同赛道账号，可直接复制运营玩法
- **🚀 头部账号**：推荐同分类红狐指数倒序前5的成熟账号，模式可参考追赶
- **🔍 深度分析**：总结共通点、差异点，提供可落地的优化建议
- **📬 订阅推送**：查询结果末尾支持订阅相似账号最新信息推送，可自定义推送频率和时间

### ✨ 特色亮点
- **📈 红狐指数**：每个对标/头部账号均展示红狐指数和指数差距，量化对标差距
- **💡 推荐理由**：每个对标账号附带多维度推荐理由，涵盖红狐指数对比、爆品标题引用、更新节奏、互动率等
- **📊 表格列顺序**：账号名称 | 粉丝数 | 总获赞 | 近7天互动 | 红狐指数 | 指数差距 | 推荐理由
- **📱 多输入方式**：名称/ID灵活查询，昵称自动识别

## 一键安装

### 前置条件
- Python 3.x 运行环境
- RedFox API Key（前往 [红狐Hub 官网](https://redfox.hk/) 注册获取，新用户赠送免费积分）

### 获取 API Key
1. 访问 [红狐Hub 官网](https://redfox.hk/) 了解服务详情
2. 前往 [注册页面](https://redfox.hk/login) 注册账号
3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务
4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`

### 配置 API Key
- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`
- 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent应主动帮用户设置：
  - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效
  - **Windows**：使用 `[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User")` 设置用户级永久环境变量（需重启终端生效）
  - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个skill也能读取到

### 环境变量配置

| 变量名 | 必填 | 说明 |
| --- | --- | --- |
| `REDFOX_API_KEY` | 是 | RedFox API 访问密钥，格式 `ak_xxxxxxxx` |

## 使用指南

### 基础使用

#### 按抖音名称/号查询
告诉助手你想查询的抖音账号（支持昵称和抖音号）：

> 用户：帮我查"一乐店长"的相似抖音账号
>
> 助手：调用脚本 `python scripts/douyin_similar_account.py --account_id "一乐店长"`，将脚本输出原样完整展示，禁止摘要、改写、增减或添加额外评论

> 用户：查抖音号geng970616的相似账号
>
> 助手：调用脚本 `python scripts/douyin_similar_account.py --account_id "geng970616"`，将脚本输出原样完整展示，禁止摘要、改写、增减或添加额外评论

### 命令速查

| 命令 | 功能 |
|------|------|
| `--account_id "昵称或抖音号"` | 按抖音账号昵称或抖音号查询（自动识别） |
| `--account_id "抖音号" --sync` | 触发账号数据收录（账号未找到时，用户确认收录后使用） |

### 输出流程

详细的核心工作流程（操作步骤、输出模板、API接口详情、字段映射、对标匹配规则、推荐理由生成维度、输出格式规范等）请参考 [references/core_workflow.md](references/core_workflow.md)。

## 使用场景

### 场景一：新号起号参考
**角色**：抖音新手运营

**需求**：刚创建抖音号，不知道怎么定位和选题

**使用方式**：
1. 查询自己账号的对标推荐
2. 查看对标账号的内容方向和更新节奏
3. 复制对标账号的运营策略

**预期收益**：快速找到可复制的运营模式，降低起号试错成本

---

### 场景二：内容选题优化
**角色**：抖音内容运营

**需求**：内容遇到瓶颈，需要参考同赛道优秀账号的选题方向

**使用方式**：
1. 查询自己账号的相似推荐
2. 分析头部标杆的爆品特征和内容风格
3. 调整自身选题策略

**预期收益**：突破内容瓶颈，提升播放量和互动数据

---

### 场景三：账号投放决策
**角色**：品牌营销经理

**需求**：选择合适的抖音号进行广告投放

**使用方式**：
1. 查询目标赛道头部账号
2. 对比对标和头部账号的数据表现
3. 评估互动率和粉丝画像匹配度

**预期收益**：精准选择投放账号，提高投放ROI

---

### 场景四：竞品分析
**角色**：MCN 运营人员

**需求**：了解竞品账号的运营策略和数据表现

**使用方式**：
1. 查询竞品账号的相似推荐
2. 深度分析共通点和差异
3. 发现市场空白机会

**预期收益**：掌握竞品动态，发现差异化竞争机会

## 项目架构

### 目录结构

```
抖音相似账号推荐/
├── scripts/
│   └── douyin_similar_account.py   # 核心脚本：调用API查询对标账号并格式化输出
├── references/
│   └── core_workflow.md            # 核心工作流程：操作步骤、输出模板、API接口详情、字段映射、推荐理由生成维度
└── SKILL.md                        # 技能描述文件
```

### 技术栈

| 组件 | 说明 |
| --- | --- |
| **运行环境** | Python 3.x |
| **依赖** | Python 标准库（json、argparse、os、time、urllib、platform、re） |
| **数据源** | RedFox API（https://redfox.hk/） |
| **API 接口** | POST /story/api/dyUser/querySimilarAccounts（查询账号信息+对标账号+头部账号） |

## 常见问答

### 安装相关问题

**Q1: 提示 "未找到 REDFOX_API_KEY 配置" 怎么办？**

A: 请按以下步骤配置：
1. 访问 https://redfox.hk/ 注册账号并获取 API Key
2. Windows 用户在 PowerShell 执行：`[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的API Key>", "User")`
3. macOS/Linux 用户执行：`echo 'export REDFOX_API_KEY=<你的API Key>' >> ~/.zshrc` 然后 `source ~/.zshrc`
4. 重启终端后生效

**Q2: 需要安装额外的 Python 依赖吗？**

A: 不需要。脚本仅使用 Python 标准库（json、argparse、os、urllib、re 等），无需 pip install 任何包。

---

### 使用相关问题

**Q3: 查询不到账号数据怎么办？**

A: 当查询不到账号时，系统会提示进行账号收录。回复抖音号（在抖音个人主页显示的ID），即可触发账号收录，30分钟后将自动推送相似账号报告。如暂不需要可下次再说。

可能原因：1) 该账号暂未被平台完整收录；2) 输入的抖音号或名称不准确。

**Q4: 支持哪些查询方式？**

A: 支持两种输入方式，脚本自动识别：
- 按昵称：`--account_id "一乐店长"`（含中文自动用accountName查询）
- 按抖音号/uid：`--account_id "geng970616"`（非中文自动用accountId查询）

**Q5: 对标账号和头部账号有什么区别？**

A: 对标账号是红狐指数向上最近的5个账号，指数接近可直接复制玩法；头部账号是同分类红狐指数倒序前5，运营模式更成熟，适合追赶学习。

**Q6: 红狐指数是什么？**

A: 红狐指数是RedFox平台基于账号多维度数据（粉丝量、互动量、内容质量等）综合计算的评估指标，数值越高代表账号综合表现越好。对标账号推荐以此为核心排序依据。

**Q7: 查询结果中的订阅推送是什么？**

A: 每次查询结果末尾会提示是否订阅该账号的相似账号最新信息推送。选择订阅后，每日下午19点会推送最新数据，也可自行选择推送频率和时间。暂不需要则可选择"暂不需要"。

---

### 故障排除

**Q8: API 请求返回 HTTP 错误怎么办？**

A: 请检查以下几点：
1. 确认 API Key 是否正确且未过期
2. 确认网络可以正常访问 https://redfox.hk/
3. 检查 API Key 是否有足够的积分余额

**Q9: 输出结果中某些字段为空或为0？**

A: 这是正常现象，说明该账号在对应数据维度上暂无数据记录。脚本会自动处理为"暂无"或"0"展示。

---

### 获取帮助

如有其他问题，可通过以下方式获取帮助：
- 📧 访问 [红狐Hub 官网](https://redfox.hk/) 了解更多