| name | douyin-similar-account |
| description | 抖音相似账号推荐工具，输入抖音账号名称或账号ID，通过红狐API接口获取本账号数据、内容数据和相似账号推荐数据，深度分析共通点、差异点和优化建议。当用户提到"推荐抖音相似账号"、"找抖音对标"、"抖音同类账号"、"抖音竞品分析"、"找抖音同行"时使用。 |
抖音相似账号推荐
简介
抖音相似账号推荐是一款专为抖音创作者设计的智能对标匹配工具，帮助用户快速找到可参考的对标账号和可追赶的头部标杆。
通过简单的名称或ID输入，你可以：
- 📊 查询账号基本信息 + 红狐指数 + 近期作品数据
- 🎯 匹配对标账号（红狐指数向上最近最近5个账号，可直接复制玩法）
- 🚀 推荐头部账号（同分类红狐指数Top5，模式成熟可追赶）
- 🔍 深度分析共通点、差异点和优化建议
适用于抖音创作者、内容运营、账号投放决策等需要对标参考的场景。基于 红狐Hub 数据平台提供支持。
功能特性
🎯 核心功能
- 🔍 智能查询：支持按抖音昵称、抖音号两种方式查询（自动识别昵称和抖音号）
- 📊 账号数据：展示查询账号的基本信息、红狐指数、播放数据及近期作品
- 🎯 对标账号：推荐红狐指数向上最近的5个同赛道账号，可直接复制运营玩法
- 🚀 头部账号：推荐同分类红狐指数倒序前5的成熟账号，模式可参考追赶
- 🔍 深度分析：总结共通点、差异点，提供可落地的优化建议
- 📬 订阅推送：查询结果末尾支持订阅相似账号最新信息推送，可自定义推送频率和时间
✨ 特色亮点
- 📈 红狐指数：每个对标/头部账号均展示红狐指数和指数差距，量化对标差距
- 💡 推荐理由：每个对标账号附带多维度推荐理由，涵盖红狐指数对比、爆品标题引用、更新节奏、互动率等
- 📊 表格列顺序：账号名称 | 粉丝数 | 总获赞 | 近7天互动 | 红狐指数 | 指数差距 | 推荐理由
- 📱 多输入方式：名称/ID灵活查询，昵称自动识别
一键安装
前置条件
- Python 3.x 运行环境
- RedFox API Key（前往 红狐Hub 官网 注册获取，新用户赠送免费积分）
获取 API Key
- 访问 红狐Hub 官网 了解服务详情
- 前往 注册页面 注册账号
- 新注册用户将获赠免费积分，可立即开始使用 API 服务
- 注册登录后，在个人中心获取 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。
使用场景
场景一：新号起号参考
角色：抖音新手运营
需求：刚创建抖音号，不知道怎么定位和选题
使用方式：
- 查询自己账号的对标推荐
- 查看对标账号的内容方向和更新节奏
- 复制对标账号的运营策略
预期收益：快速找到可复制的运营模式，降低起号试错成本
场景二：内容选题优化
角色：抖音内容运营
需求：内容遇到瓶颈，需要参考同赛道优秀账号的选题方向
使用方式：
- 查询自己账号的相似推荐
- 分析头部标杆的爆品特征和内容风格
- 调整自身选题策略
预期收益：突破内容瓶颈，提升播放量和互动数据
场景三：账号投放决策
角色：品牌营销经理
需求：选择合适的抖音号进行广告投放
使用方式：
- 查询目标赛道头部账号
- 对比对标和头部账号的数据表现
- 评估互动率和粉丝画像匹配度
预期收益：精准选择投放账号，提高投放ROI
场景四：竞品分析
角色：MCN 运营人员
需求：了解竞品账号的运营策略和数据表现
使用方式：
- 查询竞品账号的相似推荐
- 深度分析共通点和差异
- 发现市场空白机会
预期收益：掌握竞品动态，发现差异化竞争机会
项目架构
目录结构
抖音相似账号推荐/
├── 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: 请按以下步骤配置：
- 访问 https://redfox.hk/ 注册账号并获取 API Key
- Windows 用户在 PowerShell 执行：
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的API Key>", "User")
- macOS/Linux 用户执行：
echo 'export REDFOX_API_KEY=<你的API Key>' >> ~/.zshrc 然后 source ~/.zshrc
- 重启终端后生效
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: 请检查以下几点：
- 确认 API Key 是否正确且未过期
- 确认网络可以正常访问 https://redfox.hk/
- 检查 API Key 是否有足够的积分余额
Q9: 输出结果中某些字段为空或为0？
A: 这是正常现象，说明该账号在对应数据维度上暂无数据记录。脚本会自动处理为"暂无"或"0"展示。
获取帮助
如有其他问题，可通过以下方式获取帮助：
