---
name: xhs-breaking-rankings
description: 小红书低粉爆款笔记专注于挖掘小红书平台上的隐形爆款数据，获取粉丝量低于5000但互动量超过500的笔记榜单。寻找拥有爆款规律和热门趋势的优质样本。
dependency:
  python:
    - requests>=2.28.0

---

## 1. 简介

**一句话定位**：帮你发现小红书上那些粉丝不多但内容很能打的黑马笔记，从中找到可以借鉴的选题和写法。

**核心价值**：

你只需要告诉我一个感兴趣的分类，比如「居家装修」「化妆美容」，我就能帮你捞出一批粉丝不到5000却拿到高互动的笔记。每一条都附带互动数据、发布时间和内容分析，还会自动总结这批爆款的标题套路和内容特征，让你快速摸清什么内容在涨。

**适用对象**：

+ 📌 小红书内容创作者：找选题灵感，学标题写法，了解赛道风向
+ 📌 内容运营：低粉爆款是最真实的用户喜好信号，比大V数据更有参考价值
+ 📌 MCN / 品牌方：发现潜力博主，评估内容趋势

## 2. 功能特性

### 核心功能

| 功能模块 | 能力描述 |
|:-------:|:--------|
| 📊 **分类筛选** | 覆盖25个内容分类，从综合热门到亲子育儿，输入分类名或关键词就能查 |
| 🏆 **TOP50榜单** | 按互动量从高到低排列，每条笔记都标出点赞、收藏、评论、分享数据 |
| 💡 **爆款规律分析** | 自动拆解这批笔记的标题类型、内容主题分布，提炼出可以复用的写法亮点 |
| 🔔 **每日订阅推送** | 订阅后每天19:30自动推送当日最新榜单，不用手工查询 |
| 📄 **文件包导出** | 生成小红书风格的完整页面，支持导出PDF，方便保存和分享 |

### 数据标准

查询范围：粉丝数低于5000、笔记点赞数大于500

每条笔记包含：标题、作者、粉丝数、发布时间、点赞数、评论数、收藏数、分享数、互动总数

## 3. 使用指南

> ⚠️ 加载本技能后，务必先读取 [references/core_workflow.md](references/core_workflow.md) 获取完整执行规则，包含脚本调用方式、日期处理、输出格式和分类匹配逻辑。

### 3.1 基础查询

1. 触发技能后，告诉我想查的分类和日期
2. 不指定日期时，系统自动取最近可用的数据日
3. 等待结果输出，包含榜单表格和规律分析

### 3.2 进阶操作

**查看完整榜单**

首次展示 TOP20，回复「查看更多」即可看到 TOP21-50。

**订阅每日推送**

回复「订阅」或在结果页选择订阅，之后每天19:30自动收到最新榜单。

**导出文件包**

回复「2」生成完整页面文件包，包含所有笔记数据和排版，可导出PDF。

### 3.3 核心执行流程

技能执行时按以下流程走，详细规则见 [references/core_workflow.md](references/core_workflow.md)：

1. 触发技能后，先问用户要查什么分类、哪天的数据
2. 调用主脚本获取数据，脚本会自动匹配分类、处理日期
3. 脚本生成 md 报告文件，读取全部内容原样输出给用户
4. 输出包含三部分：爆款笔记表格、爆款规律分析、功能选择入口
5. 等待用户选择：订阅、导出文件包、查看更多，或不操作

## 4. 使用场景

### 场景一：日常选题找灵感

**角色**：小红书创作者

**需求**：不知道今天写什么，想看同一赛道别人在发什么

**使用方式**：

1. 输入自己所在的内容分类，比如「化妆美容」
2. 浏览 TOP50 榜单，看看哪些选题拿到了高互动
3. 参考爆款规律分析中的标题模版和内容特征，结合自己的风格重新创作


### 场景二：竞品内容监测

**角色**：内容运营 / 品牌方

**需求**：了解某一赛道的低粉黑马在做什么内容，判断趋势

**使用方式**：

1. 选择目标分类定期查询
2. 关注笔记的内容主题分布和标题特征变化
3. 对比不同日期的规律分析，发现新兴的话题方向


### 场景三：爆款规律研究

**角色**：内容策略分析师

**需求**：系统性研究某一分类的爆款规律

**使用方式**：

1. 连续多天查询同一分类
2. 对比不同日期的标题类型占比和内容主题变化
3. 导出文件包存档，便于整理分析报告


## 5. 项目架构

### 5.1 目录结构

```
xhs-breaking-rankings/
├── SKILL.md
├── scripts/
│   ├── fetch_explosive_articles.py      # 主脚本：数据获取 + 分析 + md输出
│   └── generate_html_on_demand.py       # HTML文件包生成
├── references/
│   ├── core_workflow.md                 # 核心执行流程
│   └── api-spec.md                      # API接口规范
└── assets/
    └── preview-template.html            # HTML页面模版
```

### 5.2 技术构成

| 组件 | 说明 |
|:----:|:----|
| Python 3 | 核心脚本语言 |
| socket / ssl | 原生网络请求 |
| json | 数据解析 |
| argparse | 命令行参数 |
| HTML模板 | 文件包页面渲染 |

### 5.3 数据流转

用户输入分类关键词 → 匹配对应分类 → 调用数据接口 → 获取笔记数据 → 按互动量排序 → 生成榜单表格 → 自动分析标题特征和内容主题 → 输出完整报告

## 6. 常见问答

### 查询相关问题

**Q1：查出来好多笔记跟我想的分类不相关怎么办？**

A：分类匹配基于关键词和内容标签，偶尔会有跨界内容混入。如果结果偏差较大，可以试试换个更精准的关键词，比如查「居家装修」比查「装修」更准确。

**Q2：为什么数据不是当天的？**

A：数据每天19:30更新一次。19:30之前查询会取前一天的数据，这是正常的更新节奏。

**Q3：输入「查看更多」后没有反应？**

A：确认数据总量超过20条。如果总数不超过20条，首次输出就是全部内容。

### 订阅相关问题

**Q4：订阅后每天什么时候推送？**

A：每天19:30自动推送当日最新数据。

**Q5：可以订阅多个分类吗？**

A：当前每次订阅一个分类，想换分类需要重新订阅。

### 文件导出问题

**Q6：导出的文件包长什么样？**

A：生成一个完整的小红书风格页面，每条笔记都有独立卡片，包含标题、作者、互动数据和内容分析。可以直接在浏览器打开或导出PDF。

## 7. 资源索引

- 核心脚本：[scripts/fetch_explosive_articles.py](scripts/fetch_explosive_articles.py) — 数据获取、分析和md输出
- HTML生成：[scripts/generate_html_on_demand.py](scripts/generate_html_on_demand.py) — 用户回复「2」后调用
- 页面模版：[assets/preview-template.html](assets/preview-template.html) — HTML文件包排版模版
- 接口规范：[references/api-spec.md](references/api-spec.md) — 数据接口说明
- 核心流程：[references/core_workflow.md](references/core_workflow.md) — 完整执行规则和输出格式定义