xhs-explosive-content-detector（小红书爆款雷达）

专为小红书内容创作打造的专业数据洞察工具。全网持续收录每日超过 2000 + 条爆款笔记，收录依据：低粉爆款、周期高赞、单日互动增量和互动持续增长笔记，助力创作者获取数据参考、把握流量趋势、启发创作思路。仅在主Agent中执行,不派发给子Agent。

小红书爆款雷达

简介

目的：让用户在 30 秒内了解这个 Skill 是什么、能解决什么问题。

小红书爆款雷达是一款专为内容创作者和营销人员设计的智能数据洞察工具。

通过简单的关键词查询，你可以：

• 🔍 追踪每日 2000+ 条新爆款笔记，解决「找爆文效率低」的痛点
• 🎯 智能筛选低粉高赞、周期爆发、单日飙升等多维度爆款，解决「对标参考无效」的痛点
• 📊 自动生成可视化卡片和推荐理由，大幅降低内容分析成本，放大爆款复制收益

适用于品牌方、MCN 机构、自媒体从业者、内容运营等需要监测小红书爆款内容的场景。

技术基础：Python 3.x + requests 库，数据来源于全网小红书公开内容聚合。

---

功能特性

🎯 核心功能

• 📊 低粉爆款筛选：严格按多维度（低粉爆款、周期高赞、单日爆发、持续增长）标准筛选内容，避开头部账号流量红利干扰，参考性更强
• 🏷️ 全分类覆盖：支持 25 个主流内容分类查询，精准匹配你所在的内容赛道
• 🤖 智能意图识别：自动判断用户搜索意图（泛浏览/明确需求/数据需求），精准匹配最相关的爆款内容
• 💡 自动推荐理由生成：基于用户意图和数据表现生成个性化推荐理由，每条内容 ≥15 字，避免模板化

✨ 特色亮点

• ⏰ 灵活日期适配：支持最近1天/3天/7天/30天查询，数据不足时自动扩展时间范围
• 📤 多格式输出：自动生成 Markdown 卡片 + HTML 可视化文件，支持直接预览和导出
• 🔗 智能细分词拓展：识别泛化词并推荐10个细分方向，用户确认后再执行搜索
• ⚡️ 无额外门槛：无需小红书账号、无需 API 密钥，安装依赖即可使用，无封禁风险

---

一键安装

前置条件

• 已安装 Python 3.8 及以上版本
• 网络可正常访问公开数据接口

安装方式

# 克隆项目仓库（如果需要）
git clone https://github.com/tool/xhs-explosive-content-detector.git

# 进入项目目录
cd xhs-explosive-content-detector

# 安装依赖
pip install requests>=2.28.0

环境变量配置

变量名	必填	说明
XHS_API_PROXY	否	代理服务器地址，若网络访问受限可配置，格式示例：http://127.0.0.1:7890
OUTPUT_PATH	否	生成的榜单文件（.html）保存路径，默认值为当前脚本运行目录

---

引用完整工作流

⚠️ 执行时详细操作步骤请引用 references/core_workflow.md。

脚本执行命令：

# 有赛道关键词
python scripts/fetch_xhs_trends.py --keyword <关键词> --start-date <日期>

# 无赛道关键词（查询全站热门）
python scripts/fetch_xhs_trends.py --keyword "" --start-date <日期>

# 多个关键词用逗号分隔
python scripts/fetch_xhs_trends.py --keyword "减脂餐,职场穿搭,健身" --start-date <日期>

输出文件：{keyword}_爆款数据.html