rednote-ranking-data

SKILL.md

---
name: xiaohongshu-rankings
description: 想知道小红书哪些账号涨粉最猛？这款技能帮你追踪日榜/周榜/月榜涨粉数据，数据都是人工一个个账号比对校验出来的，覆盖全品类，还能一键生成好看的排名图！
---

# 小红书涨粉数据

---

## 简介

**数据从哪来？** 每天人工比对小红书上万账号，一个个校验涨粉数据，不是爬虫抓的，是实打实人工整理出来的！

**能做什么？**
- 📊 查日榜/周榜/月榜 —— 看看最近谁涨粉最猛
- 🎨 生成精美榜单图 —— 直接发小红书、朋友圈都行
- 📥 导出Excel —— 数据自己拿去分析
- 🔔 订阅推送 —— 每天自动收到最新榜单

**覆盖范围**：25个热门类目，从美妆穿搭到宠物职场，基本你想看的都有

**适合谁用？**
- 品牌方 —— 盯竞品、找达人
- MCN —— 管旗下账号
- 博主 —— 看同行、找灵感
- 好奇宝宝 —— 就想知道谁火了

数据每天下午7点更新，有1天延迟（比如4月21日能看4月19日的完整数据）。

**技术基础**：使用原生 Socket + SSL（无 SNI）方式访问数据源，支持 Coze、Clawhub 等平台部署。

---

## 功能特性

### 🎯 核心功能
- **📊 数据追踪**：提供小红书账号的粉丝数、涨粉数、涨粉率等核心指标
- **📈 排名统计**：按日/周/月维度生成粉丝增长排行榜
- **🎨 图片生成**：一键生成小红书风格的表格排名图片，支持下载分享
- **🔔 定时推送**：支持设置每日/每周/每月自动推送榜单到指定渠道

### ✨ 特色亮点
- **⚡ 每日更新**：榜单每日下午 7:00 发布更新，数据手动整理确保准确性
- **📅 数据延迟**：榜单数据有1天延迟（例如：4月20日可获取4月18日完整数据）
- **📊 查询限制**：日榜最多查30天、周榜最多查8周、月榜最多查3个月
- **🎨 精美图片**：生成的榜单图片可直接用于小红书、公众号等内容发布
- **📱 多平台支持**：支持 Coze、Skillhub、Clawhub 等平台安装使用
- **🔒 安全可靠**：无需 API 接入，直接即可使用
- **📊 多维度筛选**：支持按 25 个类目筛选

---

## 使用指南

### 基础使用

#### 1. 查询榜单数据
告诉助手你想查看的榜单类型：

> 用户：查看涨粉榜
> 
> 助手：正在为您查询【综合全部】最新涨粉榜 TOP20...
> 
> 📊 **综合全部 - 涨粉榜 TOP20**
> 
> | 排名 | 账号 | 涨粉数 |
> |------|------|--------|
> | #1 | xxx | +xx万 |
> | ... | ... | ... |
> 
> ---
> 
> 💬 **请问您需要以下服务吗？**
> 
> **1️⃣ 订阅其他类目榜单**
> 可订阅：出行代步、医疗保健、休闲爱好、综合杂项、婚庆婚礼、居家装修、影视娱乐、星座情感、拍摄记录、学习教育、旅行度假、亲子育儿、日常生活、科学探索、数码科技、时尚穿搭、化妆美容、个人护理、美味佳肴、职业发展、宠物天地、新闻资讯、体育锻炼、潮流鞋包
> 
> **2️⃣ 导出数据为 Excel**
> 将榜单数据导出为 Excel 表格文件
> 
> **3️⃣ 生成榜单图片**
> 生成精美的排名图片（可直接用于小红书/公众号发布）
> 
> 请回复数字 1、2、3 或您的具体需求～

**数据日期说明**：
- 榜单每日下午 7:00 发布更新
- 数据有 **1天延迟**（例如：4月20日可获取4月18日完整数据）
- 数据查询范围限制：
  - 日榜：最多查询前 **30天** 的数据
  - 周榜：最多查询前 **8周** 的数据
  - 月榜：最多查询前 **3个月** 的数据
- 如需指定日期，使用 `--date` 参数

**命令行方式**：
```bash
cd ~/.workbuddy/skills/xiaohongshu-rankings

# 查看综合全部榜单（推荐）
python3 scripts/generate_ranking_image.py --category 综合全部 --limit 20

# 生成指定类目榜单
python3 scripts/generate_ranking_image.py --category 化妆美容 --limit 20

# 生成周榜
python3 scripts/generate_ranking_image.py --category 综合全部 --type weekly --limit 20

# 生成月榜
python3 scripts/generate_ranking_image.py --category 综合全部 --type monthly --limit 20

# 自定义标题
python3 scripts/generate_ranking_image.py \
  --category 综合全部 \
  --title "小红书涨粉榜" \
  --subtitle "昨日涨粉最快的博主"
```

**输出**：图片自动保存到当前目录，并复制到桌面。

#### 2. 导出数据为 Excel
将榜单数据导出为 Excel 表格：

```bash
# 先查询数据保存为 JSON
python3 scripts/query_rankings.py --category 综合全部 --type daily --limit 20 --output /tmp/rankings.json

# 导出为 Excel
python3 scripts/export_to_excel.py --data /tmp/rankings.json --output ~/Desktop/涨粉榜.xlsx
```

**输出**：Excel 文件自动保存到桌面

#### 3. 生成榜单图片
生成精美的排名图片：

```bash
# 一键生成（查询+生成图片）
python3 scripts/generate_ranking_image.py --category 综合全部 --type daily --limit 20

# 或从已有数据生成
python3 scripts/generate_chart.py --type table --data data.json --output table.png
```

**输出**：图片自动保存到桌面，可直接用于小红书/公众号发布

#### 4. 查看原始数据
如需查看原始 JSON 数据：

```bash
python3 scripts/query_rankings.py --category 综合全部 --type daily --limit 20
```

### 常用命令速查

| 命令 | 功能 |
|------|------|
| `query_rankings.py --category 综合全部` | 查询榜单数据 |
| `generate_ranking_image.py --category [类目]` | 生成榜单图片 |
| `export_to_excel.py --data [文件]` | 导出数据为 Excel |
| `generate_chart.py --type table` | 生成表格样式图片 |
| `subscription_manager.py create` | 创建订阅 |
| `subscription_manager.py list` | 查看订阅列表 |

### 支持的类目

**默认推荐**：
- **综合全部**（包含所有类型账号）

**细分类型**（共24种）：
- 出行代步
- 医疗保健
- 休闲爱好
- 综合杂项
- 婚庆婚礼
- 居家装修
- 影视娱乐
- 星座情感
- 拍摄记录
- 学习教育
- 旅行度假
- 亲子育儿
- 日常生活
- 科学探索
- 数码科技
- 时尚穿搭
- 化妆美容
- 个人护理
- 美味佳肴
- 职业发展
- 宠物天地
- 新闻资讯
- 体育锻炼
- 潮流鞋包

**注意**：仅支持上述25个类目，不支持自定义关键词订阅。

---

## 使用场景

### 场景一：每日晚间榜单推送
**角色**：内容运营人员

**需求**：每日获取最新涨粉榜单，了解平台动态

**使用方式**：
1. 订阅【综合全部】日榜推送
2. 设置每日晚上 8:00 自动接收（榜单下午 7:00 发布）
3. 收到后直接转发到工作群

**订阅示例**：
> 用户：订阅每日的综合全部涨粉榜单
> 
> 助手：已为您创建订阅，每日晚上 8:00 推送【综合全部】最新涨粉榜 TOP20。

**预期收益**：第一时间掌握平台热门账号动态

**注意**：
- 榜单每日下午 7:00 发布更新
- 数据有 **1天延迟**（例如：4月20日晚推送的是4月18日数据）
- 建议订阅晚上 8:00 及以后的推送时间

---

### 场景二：每周类目榜单分析
**角色**：品牌营销经理

**需求**：每周分析特定类目的涨粉情况

**使用方式**：
1. 订阅【星座情感】周榜推送
2. 设置每周一早上推送上周榜单
3. 分析头部账号内容策略

**订阅示例**：
> 用户：每周一早上给我推送上周的星座情感类目涨粉榜单
> 
> 助手：已为您创建订阅，每周一早上推送【星座情感】上周涨粉榜 TOP20。

**预期收益**：掌握细分领域趋势，优化投放策略

---

### 场景三：每月全平台总结
**角色**：MCN 机构负责人

**需求**：每月底获取全平台涨粉榜单，做月度总结

**使用方式**：
1. 订阅【综合全部】月榜推送
2. 设置每月最后一天推送当月榜单
3. 生成报告用于月度复盘

**订阅示例**：
> 用户：每个月最后一天给我推送小红书涨粉月榜
> 
> 助手：已为您创建订阅，每月最后一天推送【综合全部】当月涨粉榜 TOP20。

**预期收益**：全面了解平台生态，指导下月运营方向

---

### 场景四：品牌方竞品监测
**角色**：品牌营销经理

**需求**：监测竞品账号的粉丝增长和内容表现

**使用方式**：
1. 订阅主要竞品所在类目的榜单
2. 每日查看增长排名对比
3. 生成榜单图片用于内部汇报

**预期收益**：及时掌握竞品动态，优化自身内容策略

---

### 场景五：MCN 机构达人管理
**角色**：MCN 运营人员

**需求**：管理旗下达人的数据表现

**使用方式**：
1. 批量订阅旗下达人的类目
2. 设置每日自动推送榜单
3. 生成周报图片汇报给管理层

**预期收益**：提升达人管理效率，及时发现问题账号

---

### 场景六：自媒体内容创作
**角色**：小红书博主/内容创作者

**需求**：了解同类博主的表现，创作榜单类内容

**使用方式**：
1. 查询各领域涨粉榜单
2. 一键生成精美的榜单图片
3. 直接发布到小红书/公众号

**预期收益**：快速创作数据类内容，提升账号影响力

---

## 项目架构

### 目录结构

```
xiaohongshu-rankings/
├── SKILL.md                          # 技能文档
├── scripts/                          # 核心脚本
│   ├── query_rankings.py             # 数据查询（入口脚本）
│   ├── generate_ranking_image.py     # 一键生成榜单图片
│   ├── export_to_excel.py            # 导出数据为 Excel
│   ├── generate_chart.py             # 图表生成（表格/柱状图）
│   ├── subscription_manager.py       # 订阅管理
│   └── delivery_service.py           # 推送服务
└── references/                       # 参考文档
    └── subscription_tiers.md         # 付费订阅方案
```

### 技术栈

- **运行环境**：Python 3.8+
- **核心依赖**：
  - `Pillow` - 图片生成
  - `matplotlib` - 图表绘制
  - `requests` - HTTP 请求
- **部署平台**：Coze / Skillhub / Clawhub

### 数据流转

```
用户请求 → generate_ranking_image.py → query_rankings.py → 数据源
                                              ↓
用户展示 ← 图片文件 ← generate_chart.py ← 原始数据
```

### 核心模块说明

| 模块 | 职责 |
|------|------|
| `query_rankings.py` | 主入口脚本，查询数据并引导用户后续操作 |
| `generate_ranking_image.py` | 一键生成榜单图片 |
| `export_to_excel.py` | 将榜单数据导出为 Excel 文件 |
| `generate_chart.py` | 使用 PIL 生成表格样式图片 |
| `subscription_manager.py` | 订阅的增删改查，支持三级订阅体系 |

---

## 常见问答

### 使用相关问题

**Q1: 可以订阅自定义关键词吗？**

A: **不支持**。本 Skill 仅支持以下25个固定类目：
- 综合全部（默认推荐）
- 出行代步、医疗保健、休闲爱好、综合杂项、婚庆婚礼
- 居家装修、影视娱乐、星座情感、拍摄记录、学习教育
- 旅行度假、亲子育儿、日常生活、科学探索、数码科技
- 时尚穿搭、化妆美容、个人护理、美味佳肴、职业发展
- 宠物天地、新闻资讯、体育锻炼、潮流鞋包

如需其他类目，请联系管理员反馈需求。

**Q2: 单个榜单最多显示多少条数据？**

A: 单个类目榜单上限为 **100条**。建议使用 `--limit` 参数控制显示数量（默认20条）。

```bash
# 显示TOP100
python3 scripts/generate_ranking_image.py --category 综合全部 --limit 100
```

**Q3: 如何订阅每日榜单推送？**

A: 告诉助手你的订阅需求：

> 用户：订阅每日的综合全部涨粉榜单
> 
> 用户：每周一给我推送上周的星座情感类目涨粉榜单
> 
> 用户：每个月最后一天给我推送小红书涨粉月榜

**注意**：日榜每日下午 7:00 发布，建议订阅晚上 8:00 及以后的推送时间。

**Q4: 生成的图片中文字体显示异常怎么办？**

A: 指定中文字体路径：
```bash
python3 scripts/generate_chart.py --font /System/Library/Fonts/PingFang.ttc ...
```

**Q5: 如何获取其他日期的数据？**

A: 使用 `--date` 参数指定日期：
```bash
python3 scripts/generate_ranking_image.py --category 综合全部 --date 2026-04-10 --limit 20
```

**数据日期说明**：
- 榜单每日下午 7:00 发布，发布的是前一天的完整数据
- 数据有 **1天延迟**（例如：4月20日可获取4月18日数据）
- 不指定日期时，默认获取前天数据（确保数据已发布）
- **数据查询范围限制**：
  - 日榜：最多查询前 **30天** 的数据
  - 周榜：最多查询前 **8周** 的数据
  - 月榜：最多查询前 **3个月** 的数据

**Q6: 支持哪些统计周期？**

A: 支持三种周期：
- `--type daily` - 日榜（每日下午 7:00 发布，数据有1天延迟）
- `--type weekly` - 周榜
- `--type monthly` - 月榜

**注意**：
- 日榜每日下午 7:00 发布，发布的是前一天的完整数据
- 数据有 **1天延迟**（例如：4月20日可获取4月18日数据）
- 不指定日期时，默认获取前天数据
- **数据查询范围限制**：
  - 日榜：最多查询前 **30天** 的数据
  - 周榜：最多查询前 **8周** 的数据
  - 月榜：最多查询前 **3个月** 的数据

---

### 安装相关问题

**Q7: 如何导出数据为 Excel？**

A: 使用 export_to_excel.py 脚本：
```bash
# 先查询数据
python3 scripts/query_rankings.py --category 综合全部 --limit 20 --output /tmp/data.json

# 导出为 Excel
python3 scripts/export_to_excel.py --data /tmp/data.json --output ~/Desktop/涨粉榜.xlsx
```

如需安装依赖（推荐固定版本号）：
```bash
pip install pandas==2.0.0 openpyxl==3.1.0
```

**Q8: 运行脚本时提示 "ModuleNotFoundError: No module named 'Pillow'" 怎么办？**

A: 安装依赖库（推荐固定版本号）：
```bash
pip install Pillow==10.0.0 requests==2.31.0 matplotlib==3.7.0 numpy==1.24.0 pandas==2.0.0 openpyxl==3.1.0
```

**Q9: 查询返回空数据怎么办？**

A: 请检查以下几点：
1. 确认网络环境可以正常访问数据源
2. 确认日期参数正确，尝试指定 `--date 2026-04-14`
3. 确认类目名称正确（请使用支持的25个类目名称）

---

### 故障排除

**Q10: 脚本运行时报 "Connection reset by peer" 错误？**

A: 该数据源需要特殊网络环境，请确认：
1. 是否已连接所需网络环境
2. 是否需要配置代理
3. 联系管理员确认访问权限

**Q11: 图片生成成功但找不到文件？**

A: 图片默认保存到：
- 当前目录（脚本执行目录）
- 桌面（自动复制）

可通过 `--output` 参数指定路径：
```bash
python3 scripts/generate_ranking_image.py --output ~/Desktop/my_ranking.png
```

---

### 获取帮助

如有其他问题，可通过以下方式获取帮助：
- 📖 查看 Skill 目录下的文档
- 💬 联系管理员

---

## 更新日志

### v1.0.0
- ✅ 基础数据查询功能
- ✅ 表格样式图片生成
- ✅ 一键生成脚本
- ✅ 订阅管理功能
- ✅ 定时推送支持
- ✅ 支持25个固定类目