📝 简介 输入关键词就能搜到小红书上的热门笔记，支持按排序方式、发布时间、笔记类型多维度筛选，笔记标题、作者、点赞、评论、分享、收藏数一览无余，点一下链接就能跳转看详情。
✨ 功能特性
关键词搜索：输入关键词搜索小红书热门笔记，精准发现目标赛道的内容。
多维排序：综合 / 最新 / 最多点赞 / 最多评论 / 最多收藏，按不同维度发现优质内容。
时间筛选：不限 / 一天内 / 一周内 / 一个月内 / 一年内，灵活控制搜索时间窗口。
类型筛选：不限 / 视频笔记 / 普通笔记，按内容形式精准过滤。
分页浏览：每页展示多条结果，支持多页翻看，不遗漏任何一条内容。
订阅推送：支持关键词每日推送，定时获取最新搜索结果。
🎯 适用对象
内容创作者：找同赛道热门笔记，研究对标内容的选题方向和爆款规律。
运营 / 数据分析：快速摸清某个品类在小红书上有哪些热门内容，掌握流量趋势。
品牌 / MCN：筛选潜在合作达人，按互动量评估笔记价值，辅助投放决策。
电商选品：搜索细分赛道的带货笔记，找到匹配的推广内容方向。
🔑 鉴权
获取 API Key：请前往 红狐hub 获取 API KEY。
配置 API Key 有两种方案：
方案1：以 Qoder 为例，将 REDFOX_API_KEY 添加到 ~/.openclaw/openclaw.json 中：
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
方案2：终端配置
export REDFOX_API_KEY="ak_xxxx..."
🔄 工作流程
Step 1：理解用户意图，提取关键词和筛选参数
-
提取关键词：从用户描述中提取 2~6 字的搜索关键词；若用户意图模糊（如"帮我搜小红书"），主动询问「请问你想搜索哪个方向或领域的内容？」；不得在用户未提供关键词时擅自猜测并调用脚本。
-
识别筛选参数（用户未指定时使用默认值）：
排序方式（--sort）：默认 最多点赞。用户提到"综合" → 综合；提到"最新"、"最近" → 最新，同时联动发布时间为 不限、笔记类型为 不限；提到"最新热门"、"最近热门"、"最新爆款"、"最近火什么" → 最多点赞，同时联动发布时间为 一周内；提到"评论"、"讨论多" → 最多评论；提到"收藏" → 最多收藏；未提及排序 → 最多点赞（默认）。
发布时间（--note-time）：默认 一个月内。用户提到"一天"、"今天"、"24小时" → 一天内；提到"一周"、"七天"、"最近7天" → 一周内；提到"一个月"、"30天" → 一个月内；提到"一年"、"全年" → 一年内；提到"不限时间"、"全部" → 不限；未提及时间 → 一个月内（默认）。
笔记类型（--note-type）：默认 不限。用户提到"视频"、"视频笔记" → 视频笔记；提到"图文"、"普通笔记"、"图文笔记" → 普通笔记；未提及类型 → 不限（默认）。
页码（--page）：默认 1。用户提到"下一页"、"第2页" → 对应页码；未提及页码 → 1（默认）。
Step 2：调用搜索脚本
python3 ~/.agents/skills/xiaohongshu-realtime-search/scripts/search_xhs_work.py "<关键词>" [--sort 排序] [--note-time 时间] [--note-type 类型] [--page 页码]
参数说明：keyword 为任意字符串搜索关键词；--sort 可选 综合 / 最新 / 最多点赞 / 最多评论 / 最多收藏，默认最多点赞；--note-time 可选 不限 / 一天内 / 一周内 / 一个月内 / 一年内，默认一个月内；--note-type 可选 不限 / 视频笔记 / 普通笔记，默认不限；--page 为正整数页码，从 1 开始，默认 1。
脚本以 JSON 格式输出，字段包括：articles（关键词匹配作品列表，按请求排序参数排列）、sort_label（本次排序方式文字说明）、note_time_label（本次时间范围文字说明）、note_type_label（本次笔记类型文字说明）、page（当前页码）、has_next（是否有下一页 true/false）、total（总条数）。
每条作品字段包括：title（笔记标题）、author（作者名称）、author_url（作者主页链接）、like_count（点赞数）、comment_count（评论数）、share_count（分享数）、collect_count（收藏数）、work_url（作品链接）、publish_time（发布时间 YYYY-MM-DD HH:MM）、publish_date（发布日期 YYYY-MM-DD）、follower_count（粉丝数）。
Step 3：判断结果并展示
情况 A：articles 数量 > 0（有匹配结果）
A1. 告知用户查询范围：📊 关键词「XXX」查询到 N 条笔记（排序：{sort_label} | 时间范围：{note_time_label} | 笔记类型：{note_type_label} | 第 {page} 页），以下是详细数据：
A2. 链接风控提示（紧接在 A1 之后，每次必须输出）：⚠️ 受小红书风控规则限制，部分作品链接可能无法正常跳转，您可复制对应作品标题前往小红书搜索查看，感谢理解🙇♀️🙇♀️
A3. 渲染 Markdown 表格（必须逐条输出，条数必须与 A1 中 N 一致，一条不漏）：
| # | 笔记标题 | 作者 | 发布时间 | 点赞数 | 评论数 | 收藏数 |
|---|---|---|---|---|---|---|
| 1 | 标题文字 | 作者名 | 2026-06-30 | 1.2w | 305 | 8.7w |
数字格式化规则：< 10000 用原始数字（如 320）；≥ 10000 用 x.xw 格式（如 1.2w）。标题规则：标题；标题完整展示，严禁截断；标题为空时显示 -；标题中的 | 字符已由脚本自动转义为 |，避免破坏表格列分隔。作者规则：作者名；作者名完整展示；若 author_url 为空则显示纯文本作者名。
A4. 筛选能力提示（紧接在表格之后，每次必须输出）：🔧 支持筛选，回复以下指令可切换条件重新搜索：排序方式：综合排序 / 最新发布 / 最多点赞 / 最多评论 / 最多收藏（当前：{sort_label}）；发布时间：不限 / 一天内 / 一周内 / 一个月内 / 一年内（当前：{note_time_label}）；笔记类型：不限 / 视频笔记 / 普通笔记（当前：{note_type_label}）。示例：「按最新发布、一周内、视频笔记重新搜索」
A5. 翻页提示（紧接在 A4 之后，不可省略，每次必须输出）：若 has_next 为 true：📄 当前第 {page} 页。回复「下一页」继续查看。若 has_next 为 false（当前页不足 20 条或为空，已是最后一页）：📄 当前第 {page} 页，已无更多数据。A1~A5 缺一不可，必须在同一轮输出中连续完成。输出 A5 后紧跟 Step 4 订阅提示。
情况 B：articles 数量 = 0（无匹配结果）
B1. 抱歉提示 + 调整建议：😔 抱歉，未找到与「XXX」相关的小红书笔记。💡 建议尝试：更换更短或更宽泛的关键词、扩大时间范围、切换笔记类型。
B2. 筛选能力提示（紧接在 B1 之后，每次必须输出，格式同 A3）。B1~B2 必须在同一轮输出中连续完成，输出 B2 后紧跟 Step 4 订阅提示。
Step 4：提示订阅
全部内容展示完毕后，不等待、立刻结束输出，仅在末尾附上订阅提示：📩 是否订阅「XXX」的每日推送？订阅后每天 09:00 自动推送最新作品。回复「确认订阅」即可创建定时任务。
Step 5：创建定时任务（用户回复「确认订阅」时执行）
优先使用平台内置定时任务能力，若无则提供通用方案。
平台内置定时任务（优先）：任务名称：小红书最新热门笔记订阅 - <关键词>；执行频率：每天 09:00（cron：0 9 * * *）；执行内容：运行脚本并将结果按 Step 3~4 格式展示推送到当前对话。
通用配置方案（Linux/macOS crontab）：
0 9 * * * python3 ~/.agents/skills/xiaohongshu-realtime-search/scripts/search_xhs_work.py "<关键词>"
创建成功后告知用户："已成功订阅关键词「<关键词>」的小红书作品推送，每天 09:00 将自动查询最新数据并通知你。"
其他说明：本工具需先获取并配置 API Key 才能使用；受小红书风控规则限制，部分作品链接可能无法正常跳转。其余细节资料暂未提供。