核心用法
Exa Search 是一个基于 Exa.ai 搜索 API 的本地 Node.js 脚本工具,提供语义搜索引擎能力。用户可通过命令行执行精确查询,获取包含标题、URL、摘要及可选全文内容的结构化结果。
基础调用
node {baseDir}/scripts/exa_search.mjs "<query>" --count 5高级功能
--text参数获取页面完整文本(消耗更多 token)--start/--end时间窗口过滤,支持日期范围限定- 结果自动解析为 JSON,便于下游处理
配置要求
需在 Gateway 环境或 ~/.openclaw/.env 中设置 EXA_API_KEY。
显著优点
1. 语义搜索质量:Exa 专为 AI 应用设计,相比传统关键词匹配,能理解查询意图,返回相关性更高的结果
2. 结构化输出:标准化 JSON 格式包含标题、URL、摘要、可选全文,减少解析成本
3. 时间过滤灵活:支持精确日期范围筛选,适合时效性强的研究需求
4. 成本可控:按需启用全文提取,基础搜索成本较低
5. 无侵入式设计:作为 web_search 的独立替代方案,不影响现有搜索配置
潜在局限
- API 依赖:完全依赖 Exa 商业服务,需持续付费,免费额度有限
- 地理/语言覆盖:Exa 索引以英文内容为主,中文及小众语言支持可能弱于主流搜索引擎
- Node 环境依赖:要求本地 Node.js 运行时,相比纯 shell 方案环境复杂度更高
- 无内置去重:多个相似结果需自行后处理
适合人群
- AI 应用开发者需要高质量检索增强生成(RAG)数据源
- 学术研究人员追踪特定时段的权威文献
- 市场分析师进行竞品信息搜集与趋势追踪
- 对 Google/Bing 结果质量不满意的深度搜索用户
常规风险
- API 密钥泄露:
EXA_API_KEY需妥善保管,避免提交至代码仓库 - 成本失控:全文提取模式下 token 消耗显著增加,建议先用摘要模式验证查询效果
- 结果权威性:Exa 返回结果仍包含自媒体、论坛等内容,关键决策需人工核实信源
- 服务可用性:第三方 API 存在速率限制与偶发故障,生产环境建议设计降级方案