headless-intelligent-search
该技能用于在无头(headless)VTEX 店铺中实现商品搜索、分面导航与自动补全功能。它覆盖 Intelligent Search API 的多个端点,包括商品搜索、分面筛选、自动补全建议、热门搜索、拼写纠正、搜索建议和横幅获取。技能强调若干硬性约束:必须向 Intelligent Search Events API 发送分析事件,否则搜索排名会随时间下降;分页时必须复用首页返回的 operator 和 fuzzy 值,否则结果不一致;Intelligent Search 应直接从前端调用,不应无必要地经 BFF 代理。技能还给出分面组合规则(同类型分面为 OR,不同类型为 AND)、排序参数用法,以及带类型的搜索客户端、分面导航辅助函数和防抖自动补全的实现示例。适用于构建搜索结果页、分面筛选、自动补全输入框以及搜索分析埋点等场景。