Exa MCP Server API参考大全：完整接口文档与使用示例

【免费下载链接】exa-mcp-server Claude can perform Web Search | Exa with MCP (Model Context Protocol) 项目地址: https://gitcode.com/GitHub_Trending/ex/exa-mcp-server

概述

Exa MCP Server是一个基于Model Context Protocol（MCP，模型上下文协议）的AI搜索服务器，为Claude等AI助手提供实时网络搜索能力。本文将全面介绍Exa MCP Server的API接口、功能特性、配置方法和使用示例。

核心功能模块

1. Web搜索工具 (web_search_exa)

功能描述：执行实时网络搜索，返回优化结果和内容提取。

请求参数：

interface SearchArgs {
  query: string;          // 搜索查询字符串
  numResults?: number;    // 返回结果数量（默认：5）
  livecrawl?: 'always' | 'fallback' | 'preferred'; // 实时抓取模式
}

API端点：POST /search

请求示例：

{
  "query": "人工智能发展趋势",
  "type": "auto",
  "numResults": 5,
  "contents": {
    "text": {
      "maxCharacters": 3000
    },
    "livecrawl": "preferred"
  }
}

2. 内容抓取工具 (crawling_exa)

功能描述：从特定URL提取完整文本内容、元数据和结构化信息。

请求参数：

interface CrawlArgs {
  url: string;            // 要抓取的URL
  maxCharacters?: number; // 最大提取字符数（默认：3000）
}

API端点：POST /contents

请求示例：

{
  "ids": ["https://example.com/article"],
  "contents": {
    "text": {
      "maxCharacters": 5000
    },
    "livecrawl": "preferred"
  }
}

3. 企业研究工具 (company_research_exa)

功能描述：提供企业全面信息研究，包括运营、新闻、财务和行业分析。

请求参数：

interface CompanyResearchArgs {
  companyName: string;    // 企业名称
  numResults?: number;    // 返回结果数量（默认：5）
}

搜索域名白名单：

• bloomberg.com
• reuters.com
• crunchbase.com
• sec.gov
• linkedin.com
• forbes.com
• businesswire.com
• prnewswire.com

4. LinkedIn搜索工具 (linkedin_search_exa)

功能描述：使用Exa AI搜索LinkedIn上的企业和人员信息。

请求参数：

interface LinkedInSearchArgs {
  query: string;          // 搜索查询（公司名、人名或LinkedIn URL）
  numResults?: number;    // 返回结果数量
}

5. 深度研究工具

5.1 启动深度研究 (deep_researcher_start)

功能描述：启动智能AI研究员处理复杂问题。

请求参数：

interface DeepResearchRequest {
  model: 'exa-research' | 'exa-research-pro'; // 研究模型
  instructions: string;                        // 研究指令
  output?: {
    inferSchema?: boolean;                     // 是否推断输出模式
  };
}

5.2 检查研究状态 (deep_researcher_check)

功能描述：检查研究任务状态并获取结果。

响应结构：

interface DeepResearchCheckResponse {
  id: string;
  status: 'running' | 'completed' | 'failed';
  instructions: string;
  data?: {
    report?: string;
    [key: string]: any;
  };
  citations?: {
    [key: string]: Array<{
      id: string;
      url: string;
      title: string;
      snippet: string;
    }>;
  };
}

配置参数

环境变量配置

# 必需配置
EXA_API_KEY=your-exa-api-key-here

# 可选配置
EXA_BASE_URL=https://api.exa.ai  # API基础URL
EXA_TIMEOUT=25000                # 请求超时时间（毫秒）

Claude Desktop配置

本地运行配置：

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": ["-y", "exa-mcp-server"],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

远程MCP服务器配置：

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.exa.ai/mcp?exaApiKey=your-exa-api-key"
      ]
    }
  }
}

API响应格式

搜索响应结构

interface ExaSearchResponse {
  requestId: string;
  autopromptString: string;
  resolvedSearchType: string;
  results: ExaSearchResult[];
}

interface ExaSearchResult {
  id: string;
  title: string;
  url: string;
  publishedDate: string;
  author: string;
  text: string;
  image?: string;
  favicon?: string;
  score?: number;
}

错误响应格式

interface ErrorResponse {
  content: [{
    type: "text";
    text: string;  // 错误消息
  }];
  isError: boolean;
}

使用示例

基础搜索示例

# 使用npx运行
npx exa-mcp-server --tools=web_search_exa

# 启用多个工具
npx exa-mcp-server --tools=web_search_exa,company_research,crawling

代码集成示例

// 在Node.js应用中集成
const { spawn } = require('child_process');

const mcpProcess = spawn('npx', [
  '-y', 
  'exa-mcp-server',
  '--tools=web_search_exa,company_research'
], {
  env: {
    ...process.env,
    EXA_API_KEY: 'your-api-key-here'
  }
});

mcpProcess.stdout.on('data', (data) => {
  console.log(`MCP输出: ${data}`);
});

mcpProcess.stderr.on('data', (data) => {
  console.error(`MCP错误: ${data}`);
});

工具选择配置表

工具名称	功能描述	适用场景	默认启用
web_search_exa	实时网络搜索	通用信息查询	是
company_research_exa	企业信息研究	商业调研	是
crawling_exa	URL内容抓取	特定页面分析	是
linkedin_search_exa	LinkedIn搜索	人脉搜索	是
deep_researcher_start	启动深度研究	复杂问题分析	是
deep_researcher_check	检查研究状态	研究进度跟踪	是

错误处理与调试

常见错误代码

错误代码	描述	解决方案
401	API密钥无效	检查EXA_API_KEY配置
403	权限不足	验证API密钥权限
429	请求频率限制	降低请求频率
500	服务器内部错误	联系Exa技术支持

调试模式启用

# 启用详细日志
DEBUG=exa-mcp-server* npx exa-mcp-server

# 或设置环境变量
export DEBUG=exa-mcp-server*
npx exa-mcp-server

性能优化建议

请求参数优化

// 优化搜索请求
const optimizedRequest = {
  query: "精准搜索关键词",
  numResults: 3,          // 减少结果数量
  contents: {
    text: {
      maxCharacters: 1500  // 限制内容长度
    }
  }
};

连接池配置

对于高并发场景，建议：

1. 连接复用：使用axios实例池
2. 超时设置：合理配置请求超时
3. 重试机制：实现指数退避重试

安全最佳实践

API密钥管理

# 使用环境变量（推荐）
export EXA_API_KEY=your-secure-api-key

# 或使用密钥管理服务
# AWS Secrets Manager, HashiCorp Vault等

网络安全性

• 使用HTTPS加密通信
• 实施请求速率限制
• 定期轮换API密钥
• 监控异常访问模式

版本兼容性

Exa MCP版本	Node.js版本	MCP协议版本	状态
1.x.x	>= 16.0.0	1.0.0	稳定
0.x.x	>= 14.0.0	0.9.0	弃用

总结

Exa MCP Server提供了强大的AI搜索能力集成方案，通过标准化的MCP协议为AI助手赋予实时网络信息获取能力。本文详细介绍了所有API接口的功能特性、参数配置和使用方法，帮助开发者快速集成和优化搜索体验。

关键优势：

• ✅ 实时网络搜索能力
• ✅ 多工具协同工作
• ✅ 标准化MCP协议兼容
• ✅ 企业级安全特性
• ✅ 灵活的配置选项

通过合理配置和优化，Exa MCP Server能够为AI应用提供稳定、高效的网络搜索服务。

【免费下载链接】exa-mcp-server Claude can perform Web Search | Exa with MCP (Model Context Protocol) 项目地址: https://gitcode.com/GitHub_Trending/ex/exa-mcp-server