rednote-ranking-data

Data & APIs

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

Install

openclaw skills install rednote-ranking

小红书涨粉数据


简介

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

能做什么?

  • 📊 查日榜/周榜/月榜 —— 看看最近谁涨粉最猛
  • 🎨 生成精美榜单图 —— 直接发小红书、朋友圈都行
  • 📥 导出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

排名账号涨粉数
#1xxx+xx万
.........

💬 请问您需要以下服务吗?

1️⃣ 订阅其他类目榜单 可订阅:出行代步、医疗保健、休闲爱好、综合杂项、婚庆婚礼、居家装修、影视娱乐、星座情感、拍摄记录、学习教育、旅行度假、亲子育儿、日常生活、科学探索、数码科技、时尚穿搭、化妆美容、个人护理、美味佳肴、职业发展、宠物天地、新闻资讯、体育锻炼、潮流鞋包

2️⃣ 导出数据为 Excel 将榜单数据导出为 Excel 表格文件

3️⃣ 生成榜单图片 生成精美的排名图片(可直接用于小红书/公众号发布)

请回复数字 1、2、3 或您的具体需求~

数据日期说明

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

命令行方式

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 表格:

# 先查询数据保存为 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. 生成榜单图片

生成精美的排名图片:

# 一键生成(查询+生成图片)
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 数据:

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条)。

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

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

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

用户:订阅每日的综合全部涨粉榜单

用户:每周一给我推送上周的星座情感类目涨粉榜单

用户:每个月最后一天给我推送小红书涨粉月榜

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

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

A: 指定中文字体路径:

python3 scripts/generate_chart.py --font /System/Library/Fonts/PingFang.ttc ...

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

A: 使用 --date 参数指定日期:

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 脚本:

# 先查询数据
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

如需安装依赖(推荐固定版本号):

pip install pandas==2.0.0 openpyxl==3.1.0

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

A: 安装依赖库(推荐固定版本号):

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 参数指定路径:

python3 scripts/generate_ranking_image.py --output ~/Desktop/my_ranking.png

获取帮助

如有其他问题,可通过以下方式获取帮助:

  • 📖 查看 Skill 目录下的文档
  • 💬 联系管理员

更新日志

v1.0.0

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