小红书作品爬取 / xiaohongshu-crawler

简介

根据关键词爬取小红书热门作品，支持按日期范围筛选和多种排序方式，返回笔记标题、作者、互动数据等，结果以结构化表格展示。同时支持 CSV 和 HTML 可视化报告导出，便于离线查看与分享。

核心价值

精准发现热门内容：通过关键词 + 日期 + 排序三重筛选，快速锁定高热度笔记。
智能意图理解：输入大类词时自动推荐细分方向，避免泛泛搜索；空关键词时查询全站热门。
分级展示策略：数据充足时展示前 20 条并提示翻页；数据较少时给出拓展建议；无结果时推荐相关搜索词和热门笔记。
报告一键导出：支持 Excel（CSV）和 HTML 可视化报告，本地浏览器即可打开查看。

适用对象

📝 小红书博主 — 按选题关键词爬取同类爆款，为创作提供数据参考。
🛍️ 品牌 / 电商运营 — 竞品内容调研，了解特定品类的热门笔记与互动表现。
🏢 MCN / 内容策划 — 跨赛道批量爬取，规划达人矩阵内容方向。

功能特性

核心功能

关键词搜索：支持精确关键词、多关键词组合（逗号分隔）、全站热门查询（空关键词）。
日期范围筛选：支持绝对日期、相对日期（如「最近 7 天」）、日期范围，默认查询最近 30 天。
多种排序方式：相关性（默认）、最新（按发布时间）、最热（按互动数）三种排序灵活切换。
关键词泛化识别：输入大类词（如「美食」「穿搭」）时，先推荐 10 个细分方向供你选择，确认后再搜索。
分级结果展示：数据 ≥ 20 条展示前 20 条 + 翻页提示；1-19 条展示全部 + 拓展建议；0 条推荐搜索词 + 热门笔记 + 热门赛道。
报告导出：支持 CSV（Excel 兼容）和 HTML 可视化报告一键生成。
互动数据完整：每条作品返回收藏、分享、评论、点赞、发布时间等完整数据。

密钥获取与安全说明

本技能需要使用环境变量：REDFOX_API_KEY。
REDFOX_API_KEY 由红狐 hub (https://redfox.hk) 提供。
请前往红狐 hub 注册账号，获取 REDFOX_API_KEY。
配置设备环境变量 REDFOX_API_KEY 后使用本技能。
在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。

使用指南

直接用自然语言描述你想搜索的内容即可，无需记忆固定命令。

常用说法速查

| 意图 | 示例话术 | 效果 | | ---- | -------- | ---- | | 按关键词搜索 | 「帮我爬取最近一周减脂餐相关的作品」 | 按关键词 + 近 7 天 + 相关性排序返回结果 | | 按热度排序 | 「看看穿搭赛道最火的作品」 | 按最热排序，优先展示高互动笔记 | | 大类先细分 | 「爬取美食相关作品」 | 先推荐 10 个细分方向，你确认后再搜索 | | 查看全站热门 | 「最近小红书有什么热门作品」 | 空关键词查询全站热门内容 | | 指定日期范围 | 「爬取 5 月 20 号到 6 月 1 号的护肤作品」 | 按指定日期范围精准筛选 | | 下载报告 | 「下载 Excel 和 HTML 报告」 | 生成 CSV + HTML 可视化报告文件 |

输出示例

查询完成后，你将收到如下结构化表格（示意）：

| # | 笔记标题 | 作者 | 收藏 | 分享 | 评论 | 点赞 | 发布时间 | |---|---------|------|------|------|------|------|----------| | 1 | 一周减脂餐食谱分享 | 健康饮食达人 | 1.2w | 3500 | 800 | 5.6w | 06-02 19:55 | | 2 | 打工人减脂便当合集 | 上班族美食 | 8500 | 2100 | 320 | 3.2w | 06-01 12:30 |

使用场景

| 场景 | 角色 | 示例问法 | 收益 | | ---- | ---- | -------- | ---- | | 选题调研 | 小红书博主 | 「帮我爬取近一周小个子穿搭的热门作品」 | 了解同类爆款的内容方向与互动表现 | | 竞品分析 | 品牌运营 | 「爬取最近 30 天防晒霜相关笔记，按热度排序」 | 掌握品类热门内容与用户关注点 | | 赛道探索 | MCN 策划 | 「看看美食赛道最近有什么热门作品」 | 先细分方向再爬取，精准定位内容机会 | | 数据沉淀 | 内容运营 | 「爬取完帮我下载 HTML 可视化报告」 | 离线查看完整数据，便于团队分享与复盘 |