用途
小红书热门笔记搜索工具，用于按关键词检索小红书平台上的热门爆款笔记，帮助创作者、品牌方和MCN机构发现热门趋势、获取创作灵感。工具仅在主Agent中执行，不派发给子Agent。
主要能力
- 关键词搜索：支持精确关键词、逗号分隔的多关键词组合，以及空关键词查询全站热门。
- 三维评分排序：有关键词时按相关性（满分10分）、热度（满分3分）、时效（满分2分）加权计算总分（满分15分）；全站热门按互动数排序。
- 意图理解与泛化词拓展：优先提取细分方向词，识别泛化词后推荐10个细分方向，等待用户回复「拓展」或「不拓展」后再执行。
- 时间范围：默认最近7天，数据不足时自动按1天→3天→7天→30天扩展；数据库仅包含昨天至30天前的数据，每日早上7点更新昨日数据。
- 结果展示：分页展示，结果超过10条时先展示前10条并询问是否查看全部；结果不足或为零时推荐近期热门笔记与拓词。
- 细分赛道引导：每次查询后推荐10个相关细分方向。
- 定时订阅：可通过calendar_create工具创建定期推送任务。
- HTML报告：脚本自动生成{keyword}_热门数据.html可视化文件。
- 数据说明：热门笔记收录标准为互动数1000以上，互动数据截止为入库时间，非实时数据。
使用方式
- 获取API Key：前往红狐hub获取REDFOX_API_KEY。
- 配置环境变量：可将REDFOX_API_KEY添加到~/.openclaw/openclaw.json的env字段，或在终端执行export REDFOX_API_KEY="ak_xxxx..."。
- 依赖：使用Python 3标准库，无需额外安装第三方依赖，确保系统已安装Python 3.x。
- 调用脚本：
- 关键词搜索：python scripts/fetch_xhs_hot_articles.py --keyword <关键词> --start-date <日期>
- 全站热门：python scripts/fetch_xhs_hot_articles.py --keyword "" --start-date <日期>
- 多关键词：python scripts/fetch_xhs_hot_articles.py --keyword "词1,词2,词3" --start-date <日期>
- 分页参数：--page-num 1 --page-size 50
- 脚本返回结构化JSON，并按内置展示策略输出Markdown表格；同时生成HTML报告。
- 查询完成后可询问用户是否订阅当前搜索条件，选择订阅时使用calendar_create创建定期提醒。
适用场景
- 小红书博主寻找选题灵感：输入细分关键词获取高评分热门笔记及细分方向推荐。
- 品牌方市场调研：输入泛化词后选择拓展，批量搜索多个细分方向，了解赛道热度分布。
- MCN机构内容规划：使用逗号分隔多关键词进行跨领域查询。
- 每日热门笔记定时推送：订阅当前搜索条件，定时接收最新热门笔记。
限制
- 仅在主Agent中执行，不派发给子Agent。
- 热门笔记收录标准为互动数1000以上；数据范围仅昨天至30天前，每日早上7点更新昨日数据，当天数据暂未提供。
- 识别到泛化词时必须先输出细分词推荐并等待用户回复，不得直接调用脚本。
- 数据不足时只允许扩展时间范围，不得更换关键词。
- 需要有效的REDFOX_API_KEY，未配置或过期时脚本会报错。
- 展示格式、字段顺序、评分字段有无等均有严格规定，需按文档执行。
项目结构
- SKILL.md：Skill定义与使用文档。
- scripts/fetch_xhs_hot_articles.py：核心搜索脚本，调用红狐API获取数据并生成HTML报告。
- references/xhs_hot_article_format.md：数据字段格式参考文档。
常见问题
- 依赖：Python 3标准库，无需第三方依赖。
- API Key获取：访问红狐hub注册获取，按安装章节配置。
- 数据为空：可能因关键词太小众或时间范围太短，系统会自动扩展时间范围，也可使用relatedSearches推荐词重试。
- 脚本报错：常见原因为REDFOX_API_KEY未配置或过期、Python版本低于3.x、网络连接问题。
- 数据版权：数据来源于红狐API收录的小红书公开笔记，版权归原作者所有，仅供学习和内容创作参考。