用途：当用户想找小红书爆款笔记、做小红书搜索、挖选题或看某赛道近期热门内容时使用。核心是把搜索到的公开笔记加工成可落地的选题判断，而非单纯返回列表。
主要能力：依据关键词搜索小红书公开笔记，支持翻页；对结果按互动热度排序、按发布时间取舍，输出爆款笔记表；进一步聚类标题角度、拆解爆款钩子，并给出可直接拍摄的选题清单。对泛化大类词（如“穿搭”）会先推荐细分方向，等用户确认后再搜索。
使用方式：脚本位于 scripts/search_xhs.py，从环境变量 DOUBAOYA_API_KEY 读取密钥，POST 到 doubaoya.com 公开接口，成功后将 data 以 JSON 输出。命令示例：python3 scripts/search_xhs.py "减脂早餐"；翻页：python3 scripts/search_xhs.py "减脂早餐" --page 2。密钥需先到 doubaoya.com 登录后在密钥中心生成，再执行 export DOUBAOYA_API_KEY="dyh_你的密钥"。脚本仅用 Python 3 标准库，无第三方依赖，且仅在主 Agent 中执行。
适用范围与限制：接口只接受 keyword 与 page 两个参数，没有日期入参，时间筛选需依据返回笔记的 publishTime 在加工侧处理；互动数据为采集时刻快照，可能仍在增长；字段可能缺失或命名有差异，需做默认值处理。常见错误包括缺少或无效密钥（401）、参数不合法（400）、额度不足（402）、接口路径错误（404）、上游临时失败（502）和网络错误，其中 502 额度会自动退回可安全重试。若结果为 0 条，建议更换更宽泛关键词或另选细分方向，不应编造数据。密钥不得硬编码或提交到公开仓库，输出中不应回显完整密钥。具体收费与价格资料暂未提供。