douyin-rise-ranking

---
name: douyin-rise-ranking
description: 获取抖音涨粉账号推荐数据，支持日榜/周榜/月榜按分类查询抖音账号涨粉排行，含总粉丝数、涨粉率与粉丝增量；当用户需要查询抖音涨粉榜、分析各领域账号涨粉趋势、了解粉丝增长数据或获取运营参考时使用
---

# 抖音涨粉账号推荐

## 简介

抖音涨粉账号推荐是一款专注于抖音涨粉数据查询的智能工具，帮助用户实时追踪各领域账号的粉丝增长排行。

通过本工具，你可以：
- 📊 获取每日/每周/每月的抖音涨粉TOP50排行
- 🔍 按27个垂直领域（美食、科技、美妆等）精准筛选
- 📈 自动生成三维涨粉分析报告（涨粉态势概览+增长模式分析+运营洞察建议）
- 🔔 订阅定时推送，数据自动送达

适用于创作者、品牌方、MCN机构、运营人员等需要监测抖音涨粉趋势的场景。

---

## 功能特性

### 🎯 核心功能

- **📊 多维时间榜单**：支持日榜/周榜/月榜三种时间维度，覆盖不同运营周期需求
- **🔍 27类垂直分类**：从美食到游戏，按领域精准筛选目标赛道的涨粉排行
- **📈 三维涨粉分析**：涨粉态势概览（4项量化指标）+ 增长模式分析（3层分层对比）+ 运营洞察建议（标杆/潜力/风险3类）
- **🔔 定时订阅推送**：一键订阅日榜/周榜/月榜，更新时间自动送达

### ✨ 特色亮点

- **⚡ 实时更新**：日榜每日18:00更新、周榜每周一18:00更新、月榜每月3号18:00更新
- **🏆 可视化呈现**：TOP3金银铜牌标识，账号名称含可点击跳转链接
- **📱 深度洞察**：基于全量TOP50数据的三段式分析（涨粉态势概览 → 增长模式分析 → 运营洞察建议）
- **🔒 安全便捷**：仅需 API Key，无需账号密码，数据通过标准化接口获取

---

## 一键安装

### 前置条件

- 已注册 [红狐Hub 官网](https://redfox.hk/) 账号
- 前往 [注册页面](https://redfox.hk/login) 注册，新用户可获赠免费积分
- 在个人中心获取 API Key，格式为 `ak_xxxxxxxx`

### 环境变量配置

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

### 配置方式

**macOS/Linux**：
```bash
export REDFOX_API_KEY=<你的apikey>
echo 'export REDFOX_API_KEY=<你的apikey>' >> ~/.bashrc
source ~/.bashrc
```

**Windows**：
```powershell
[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](references/core_workflow.md)。

---

## 使用场景

### 场景一：品牌方竞品监测

**角色**：品牌营销经理

**需求**：追踪同赛道品牌账号的涨粉表现，掌握竞品营销节奏

**使用方式**：
1. 查询品牌所在分类的涨粉日榜/周榜
2. 对比自身与竞品的涨粉率与增量
3. 参考热点分析调整营销节奏

**预期收益**：把握行业涨粉趋势，优化品牌营销策略

---

### 场景二：内容创作者选题参考

**角色**：抖音创作者

**需求**：了解赛道涨粉热点，获取选题灵感

**使用方式**：
1. 查看所在分类的涨粉榜和热点分析
2. 分析头部账号涨粉特征（涨粉率、粉丝基数关系）
3. 参考热点事件策划内容方向

**预期收益**：找到涨粉方向，提升内容竞争力

---

### 场景三：MCN 机构达人管理

**角色**：MCN 运营人员

**需求**：批量监测旗下达人及对标账号的涨粉数据

**使用方式**：
1. 按分类查询周榜/月榜
2. 对比旗下达人与行业头部的涨粉差距
3. 利用热点分析优化达人运营策略

**预期收益**：数据驱动达人运营决策，及时发现潜力账号

---

### 场景四：投流与选号参考

**角色**：广告投放 / 商务人员

**需求**：筛选高增长潜力账号进行合作投放

**使用方式**：
1. 查询月榜中高涨粉率的中小账号
2. 结合三维涨粉分析判断增长持续性
3. 锁定合作目标，降低选号风险

**预期收益**：精准选号，提升投放 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: 请检查：
1. Key 格式是否为 `ak_xxxxxxxx`
2. 确认已在 红狐Hub 官网激活
3. 检查 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: 按以下步骤排查：
1. 检查 `REDFOX_API_KEY` 是否过期
2. 确认当前时间是否已过榜单更新时间（均在 18:00 更新）
3. 确认查询日期在允许的回溯范围内

---

### 获取帮助

如有其他问题，可通过以下方式联系：
- 📧 邮箱：redfoxdata@proton.me