将 AI 助手与 Exa 的搜索功能连接起来:网络搜索、代码搜索和企业研究。
完整文档 | npm 包 | 获取您的 Exa API 密钥
连接到 Exa 托管的 MCP 服务器:
https://mcp.exa.ai/mcp
{
"mcpServers": {
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
}
{
"servers": {
"exa": {
"type": "http",
"url": "https://mcp.exa.ai/mcp"
}
}
}
claude mcp add --transport http exa https://mcp.exa.ai/mcp
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.exa.ai/mcp"]
}
}
}
codex mcp add exa --url https://mcp.exa.ai/mcp
{
"mcp": {
"exa": {
"type": "remote",
"url": "https://mcp.exa.ai/mcp",
"enabled": true
}
}
}
https://mcp.exa.ai/mcp
{
"mcpServers": {
"exa": {
"serverUrl": "https://mcp.exa.ai/mcp"
}
}
}
{
"context_servers": {
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
}
{
"mcpServers": {
"exa": {
"httpUrl": "https://mcp.exa.ai/mcp"
}
}
}
https://mcp.exa.ai/mcp
{
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
{
"mcpServers": {
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
}
{
"mcpServers": {
"exa": {
"type": "streamable-http",
"url": "https://mcp.exa.ai/mcp"
}
}
}
{
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
Exa 的工具将出现在聊天中。让您的模型搜索网页、获取页面或研究主题。
{
"mcpServers": {
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
}
对于需要 mcp-remote 的客户端:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.exa.ai/mcp"]
}
}
}
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["-y", "exa-mcp-server"],
"env": {
"EXA_API_KEY": "your_api_key"
}
}
}
}
默认启用:
| 工具 | 描述 |
| ---- | ----------- |
| web_search_exa | 搜索任何主题的网络内容,获取清晰、可直接使用的信息 |
| web_fetch_exa | 从已知 URL 获取特定网页的完整内容 |
默认禁用:
| 工具 | 描述 |
| ---- | ----------- |
| web_search_advanced_exa | 高级网络搜索,完全控制过滤器、域名、日期和内容选项 |
Exa 代理 工具(可选,需要 OAuth 或 API 密钥):
| 工具 | 描述 |
| ---- | ----------- |
| agent_run | 运行一个 Exa 代理,用于多步骤研究、列表构建、信息丰富或结构化输出 |
使用 tools 参数启用更多工具:
https://mcp.exa.ai/mcp?exaApiKey=YOUR_KEY&tools=web_search_exa,web_search_advanced_exa,web_fetch_exa
如果您想使用 Exa Agent,请按如下方式启用可选工具集:
https://mcp.exa.ai/mcp?tools=agent_tools
如果您想同时启用搜索和 Exa Agent 工具:
https://mcp.exa.ai/mcp?tools=web_search_exa,web_fetch_exa,agent_tools
要强制进行 OAuth 握手,以便用户使用自己的 Exa 帐户登录(对于共享的连接器、技能和插件很有用),请添加 login 参数:
https://mcp.exa.ai/mcp?login
或使用 /mcp/oauth 端点:
https://mcp.exa.ai/mcp/oauth
两者都可以与 tools 参数结合使用:
https://mcp.exa.ai/mcp?tools=web_search_exa,web_fetch_exa,agent_tools&login
https://mcp.exa.ai/mcp/oauth?tools=web_search_exa,web_fetch_exa,agent_tools
为 Claude Code 准备的即用型技能。每个技能都教授 Claude 如何使用 Exa 搜索执行特定任务。复制下拉菜单中的内容并将其粘贴到 Claude Code 中 — 其余工作由它处理。
第 1 步:安装或更新 Exa MCP
如果 Exa MCP 已存在于您的 MCP 配置中,请先卸载它并安装新的,或使用此端点更新您现有的 MCP 配置。在终端中运行此命令:
claude mcp add --transport http exa "https://mcp.exa.ai/mcp?tools=web_search_advanced_exa"
第 2 步:添加此 Claude 技能
---
name: company-research
description: 使用 Exa 搜索进行企业研究。查找公司信息、竞争对手、新闻、财务数据、LinkedIn 个人资料、构建公司列表。在研究公司、进行竞争对手分析、市场调研或构建公司列表时使用。
context: fork
---
# 企业研究
## 工具限制(关键)
仅使用 `web_search_advanced_exa`。不要使用 `web_search_exa` 或任何其他 Exa 工具。
## Token 隔离(关键)
切勿在主上下文中运行 Exa 搜索。始终生成任务代理:
- 代理在内部运行 Exa 搜索
- 代理使用 LLM 智能处理结果
- 代理仅返回提炼后的输出(紧凑的 JSON 或简短的 markdown)
- 无论搜索量多大,主上下文都保持干净
## 动态调优
不要硬编码 numResults。根据用户意图调优:
- 用户说“少数几个”→ 10-20
- 用户说“全面”→ 50-100
- 用户指定数量→ 匹配它
- 模棱两可?询问:“您想要多少家公司?”
## 查询变体
Exa 为不同的措辞返回不同的结果。为了覆盖范围:
- 生成 2-3 个查询变体
- 并行运行
- 合并并去重
## 类别
根据您的需要使用适当的 Exa `category`:
- `company` → 首页,丰富的元数据(员工人数、地点、融资、收入)
- `news` → 新闻报道、公告
- `people` → LinkedIn 个人资料(公共数据)
- 无类别(`type: "auto"`)→ 一般的网络结果,深入探讨,更广泛的背景
从 `category: "company"` 开始进行发现,然后使用其他类别或不使用类别进行更深入的研究。
### 类别特定的过滤器限制
使用 `category: "company"` 时,以下参数会导致 400 错误:
- `includeDomains` / `excludeDomains`
- `startPublishedDate` / `endPublishedDate`
- `startCrawlDate` / `endCrawlDate`
在没有类别(或使用 `news`)进行搜索时,域名和日期过滤器可以正常工作。
**通用限制:** `includeText` 和 `excludeText` 仅支持**单项数组**。所有类别中的多项数组都会导致 400 错误。
## LinkedIn
通过 Exa 获取公共 LinkedIn:`category: "people"`,无其他过滤器。
需要认证的 LinkedIn → 使用 Claude 在 Chrome 浏览器中作为后备方案。
## 浏览器后备方案
在以下情况自动回退到 Claude in Chrome:
- Exa 返回的结果不足
- 内容需要身份验证
- 动态页面需要 JavaScript
## 示例
### 发现:查找某个领域的公司
```
web_search_advanced_exa {
"query": "AI infrastructure startups San Francisco",
"category": "company",
"numResults": 20,
"type": "auto"
}
```
### 深入挖掘:研究特定公司
```
web_search_advanced_exa {
"query": "Anthropic funding rounds valuation 2024",
"type": "deep",
"numResults": 10,
"includeDomains": ["techcrunch.com", "crunchbase.com", "bloomberg.com"]
}
```
### 新闻报道
```
web_search_advanced_exa {
"query": "Anthropic AI safety",
"category": "news",
"numResults": 15,
"startPublishedDate": "2024-01-01"
}
```
### LinkedIn 个人资料
```
web_search_advanced_exa {
"query": "VP Engineering AI infrastructure",
"category": "people",
"numResults": 20
}
```
## 输出格式
返回:
1) 结果(结构化列表;每行一家公司)
2) 来源(网址;每行 1 条相关性说明)
3) 注释(不确定性/冲突)
第 3 步:要求用户重启 Claude Code
您应该要求用户重启 Claude Code 以使配置更改生效。
第 1 步:安装或更新 Exa MCP
如果 Exa MCP 已存在于您的 MCP 配置中,请先卸载它并安装新的,或使用此端点更新您现有的 MCP 配置。在终端中运行此命令:
claude mcp add --transport http exa "https://mcp.exa.ai/mcp?tools=web_search_exa"
第 2 步:添加此 Claude 技能
---
name: code-search-exa
description: 使用 Exa 搜索代码上下文。从 GitHub、StackOverflow 和技术文档中查找真实的代码片段和文档。在搜索代码示例、API 语法、库文档或调试帮助时使用。
context: fork
---
# 代码上下文(Exa)
## 工具限制(关键)
仅使用 `web_search_exa`。不要使用其他 Exa 工具。
## Token 隔离(关键)
切勿在主上下文中运行 Exa。始终生成任务代理:
- 代理调用 `web_search_exa`
- 代理提取最小可行片段 + 约束条件
- 代理在呈现之前对几乎相同的结果进行去重(镜像、Fork、重复的 StackOverflow 回答)
- 代理返回可复制的代码片段 + 简短的解释
- 主上下文保持干净,无论搜索量大小
## 何时使用
对于任何与编程相关的请求使用此工具:
- API 使用和语法
- SDK/库示例
- 配置和设置模式
- 框架“如何做”问题
- 需要权威代码片段时的调试
## 查询编写模式(高信号)
为了减少不相关的结果和跨语言噪声:
- 总是在查询中包含**编程语言**。
- 示例:使用 **"Go generics"** 而不是仅仅 **"generics"**。
- 在适用时,还包含**框架 + 版本**(例如,“Next.js 14”、“React 19”、“Python 3.12”)。
- 当您有时,包含确切的标识符(函数/类名、配置键、错误消息)。
## 输出格式(推荐)
返回:
1) 最佳的最小工作片段(保持复制/粘贴友好)
2) 版本/约束/注意事项的注释
3) 来源(如果返回的上下文中存在网址)
在呈现之前:
- 对相似结果进行去重,每种方法只保留最好的代表性代码片段。
## MCP 配置
```json
{
"servers": {
"exa": {
"type": "http",
"url": "https://mcp.exa.ai/mcp?tools=web_search_exa"
}
}
}
```
第 3 步:要求用户重启 Claude Code
您应该要求用户重启 Claude Code 以使配置更改生效。
第 1 步:安装或更新 Exa MCP
如果 Exa MCP 已存在于您的 MCP 配置中,请先卸载它并安装新的,或使用此端点更新您现有的 MCP 配置。在终端中运行此命令:
claude mcp add --transport http exa "https://mcp.exa.ai/mcp?tools=web_search_advanced_exa"
第 2 步:添加此 Claude 技能
---
name: people-research
description: 使用 Exa 搜索进行人物研究。在网络上查找 LinkedIn 个人资料、专业背景、专家、团队成员和公开简介。在搜索人物、寻找专家或查找专业资料时使用。
context: fork
---
# 人物研究
## 工具限制(关键)
仅使用 `web_search_advanced_exa`。不要使用 `web_search_exa` 或任何其他 Exa 工具。
## Token 隔离(关键)
切勿在主上下文中运行 Exa 搜索。始终生成任务代理:
- 代理在内部运行 Exa 搜索
- 代理使用 LLM 智能处理结果
- 代理仅返回提炼后的输出(紧凑的 JSON 或简短的 markdown)
- 主上下文保持干净,无论搜索量大小
## 动态调优
不要硬编码 numResults。根据用户意图调优:
- 用户说“少数几个”→ 10-20
- 用户说“全面”→ 50-100
- 用户指定数量→ 匹配它
- 模棱两可?询问:“您想要多少个资料?”
## 查询变体
Exa 为不同的措辞返回不同的结果。为了覆盖范围:
- 生成 2-3 个查询变体
- 并行运行
- 合并并去重
## 类别
根据您的需要使用适当的 Exa `category`:
- `people` → LinkedIn 个人资料、公开简介(主要用于发现)
- `personal site` → 个人博客、作品集网站、关于页面
- `news` → 新闻提及、采访、演讲者简介
- 无类别(`type: "auto"`)→ 一般的网络结果,更广泛的背景
从 `category: "people"` 开始进行资料发现,然后使用其他类别或不使用类别对特定个人进行更深入的研究。
### 类别特定的过滤器限制
使用 `category: "people"` 时,以下参数会导致错误:
- `startPublishedDate` / `endPublishedDate`
- `startCrawlDate` / `endCrawlDate`
- `includeText` / `excludeText`
- `excludeDomains`
- `includeDomains` — **仅限 LinkedIn 域名**(例如,“linkedin.com”)
在没有类别进行搜索时,所有参数都可用(但 `includeText`/`excludeText` 仍然只支持单项数组)。
## LinkedIn
通过 Exa 获取公共 LinkedIn:`category: "people"`,无其他过滤器。
需要认证的 LinkedIn → 使用 Claude 在 Chrome 浏览器中作为后备方案。
## 浏览器后备方案
在以下情况自动回退到 Claude in Chrome:
- Exa 返回的结果不足
- 内容需要身份验证
- 动态页面需要 JavaScript
## 示例
### 发现:按角色查找人员
```
web_search_advanced_exa {
"query": "VP Engineering AI infrastructure",
"category": "people",
"numResults": 20,
"type": "auto"
}
```
### 使用查询变体
```
web_search_advanced_exa {
"query": "machine learning engineer San Francisco",
"category": "people",
"additionalQueries": ["ML engineer SF", "AI engineer Bay Area"],
"numResults": 25,
"type": "deep"
}
```
### 深入挖掘:研究特定人员
```
web_search_advanced_exa {
"query": "Dario Amodei Anthropic CEO background",
"type": "auto",
"numResults": 15
}
```
### 新闻提及
```
web_search_advanced_exa {
"query": "Dario Amodei interview",
"category": "news",
"numResults": 10,
"startPublishedDate": "2024-01-01"
}
```
## 输出格式
返回:
1) 结果(姓名、职位、公司、地点(如果可用))
2) 来源(资料网址)
3) 注释(资料完整性、验证状态)
第 3 步:要求用户重启 Claude Code
您应该要求用户重启 Claude Code 以使配置更改生效。
第 1 步:安装或更新 Exa MCP
如果 Exa MCP 已存在于您的 MCP 配置中,请先卸载它并安装新的,或使用此端点更新您现有的 MCP 配置。在终端中运行此命令:
claude mcp add --transport http exa "https://mcp.exa.ai/mcp?tools=web_search_advanced_exa"
第 2 步:添加此 Claude 技能
---
name: web-search-advanced-financial-report
description: 使用 Exa 高级搜索搜索财务报告。近乎完整的过滤器支持,用于查找 SEC 文件、收益报告和财务文档。在搜索 10-K 文件、季度收益或年度报告时使用。
context: fork
---
# 网络搜索高级 - 财务报告类别
## 工具限制(关键)
仅使用 `web_search_advanced_exa` 并设置 `category: "financial report"`。不要使用其他类别或工具。
## 过滤器限制(关键)
`financial report` 类别有一个已知限制:
- `excludeText` - 不支持(导致 400 错误)
## 支持的参数
### 核心参数
- `query`(必需)
- `numResults`
- `type`(“auto”、“fast”、“deep”、“instant”)
### 域名过滤
- `includeDomains`(例如,[“sec.gov”,“investor.apple.com”])
- `excludeDomains`
### 日期过滤(ISO 8601)- 对财务报告非常有用!
- `startPublishedDate` / `endPublishedDate`
- `startCrawlDate` / `endCrawlDate`
### 文本过滤
- `includeText`(必须包含所有)- 仅支持**单项数组**;多项会导致 400
- ~~`excludeText`~~ - 不支持
### 内容提取
- `textMaxCharacters` / `contextMaxCharacters`
- `enableSummary` / `summaryQuery`
- `enableHighlights` / `highlightsNumSentences` / `highlightsPerUrl` / `highlightsQuery`
### 其他
- `additionalQueries`
- `maxAgeHours` / `livecrawlTimeout`
- `subpages` / `subpageTarget`
## Token 隔离(关键)
切勿在主上下文中运行 Exa 搜索。始终生成任务代理:
- 代理调用 `web_search_advanced_exa` 并设置 `category: "financial report"`
- 代理在呈现之前合并 + 去重结果
- 代理返回提炼后的输出(简短的 markdown 或紧凑的 JSON)
- 主上下文保持干净,无论搜索量大小
## 何时使用
当您需要以下内容时使用此类别:
- SEC 文件(10-K、10-Q、8-K、S-1)
- 季度收益报告
- 年度报告
- 投资者演示文稿
- 财务报表
## 示例
公司的 SEC 文件:
```
web_search_advanced_exa {
"query": "Anthropic SEC filing S-1",
"category": "financial report",
"numResults": 10,
"type": "auto"
}
```
最近的收益报告:
```
web_search_advanced_exa {
"query": "Q4 2025 earnings report technology",
"category": "financial report",
"startPublishedDate": "2025-10-01",
"numResults": 20,
"type": "auto"
}
```
特定文件类型:
```
web_search_advanced_exa {
"query": "10-K annual report AI companies",
"category": "financial report",
"includeDomains": ["sec.gov"],
"startPublishedDate": "2025-01-01",
"numResults": 15,
"type": "deep"
}
```
风险因素分析:
```
web_search_advanced_exa {
"query": "risk factors cybersecurity",
"category": "financial report",
"includeText": ["cybersecurity"],
"numResults": 10,
"enableHighlights": true,
"highlightsQuery": "What are the main cybersecurity risks?"
}
```
## 输出格式
返回:
1) 结果(公司名称、文件类型、日期、关键数据/要点)
2) 来源(文件网址)
3) 注释(报告期、任何重述、审计员注释)
第 3 步:要求用户重启 Claude Code
您应该要求用户重启 Claude Code 以使配置更改生效。
第 1 步:安装或更新 Exa MCP
如果 Exa MCP 已存在于您的 MCP 配置中,请先卸载它并安装新的,或使用此端点更新您现有的 MCP 配置。在终端中运行此命令:
claude mcp add --transport http exa "https://mcp.exa.ai/mcp?tools=web_search_advanced_exa"
第 2 步:添加此 Claude 技能
---
name: web-search-advanced-research-paper
description: 使用 Exa 高级搜索搜索研究论文和学术内容。支持完整的过滤器,包括日期范围和文本过滤。在搜索学术论文、arXiv 预印本或科学研究时使用。
context: fork
---
# 网络搜索高级 - 研究论文类别
## 工具限制(关键)
仅使用 `web_search_advanced_exa` 并设置 `category: "research paper"`。不要使用其他类别或工具。
## 完整的过滤器支持
`research paper` 类别支持所有可用参数:
### 核心参数
- `query`(必需)
- `numResults`
- `type`(“auto”、“fast”、“deep”、“instant”)
### 域名过滤
- `includeDomains`(例如,[“arxiv.org”,“openreview.net”])
- `excludeDomains`
### 日期过滤(ISO 8601)
- `startPublishedDate` / `endPublishedDate`
- `startCrawlDate` / `endCrawlDate`
### 文本过滤
- `includeText`(必须包含所有)
- `excludeText`(如果任何匹配则排除)
**数组大小限制:** `includeText` 和 `excludeText` 仅支持**单项数组**。多项数组(2 个以上项目)会导致 400 错误。要匹配多个术语,请将它们放在 `query` 字符串中或运行单独的搜索。
### 内容提取
- `textMaxCharacters` / `contextMaxCharacters`
- `enableSummary` / `summaryQuery`
- `enableHighlights` / `highlightsNumSentences` / `highlightsPerUrl` / `highlightsQuery`
### 其他
- `userLocation`
- `moderation`
- `additionalQueries`
- `maxAgeHours` / `livecrawlTimeout`
- `subpages` / `subpageTarget`
## Token 隔离(关键)
切勿在主上下文中运行 Exa 搜索。始终生成任务代理:
- 代理调用 `web_search_advanced_exa` 并设置 `category: "research paper"`
- 代理在呈现之前合并 + 去重结果
- 代理返回提炼后的输出(简短的 markdown 或紧凑的 JSON)
- 主上下文保持干净,无论搜索量大小
## 何时使用
当您需要以下内容时使用此类别:
- 来自 arXiv、OpenReview、PubMed 等的学术论文
- 关于特定主题的科学研究
- 带有日期过滤的文献综述
- 包含特定方法论或术语的论文
## 示例
关于某个主题的近期论文:
```
web_search_advanced_exa {
"query": "transformer attention mechanisms efficiency",
"category": "research paper",
"startPublishedDate": "2024-01-01",
"numResults": 15,
"type": "auto"
}
```
来自特定场所的论文:
```
web_search_advanced_exa {
"query": "large language model agents",
"category": "research paper",
"includeDomains": ["arxiv.org", "openreview.net"],
"includeText": ["LLM"],
"numResults": 20,
"type": "deep"
}
```
## 输出格式
返回:
1) 结果(带有标题、作者、日期、摘要总结的结构化列表)
2) 来源(带有发表场所的网址)
3) 注释(方法论差异、相互矛盾的发现)
第 3 步:要求用户重启 Claude Code
您应该要求用户重启 Claude Code 以使配置更改生效。
第 1 步:安装或更新 Exa MCP
如果 Exa MCP 已存在于您的 MCP 配置中,请先卸载它并安装新的,或使用此端点更新您现有的 MCP 配置。在终端中运行此命令:
claude mcp add --transport http exa "https://mcp.exa.ai/mcp?tools=web_search_advanced_exa"
第 2 步:添加此 Claude 技能
---
name: web-search-advanced-personal-site
description: 使用 Exa 高级搜索搜索个人网站和博客。支持完整的过滤器,用于查找个人观点、作品集和个人博客。在搜索个人网站、博客文章或作品集网站时使用。
context: fork
---
# 网络搜索高级 - 个人网站类别
## 工具限制(关键)
仅使用 `web_search_advanced_exa` 并设置 `category: "personal site"`。不要使用其他类别或工具。
## 完整的过滤器支持
`personal site` 类别支持所有可用参数:
### 核心参数
- `query`(必需)
- `numResults`
- `type`(“auto”、“fast”、“deep”、“instant”)
### 域名过滤
- `includeDomains`
- `excludeDomains`(例如,如果您想要独立博客,则排除 Medium)
### 日期过滤(ISO 8601)
- `startPublishedDate` / `endPublishedDate`
- `startCrawlDate` / `endCrawlDate`
### 文本过滤
- `includeText`(必须包含所有)
- `excludeText`(如果任何匹配则排除)
**数组大小限制:** `includeText` 和 `excludeText` 仅支持**单项数组**。多项数组(2 个以上项目)会导致 400 错误。要匹配多个术语,请将它们放在 `query` 字符串中或运行单独的搜索。
### 内容提取
- `textMaxCharacters` / `contextMaxCharacters`
- `enableSummary` / `summaryQuery`
- `enableHighlights` / `highlightsNumSentences` / `highlightsPerUrl` / `highlightsQuery`
### 其他
- `additionalQueries`
- `maxAgeHours` / `livecrawlTimeout`
- `subpages` / `subpageTarget` - 对探索作品集网站很有用
## Token 隔离(关键)
切勿在主上下文中运行 Exa 搜索。始终生成任务代理:
- 代理调用 `web_search_advanced_exa` 并设置 `category: "personal site"`
- 代理在呈现之前合并 + 去重结果
- 代理返回提炼后的输出(简短的 markdown 或紧凑的 JSON)
- 主上下文保持干净,无论搜索量大小
## 何时使用
当您需要以下内容时使用此类别:
- 个人专家意见和经历
- 关于技术主题的个人博客文章
- 作品集网站
- 独立分析(非企业内容)
- 来自从业者的深入探讨和教程
## 示例
技术博客文章:
```
web_search_advanced_exa {
"query": "building production LLM applications lessons learned",
"category": "personal site",
"numResults": 15,
"type": "deep",
"enableSummary": true
}
```
关于某个主题的近期文章:
```
web_search_advanced_exa {
"query": "Rust async runtime comparison",
"category": "personal site",
"startPublishedDate": "2025-01-01",
"numResults": 10,
"type": "auto"
}
```
排除聚合器:
```
web_search_advanced_exa {
"query": "startup founder lessons",
"category": "personal site",
"excludeDomains": ["medium.com", "substack.com"],
"numResults": 15,
"type": "auto"
}
```
## 输出格式
返回:
1) 结果(标题、作者/网站名称、日期、关键见解)
2) 来源(网址)
3) 注释(作者专业知识、潜在偏见、覆盖深度)
第 3 步:要求用户重启 Claude Code
您应该要求用户重启 Claude Code 以使配置更改生效。