redfox-data 1. 简介
一句话定位：帮你发现小红书上那些粉丝不多但内容很能打的低粉笔记，从中找到可以借鉴的选题和写法。
核心价值：
你只需要告诉我一个感兴趣的分类，比如「居家装修」「化妆美容」，我就能帮你捞出一批粉丝不到5000却拿到高互动的笔记。每一条都附带互动数据、发布时间和内容分析，还会自动总结这批爆款的标题套路和内容特征，让你快速摸清什么内容在涨。
适用对象：
- 📌 小红书内容创作者：找选题灵感，学标题写法，了解赛道风向
- 📌 内容运营：低粉爆款是最真实的用户喜好信号，比大V数据更有参考价值
- 📌 MCN / 品牌方：发现潜力博主，评估内容趋势
2. 功能特性
核心功能
| 功能模块 | 能力描述 |
|---|---|
| 📊 分类筛选 | 覆盖25个内容分类，从综合热门到亲子育儿，输入分类名或关键词就能查 |
| 🏆 TOP50榜单 | 按互动量从高到低排列，每条笔记都标出点赞、收藏、评论、分享数据 |
| 💡 爆款规律分析 | 自动拆解这批笔记的标题类型、内容主题分布，提炼出可以复用的写法亮点 |
| 🔔 每日订阅推送 | 订阅后每天19:30自动推送当日最新榜单，不用手工查询 |
| 📄 文件包导出 | 生成小红书风格的完整页面，支持导出PDF，方便保存和分享 |
数据标准
查询范围：粉丝数低于5000、笔记点赞数大于500
每条笔记包含：标题、作者、粉丝数、发布时间、点赞数、评论数、收藏数、分享数、互动总数
3.鉴权
本技能调用 红狐Hub API 获取小红书低粉爆款数据，需要有效的 API Key 才能正常使用。
获取 API Key
配置 API Key
技能运行时会按以下三级回退自动获取 API Key：
| 优先级 | 来源 | 行为 |
|---|---|---|
| 1 | 当前环境变量 REDFOX_API_KEY |
直接使用 |
| 2 | Shell 配置文件（自动扫描 ~/.zshrc、~/.bashrc、PowerShell profile 等） |
读取后注入当前环境变量 |
| 3 | 未找到 | 打印详细的获取和配置指引 |
若未配置，请按对应系统设置：
macOS / Linux：
# 将以下行追加到 ~/.zshrc（zsh）或 ~/.bashrc（bash）
export REDFOX_API_KEY=<你的apikey>
# 然后执行使其生效
source ~/.zshrc # 或 source ~/.bashrc
Windows：
# PowerShell（管理员模式）
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的apikey>", "User")
配置后需重启终端生效。
验证配置：
- macOS / Linux：
echo $REDFOX_API_KEY - Windows CMD：
echo %REDFOX_API_KEY% - Windows PowerShell：
echo $env:REDFOX_API_KEY
若不会配置，告诉Agent主动帮助设置。
4. 使用指南
4.1 基础查询
- 触发技能后，告诉我想查的分类和日期
- 不指定日期时，系统自动取最近可用的数据日
- 等待结果输出，包含榜单表格和规律分析
4.2 进阶操作
订阅每日推送
回复「订阅」或在结果页选择订阅，之后每天19:30自动收到最新榜单。
导出文件包
回复「2」生成完整页面文件包，包含所有笔记数据和排版，可导出PDF。
4.3 核心执行流程
- 触发技能后，先问用户要查什么分类、哪天的数据
- 调用主脚本获取数据，脚本通过原生 socket+SSL 请求 API，自动匹配分类、处理日期
- 脚本按三级回退（环境变量 → Shell 配置 → 提示用户）获取 REDFOX_API_KEY 进行鉴权
- 脚本生成 md 报告文件和数据缓存 JSON 文件（
*_cache.json），读取 md 全部内容原样输出给用户 - 输出包含三部分：爆款笔记表格、爆款规律分析、功能选择入口
- 等待用户选择：订阅、导出文件包（回复「2」）、查看更多，或不操作
- 用户回复「2」时：从缓存生成 HTML → preview_url 自动展示（若未正常展示则用 open_result_view 兜底）→ deliver_attachments 发送文件 → 告知保存路径
4.4 节能机制：HTML 生成不重复请求 API + 自动展示
用户回复「2」生成 HTML 文件包时，Agent 执行以下步骤：
第一步：生成 HTML（不请求 API）
直接从已获取的数据缓存文件渲染，不再请求 API：
- 主脚本在生成 md 报告的同时，自动输出
*_cache.json缓存文件，存储完整的 articles 列表 - HTML 生成脚本
generate_html_on_demand.py支持--from-cache参数，指向缓存文件即可直接渲染 - 保留
--rank_date+--keyword回退模式，仅在缓存文件不可用时手动请求
调用示例：
# 节能模式：从缓存生成 HTML（0 次 API 请求）
python generate_html_on_demand.py --from-cache ./小红书居家装修低粉爆款数据_xxx_cache.json --output ./output.html
# 回退模式：重新请求 API 获取数据后渲染（仅缓存缺失时使用）
python generate_html_on_demand.py --rank_date 2026-05-26 --keyword 居家装修 --output ./output.html
第二步：自动展示 + 发送 HTML（必须执行，两步都要做）
生成 HTML 后，Agent 必须按顺序执行以下操作：
- 优先使用
preview_url工具打开该文件，让用户直接看到可视化页面 - 若
preview_url未正常展示（含中文路径等兼容问题），立即改用open_result_view兜底展示 - 使用
deliver_attachments工具将 HTML 文件作为附件发送给用户，确保用户在不同客户端都能收到文件
以上操作缺一不可。完成后告知用户文件保存路径。
5. 使用场景
场景一：日常选题找灵感
角色：小红书创作者
需求：不知道今天写什么，想看同一赛道别人在发什么
使用方式：
- 输入自己所在的内容分类，比如「化妆美容」
- 浏览 TOP50 榜单，看看哪些选题拿到了高互动
- 参考爆款规律分析中的标题模版和内容特征，结合自己的风格重新创作
场景二：竞品内容监测
角色：内容运营 / 品牌方
需求：了解某一赛道的低粉黑马在做什么内容，判断趋势
使用方式：
- 选择目标分类定期查询
- 关注笔记的内容主题分布和标题特征变化
- 对比不同日期的规律分析，发现新兴的话题方向
场景三：爆款规律研究
角色：内容策略分析师
需求：系统性研究某一分类的爆款规律
使用方式：
- 连续多天查询同一分类
- 对比不同日期的标题类型占比和内容主题变化
- 导出文件包存档，便于整理分析报告
6. 项目架构
6.1 目录结构
xiaohongshu-lowtop/
├── SKILL.md
├── scripts/
│ ├── fetch_explosive_articles.py # 主脚本：数据获取（原生 socket+SSL） + 分析 + md输出
│ └── generate_html_on_demand.py # HTML文件包生成
├── references/
│ └── api-spec.md # API接口规范
└── assets/
└── preview-template.html # HTML页面模版
6.2 技术构成
| 组件 | 说明 |
|---|---|
| Python 3 | 核心脚本语言 |
| socket / ssl | 原生网络请求 |
| json | 数据解析 |
| argparse | 命令行参数 |
| HTML模板 | 文件包页面渲染 |
6.3 数据流转
主查询流程：用户输入分类关键词 → 匹配对应分类 → 调用数据接口（1次API请求） → 获取笔记数据 → 按互动量排序 → 生成榜单表格 + 缓存JSON → 自动分析标题特征和内容主题 → 输出完整报告
HTML生成流程（节能+自动展示）：用户选择导出 → 读取缓存JSON文件（0次API请求） → 渲染HTML页面 → Agent 立即用 preview_url 自动展示 → 告知保存路径
7. 常见问答
查询相关问题
Q1：查出来好多笔记跟我想的分类不相关怎么办？
A：分类匹配基于关键词和内容标签，偶尔会有跨界内容混入。如果结果偏差较大，可以试试换个更精准的关键词，比如查「居家装修」比查「装修」更准确。
Q2：为什么数据不是当天的？
A：数据每天19:30更新一次。19:30之前查询会取前一天的数据，这是正常的更新节奏。
Q3：输入「查看更多」后没有反应？
A：确认数据总量超过20条。如果总数不超过20条，首次输出就是全部内容。
订阅相关问题
Q4：订阅后每天什么时候推送？
A：每天19:30自动推送当日最新数据。
Q5：可以订阅多个分类吗？
A：当前每次订阅一个分类，想换分类需要重新订阅。
文件导出问题
Q6：导出的文件包长什么样？
A：生成一个完整的小红书风格页面，每条笔记都有独立卡片，包含标题、作者、互动数据和内容分析。可以直接在浏览器打开或导出PDF。
8. 资源索引
- 核心脚本：scripts/fetch_explosive_articles.py — 数据获取（原生 socket+SSL，三级 API Key 鉴权）、分析和 md 输出
- HTML生成：scripts/generate_html_on_demand.py — 用户回复「2」后调用，支持
--from-cache节能模式（0次API请求）和--rank_date回退模式 - 页面模版：assets/preview-template.html — HTML文件包排版模版
- 接口规范：references/api-spec.md — 数据接口说明及 API Key 认证方式