| name | douyin-rise-ranking |
| description | 获取抖音涨粉账号推荐数据，支持日榜/周榜/月榜按分类查询抖音账号涨粉排行，含总粉丝数、涨粉率与粉丝增量；当用户需要查询抖音涨粉榜、分析各领域账号涨粉趋势、了解粉丝增长数据或获取运营参考时使用 |
抖音涨粉账号推荐
简介
抖音涨粉账号推荐是一款专注于抖音涨粉数据查询的智能工具，帮助用户实时追踪各领域账号的粉丝增长排行。
通过本工具，你可以：
- 📊 获取每日/每周/每月的抖音涨粉TOP50排行
- 🔍 按27个垂直领域（美食、科技、美妆等）精准筛选
- 📈 自动生成三维涨粉分析报告（涨粉态势概览+增长模式分析+运营洞察建议）
- 🔔 订阅定时推送，数据自动送达
适用于创作者、品牌方、MCN机构、运营人员等需要监测抖音涨粉趋势的场景。
功能特性
🎯 核心功能
- 📊 多维时间榜单：支持日榜/周榜/月榜三种时间维度，覆盖不同运营周期需求
- 🔍 27类垂直分类：从美食到游戏，按领域精准筛选目标赛道的涨粉排行
- 📈 三维涨粉分析：涨粉态势概览（4项量化指标）+ 增长模式分析（3层分层对比）+ 运营洞察建议（标杆/潜力/风险3类）
- 🔔 定时订阅推送：一键订阅日榜/周榜/月榜，更新时间自动送达
✨ 特色亮点
- ⚡ 实时更新：日榜每日18:00更新、周榜每周一18:00更新、月榜每月3号18:00更新
- 🏆 可视化呈现：TOP3金银铜牌标识，账号名称含可点击跳转链接
- 📱 深度洞察：基于全量TOP50数据的三段式分析（涨粉态势概览 → 增长模式分析 → 运营洞察建议）
- 🔒 安全便捷：仅需 API Key，无需账号密码，数据通过标准化接口获取
一键安装
前置条件
- 已注册 红狐Hub 官网 账号
- 前往 注册页面 注册，新用户可获赠免费积分
- 在个人中心获取 API Key，格式为
ak_xxxxxxxx
环境变量配置
| 变量名 | 必填 | 说明 |
|---|
REDFOX_API_KEY | 是 | 红狐Hub API 访问密钥，格式 ak_xxxxxxxx |
配置方式
macOS/Linux：
export REDFOX_API_KEY=<你的apikey>
echo 'export REDFOX_API_KEY=<你的apikey>' >> ~/.bashrc
source ~/.bashrc
Windows：
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的apikey>", "User")
配置完成后验证：
- macOS/Linux：
echo $REDFOX_API_KEY
- Windows：
echo %REDFOX_API_KEY%
使用指南
基础使用
1. 查询涨粉日榜
直接说明你想查的分类即可，无需指定日榜（默认）：
用户：查一下美食类的抖音涨粉榜
助手：自动匹配"美食"分类，输出日榜TOP20排行 + 三维涨粉分析 + 订阅提示
用户：今日涨粉帮
助手：获取全部分类的最新日榜
2. 查询周榜或月榜
在查询时指定时间维度：
用户：这周科技类涨粉排行
助手：自动使用周榜数据，匹配"数码科技"分类
用户：本月美妆类涨粉榜
助手：自动使用月榜数据，匹配"化妆美容"分类
3. 查看更多排名
默认展示TOP20，回复"查看更多"可获取TOP21-50的剩余30条数据。
4. 订阅定时推送
查询完成后会提示订阅选项，回复数字即可：
| 数字 | 功能 | 推送时间 |
|---|
| 1 | 订阅日榜 | 每日 18:00 |
| 2 | 订阅周榜 | 每周一 18:00 |
| 3 | 订阅月榜 | 每月 3 号 18:00 |
| 4 | 全部订阅 | 日/周/月均推送 |
| 5 | 暂不订阅 | — |
也支持直接说"订阅日榜""订阅周榜""订阅月榜""全部订阅"。
高级使用
按关键词自动匹配分类
支持用关键词代替精确分类名，系统自动匹配：
| 你的输入关键词 | 自动匹配分类 |
|---|
| 手机/电脑/AI | 数码科技 |
| 美食/做饭/探店 | 美食 |
| 穿搭/时尚/潮流 | 潮流风尚 |
| 健身/运动/减肥 | 身体锻炼 |
| 护肤/化妆/美妆 | 化妆美容 |
| 游戏/电竞/手游 | 游戏 |
| 宠物/猫/狗 | 动物 |
| 跳舞/舞蹈 | 舞蹈才艺 |
| 唱歌/音乐 | 音乐 |
可用分类完整列表（27个）
全部、个人才艺、生活vlog、财富理财、二次元、居家装修、学习教育、小剧场、数码科技、旅行、美食、化妆美容、动物、亲子、汽车、情感、三农、健康医学、潮流风尚、舞蹈才艺、颜值造型、人文、音乐、影视、身体锻炼、体育、明星娱乐、游戏
数据回溯范围
| 榜单类型 | 可回溯范围 | 更新规则 |
|---|
| 日榜 | 近 7 天 | 每日 18:00 更新前一日数据 |
| 周榜 | 近 3 周 | 每周一 18:00 更新前一周数据 |
| 月榜 | 近 3 个月 | 每月 3 号 18:00 更新上一月数据 |
💡 完整执行流程（包括格式模板、操作步骤、日期判断逻辑、API参数等）请参阅 references/core_workflow.md。
使用场景
场景一：品牌方竞品监测
角色：品牌营销经理
需求：追踪同赛道品牌账号的涨粉表现，掌握竞品营销节奏
使用方式：
- 查询品牌所在分类的涨粉日榜/周榜
- 对比自身与竞品的涨粉率与增量
- 参考热点分析调整营销节奏
预期收益：把握行业涨粉趋势，优化品牌营销策略
场景二：内容创作者选题参考
角色：抖音创作者
需求：了解赛道涨粉热点，获取选题灵感
使用方式：
- 查看所在分类的涨粉榜和热点分析
- 分析头部账号涨粉特征（涨粉率、粉丝基数关系）
- 参考热点事件策划内容方向
预期收益：找到涨粉方向，提升内容竞争力
场景三：MCN 机构达人管理
角色：MCN 运营人员
需求：批量监测旗下达人及对标账号的涨粉数据
使用方式：
- 按分类查询周榜/月榜
- 对比旗下达人与行业头部的涨粉差距
- 利用热点分析优化达人运营策略
预期收益：数据驱动达人运营决策，及时发现潜力账号
场景四：投流与选号参考
角色：广告投放 / 商务人员
需求：筛选高增长潜力账号进行合作投放
使用方式：
- 查询月榜中高涨粉率的中小账号
- 结合三维涨粉分析判断增长持续性
- 锁定合作目标，降低选号风险
预期收益：精准选号，提升投放 ROI
项目架构
目录结构
douyin-rise-ranking/
├── SKILL.md # Skill 说明文档（本文件）
├── scripts/
│ └── gzh_growth_fetcher.py # 核心数据获取脚本
└── references/
├── core_workflow.md # 核心执行流程（格式模板、操作步骤）
└── dy-rank-api.md # API 接口规范
技术栈
| 项目 | 说明 |
|---|
| 运行环境 | Python 3.10+ |
| 数据源 | 红狐Hub 抖音涨粉排行 API |
| 认证方式 | REDFOX_API_KEY 环境变量 |
| 数据缓存 | ~/.workbuddy/cache/dy_rise_ranking_data.json |
核心模块
| 模块 | 路径 | 职责 |
|---|
| 数据获取 | scripts/gzh_growth_fetcher.py | 调用 API 获取涨粉排行数据，支持分类/关键词/日期参数 |
| 执行流程 | references/core_workflow.md | 完整操作步骤、格式模板、Checklist、日期判断逻辑 |
| API 规范 | references/dy-rank-api.md | 接口参数定义、返回字段说明、调用示例 |
常见问答
安装配置
Q1: 提示 API Key 无效怎么办？
A: 请检查：
- Key 格式是否为
ak_xxxxxxxx
- 确认已在 红狐Hub 官网激活
- 检查 Key 前后是否有多余空格
Q2: 如何验证 API Key 配置成功？
A: Windows 执行 echo %REDFOX_API_KEY%，macOS/Linux 执行 echo $REDFOX_API_KEY，确认输出正确的 Key 值。
使用相关
Q3: 支持哪些分类？
A: 共 27 个分类：全部、个人才艺、生活vlog、财富理财、二次元、居家装修、学习教育、小剧场、数码科技、旅行、美食、化妆美容、动物、亲子、汽车、情感、三农、健康医学、潮流风尚、舞蹈才艺、颜值造型、人文、音乐、影视、身体锻炼、体育、明星娱乐、游戏。
Q4: 数据多久更新一次？
A: 日榜每日 18:00 更新前一日数据，周榜每周一 18:00 更新前一周数据，月榜每月 3 号 18:00 更新上一月数据。
Q5: 可以查询多久之前的数据？
A: 日榜可回溯近 7 天，周榜近 3 周，月榜近 3 个月。超出范围会自动调整到最近可用日期。
Q6: 每次查询返回多少条？
A: 默认展示 TOP20 + 涨粉分析，回复"查看更多"可获取剩余 30 条（共 TOP50）。
Q7: 如何订阅定时推送？
A: 查询完成后会显示订阅选项，回复数字 1-5 即可。也支持直接说"订阅日榜""订阅周榜"等。
故障排除
Q8: 数据不更新或查询失败？
A: 按以下步骤排查：
- 检查
REDFOX_API_KEY 是否过期
- 确认当前时间是否已过榜单更新时间（均在 18:00 更新）
- 确认查询日期在允许的回溯范围内
获取帮助
如有其他问题，可通过以下方式联系：
