# Exa CLI

> 使用 Exa 搜索与代码上下文命令行进行信息检索与编程资料检索。适用于需要从实时网页获取资料、定位权威来源、或查询具体代码示例/库用法的任务（如技术调研、API 使用方式确认、示例代码查找）。

- Skill: `aiskillstore/exa-cli` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aiskillstore/exa-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiskillstore/exa-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: aiskillstore (https://skillmd.com/u/aiskillstore)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/aiskillstore/exa-cli

---


## 使用方式

说明：以下调用方式均以当前 `SKILL.md` 文件所在文件夹为 workdir。必须直接当作可执行文件执行。

- 运行脚本：`scripts/exa-cli.py`
- 网页搜索：`scripts/exa-cli.py web-search-exa <query>`
- 编程检索：`scripts/exa-cli.py get-code-context-exa <query>`

### web-search-exa

说明：实时网页搜索并返回结果与正文片段。  
必填参数：`query`（搜索查询语句）。  
可选参数：  
`--type`：搜索类型（auto/fast/deep）。  
`--livecrawl`：抓取模式（fallback/preferred）。  
`--num-results`：返回结果数量。  
`--context-max-characters`：返回上下文的最大字符数。  
`--endpoint`：服务地址（默认 `https://mcp.exa.ai/mcp`）。  
`--token`：认证令牌，默认读取环境变量。  
`--timeout`：请求超时秒数（默认 30.0）。  
`--cache-ttl`：缓存有效期（秒，默认 3600）。  
`--no-cache`：禁用本地缓存。  
`--json`：以 JSON 输出完整响应。  
`--verbose`：输出调试日志。

### get-code-context-exa

说明：面向编程问题的检索，返回高质量上下文信息。  
必填参数：`query`（上下文检索查询）。  
可选参数：  
`--tokens-num`：返回的 token 数量。  
`--endpoint`：服务地址（默认 `https://mcp.exa.ai/mcp`）。  
`--token`：认证令牌，默认读取环境变量。  
`--timeout`：请求超时秒数（默认 30.0）。  
`--cache-ttl`：缓存有效期（秒，默认 3600）。  
`--no-cache`：禁用本地缓存。  
`--json`：以 JSON 输出完整响应。  
`--verbose`：输出调试日志。

## 参考信息

- [exa-cli.py](scripts/exa-cli.py)