exa-search

核心用法

Exa Search 是一个基于 Exa.ai 搜索 API 的本地 Node.js 脚本工具，专为需要高质量网络搜索数据的用户设计。使用时通过命令行调用 exa_search.mjs 脚本，传入搜索关键词及可选参数即可获取结构化结果。基础命令格式为 node {baseDir}/scripts/exa_search.mjs "<query>" --count 5，支持通过 --text 参数获取完整页面正文（消耗更多 Token），以及通过 --start 和 --end 参数限定时间范围（格式：YYYY-MM-DD）。该技能不会修改系统默认搜索引擎，而是作为 Exa 专属搜索通道独立运行。

显著优点

结构化数据输出：不同于传统搜索，Exa 返回包含标题、URL、摘要乃至完整正文的结构化 JSON 数据，便于程序化处理和知识抽取。代码安全可靠：通过 BSS A 级安全认证，使用 Node.js 原生 fetch API，无 eval() 或 exec() 等危险函数，无动态代码加载。输入边界完备：对 --count 参数限制 1-25 范围，日期参数通过正则表达式严格校验格式，有效防止注入攻击。零外部依赖：除 Node.js 运行时外，无需安装额外 npm 包，部署轻量。权限最小化：仅需 EXA_API_KEY 环境变量和 node 二进制文件，与功能完全匹配。

潜在缺点与局限性

来源可信度限制：该 Skill 来自 GitHub 社区项目（T3 级来源），非知名企业或官方维护，长期维护稳定性存疑。第三方服务依赖：完全依赖 Exa API 的可用性和响应速度，若 Exa 服务故障或网络中断，功能将不可用。成本考量：虽然 Skill 本身免费，但 Exa API 按调用量收费，且获取页面全文（--text 模式）消耗更多 Token。数据隐私边界：所有搜索查询均需发送至 Exa 服务器处理，不适合搜索高度敏感或机密信息。功能单一性：仅提供搜索功能，无结果缓存、去重或二次处理机制。

适合的目标群体

AI 开发者与研究者：需要为 RAG（检索增强生成）系统获取高质量网页内容的工程师。内容创作者与记者：进行背景调查、资料收集，需要精准信源和发布时间筛选。数据分析师：需要批量获取结构化网络数据进行文本分析或趋势研究。产品经理与竞品分析师：监控特定网站或话题的最新动态，利用时间窗口功能追踪信息时效性。

使用风险与注意事项

数据隐私风险：用户输入的搜索关键词将明文传输至 Exa 服务器（api.exa.ai），尽管使用 HTTPS 加密，但仍需避免搜索包含个人隐私、商业机密或受监管的信息。API 密钥管理：需在 Gateway 环境或 ~/.openclaw/.env 中配置 EXA_API_KEY，务必确保密钥不泄露到版本控制或日志中。网络与性能依赖：搜索延迟取决于 Exa API 响应时间和网络状况，无本地缓存机制，高频调用可能触发速率限制。结果可信度：搜索结果来自互联网，Skill 本身不对内容真实性负责，使用时需自行验证来源权威性。