Exa Search

核心用法

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 存在速率限制与偶发故障，生产环境建议设计降级方案

核心用法

Exa Search 是一款基于 Exa AI 搜索 API 的本地 Node.js 脚本工具，提供精准的网页搜索能力。用户通过简单的命令行指令即可发起搜索，获取包含标题、URL、摘要的结构化结果，并可选择获取完整页面文本内容。

基础搜索：node {baseDir}/scripts/exa_search.mjs "<query>" --count 5
获取全文：添加 --text 参数（消耗更多 token）
时间筛选：使用 --start 和 --end 限定时间窗口，如 --start 2025-01-01 --end 2026-02-04

显著优点

1. 零依赖架构：仅使用 Node.js 内置模块，完全规避 npm 供应链攻击风险
2. 结构化输出：返回标准化 JSON 格式，包含 title/url/snippet/text 字段，便于下游处理
3. 成本可控：支持按需获取摘要或全文，灵活控制 API 消耗
4. 时间过滤：内置日期范围筛选，适合学术研究、新闻追踪等时效性场景
5. 安全传输：HTTPS 加密通信，API Key 从环境变量读取，无硬编码泄露风险

潜在局限

• 第三方依赖：搜索结果质量完全依赖 Exa AI 的服务可用性与算法更新
• 隐私外泄：所有搜索查询均发送至 Exa 服务器，敏感信息存在被记录风险
• 配额成本：Exa API 按调用量计费，高频使用可能产生显著费用
• 环境变量风险：API Key 存储于进程环境变量，理论上可被同机特权进程读取
• 功能单一：专注于搜索检索，无结果缓存、重试机制或离线能力

适合人群

• 开发者需要结构化、可编程的搜索数据接口
• 研究人员进行时效性文献或新闻追踪
• 构建 RAG（检索增强生成）系统的 AI 应用开发者
• 对 npm 供应链安全敏感、追求零依赖的技术团队

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 数据外泄 | 搜索内容上传至 Exa 服务器 | 避免搜索个人身份信息、商业机密 |

| API 配额耗尽 | 高频调用导致服务中断或超额计费 | 实施调用频率限制与预算监控 |

| 网络劫持 | 不可信网络中的 HTTPS 中间人攻击 | 仅在内网或可信 Wi-Fi 环境下使用 |

| 凭证泄露 | 环境变量被恶意进程读取 | 使用专用密钥管理服务替代纯环境变量 |