exa-full

核心用法

exa-full 是 Exa AI 官方推出的 Claude Code 技能，封装了 Exa 搜索与研究 API 的完整能力。用户可通过环境变量配置 EXA_API_KEY 后，调用多个 Shell 脚本实现不同场景：

• 搜索 ( (search.sh)：支持 auto/neural/fast/deep/instant 五种搜索模式，可按类别（论文、新闻、公司、人物等）、域名、日期范围过滤
• 内容提取 ( (content.sh)：抓取指定 URL 的完整页面内容，支持子页面爬取与实时爬取模式
• 代码搜索 ( (code.sh)：针对编程查询优化，返回代码片段与文档上下文
• 异步研究 ( (research.sh / research_create.sh / research_poll.sh)：创建多步骤研究任务，支持通过 JSON Schema 定义结构化输出，自动轮询直至完成

显著优点

1. 搜索质量分层：五种搜索类型覆盖从即时响应到深度合成的不同需求，Agent 可按场景智能选择
2. 结构化输出：研究任务支持 outputSchema，可直接获取符合预定义格式的 JSON 结果，便于下游处理
3. 安全设计完善：敏感文件上传检查、jq 安全构建 JSON、HTTPS 通信、HTTP 状态码校验等多重防护
4. 来源可信：Exa AI 官方集成，代码托管于维护良好的社区仓库，版本迭代规范

潜在缺点与局限性

• 网络强依赖：所有功能依赖 Exa API 可用性，离线环境无法使用
• 成本考量：Exa API 为商业服务，高频调用可能产生费用
• 异步任务延迟：研究任务需轮询等待，默认最长 240 秒，实时性要求高的场景受限
• 人物/公司搜索限制：此类别不支持排除域名和日期过滤，灵活性降低

适合的目标群体

• 需要高质量网络搜索的研究人员、分析师
• 构建 RAG 系统的开发者，需获取结构化网页内容
• 编程场景下需要代码上下文的技术用户
• 需要自动化多步研究任务的知识工作者

使用风险

• API 密钥泄露风险：需妥善保管 EXA_API_KEY，避免提交至版本控制
• Schema 文件误用：虽已实现敏感文件检查，但用户仍需确保不上传内部机密文档
• 第三方数据暴露：搜索查询与提取内容发送至 Exa 服务器，敏感信息需谨慎处理
• 性能波动：API 响应时间受网络与 Exa 服务端负载影响，极端情况下可能超时

Exa - AI 搜索与研究工具综合评估

核心用法

exa-full 是 Exa AI 搜索服务的官方 Skill 封装，提供四大核心功能：

1. 智能搜索 (`search.sh`)

• 支持多种搜索类型：auto（自动）、neural（语义）、fast（快速）、deep（深度）、instant（实时）
• 可按类别过滤：公司、论文、新闻、推文、个人站点、财报、人物
• 时间范围筛选（SINCE/UNTIL）和域名过滤（DOMAINS/EXCLUDE）
• 智能降级策略：deep → auto → fast → instant

2. 内容提取 (`content.sh`)

• 提取完整网页内容，支持子页面抓取（SUBPAGES）
• 智能高亮关键句子，实时爬取模式可选
• 适合技术文档、API 参考的深度抓取

3. 代码上下文搜索 (`code.sh`)

• 专为编程场景优化的语义搜索
• 快速定位 GitHub 代码、技术文档、Stack Overflow 等开发资源

4. 异步研究任务 (`research.sh` / `research_create.sh` + `research_poll.sh`)

• 支持结构化输出（outputSchema），可定义 JSON 返回格式
• 双模式运行：一次性任务或创建-轮询分离模式
• 适用于复杂调研、竞品分析、信息聚合场景

显著优点

| 维度 | 评价 |

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

| **功能完整性** | 覆盖搜索-提取-研究全流程，API 封装规范 |

| **安全设计** | 敏感文件防护（.env、密钥文件黑名单）、HTTPS 加密传输 |

| **依赖最小化** | 仅依赖 curl/jq，无第三方包，攻击面极小 |

| **参数验证** | 自动处理 CATEGORY 与 EXCLUDE/SINCE/UNTIL 的互斥约束 |

| **灵活配置** | 环境变量驱动，支持 .env 本地配置 |

| **智能降级** | 内置搜索类型自动调整策略，平衡速度与质量 |

潜在缺点与局限性

1. 第三方服务依赖

• 100% 依赖 Exa API 可用性，服务中断则完全不可用
• 需有效 API 密钥（有配额和费用门槛）

2. 数据上传风险

• 用户查询、URL、研究指令均发送至 Exa 服务器
• SCHEMA_FILE 内容完整上传，需确保不含敏感信息

3. 功能边界限制

• CATEGORY=people/company 时无法使用 EXCLUDE/SINCE/UNTIL
• CATEGORY=people 时 DOMAINS 仅限 LinkedIn
• 研究任务默认 240 秒超时，复杂任务可能不足

4. 无本地缓存

• 每次调用均走网络请求，重复查询成本高

适合人群

• 研究人员：快速聚合学术文献、竞品信息、行业报告
• 开发者：代码语义搜索、技术文档抓取、API 参考整理
• 市场分析师：公司调研、新闻追踪、人物背景核查
• 内容创作者：资料收集、事实核查、多源信息整合

常规风险

| 风险项 | 等级 | 说明 |

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

| 查询数据外泄 | 中 | 用户输入发送至第三方 API，需知情同意 |

| API 密钥泄露 | 低 | 环境变量管理规范，但需保护好 .env 文件权限 |

| 敏感文件误传 | 低 | 已防护 .env/密钥文件，但 SCHEMA_FILE 仍需用户自查 |

| 服务不可用 | 低 | Exa 为知名服务商，但仍有依赖风险 |

使用建议：首次使用时向用户确认数据将发送至 Exa；定期检查 API 配额；复杂研究任务适当调高 MAX_WAIT_SECONDS。