Exa Websets MCP 服务器

一个模型上下文协议 (MCP) 服务器，将 Exa 的 Websets API 集成到 Claude Desktop、Cursor、Windsurf 以及其他支持 MCP 的客户端中。

什么是 Websets？

Websets 是 Web 实体（公司、人员、研究论文）的集合，可以通过 AI 网络研究自动发现、验证并使用自定义数据进行富集。你可以将其视为由 AI 网络研究驱动的智能、自动更新的电子表格。

核心功能：

• 🔍 自动化搜索：查找符合自然语言标准的实体

• 📊 数据富集：使用 AI 代理提取自定义信息

• 🎯 验证：AI 验证实体是否符合你的标准

• 🔗 Webhooks：集合更新的实时通知

• 📥 导入：将你自己的 CSV 数据导入 Websets 进行富集或范围界定

Related MCP server: Exa Websets MCP Server

可用工具

此 MCP 服务器提供以下工具：

Webset 管理

项目管理

搜索操作

富集操作

Webhooks

导入

事件

安装

通过 Smithery 安装

通过 Smithery 自动安装 Exa Websets：

npx -y @smithery/cli install @exa-labs/websets-mcp-server

前置要求

• Node.js v18 或更高版本

• Claude Desktop、Cursor 或其他支持 MCP 的客户端

• 来自 exa.ai 的 Exa API 密钥

使用 Claude Code（推荐）

设置 Websets MCP 的最快方法：

claude mcp add websets -e EXA_API_KEY=YOUR_API_KEY -- npx -y websets-mcp-server

将 YOUR_API_KEY 替换为你的 Exa API 密钥。

使用 NPX

# Install globally
npm install -g websets-mcp-server

# Or run directly with npx
npx websets-mcp-server

配置

Claude Desktop 配置

1. 启用开发者模式

   • 打开 Claude Desktop

   • 点击菜单 → 启用开发者模式

   • 进入 设置 → 开发者 → 编辑配置

2. 添加到配置文件：

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   Windows: %APPDATA%\Claude\claude_desktop_config.json

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

3. 重启 Claude Desktop

   • 完全退出 Claude Desktop

   • 再次启动

   • 寻找 🔌 图标以验证连接

Cursor 和 Claude Code 配置

使用基于 HTTP 的配置。在 Authorization 请求头中将你的 Exa API 密钥作为 Bearer 令牌传递（或者作为 ?exaApiKey=... 查询参数作为备选）：

{
  "mcpServers": {
    "websets": {
      "type": "http",
      "url": "https://websetsmcp.exa.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_EXA_API_KEY"
      }
    }
  }
}

工具模式参考

⚠️ AI 调用者重要提示： 请参阅 TOOL_SCHEMAS.md 获取确切的参数格式和示例。

关键模式规则：

• criteria 必须是对象数组：[{description: "..."}]（不是字符串数组）

• entity 必须是对象：{type: "company"}（不是字符串）

• options 必须是对象数组：[{label: "..."}]（不是字符串数组）

这些格式确保了所有工具的一致性，并符合 Websets API 规范。

使用示例

配置完成后，你可以要求 Claude 与 Websets 交互：

创建 Webset

Create a webset of AI startups in San Francisco with 20 companies. 
Add enrichments for revenue, employee count, and funding stage.

列出和查看 Websets

List all my websets and show me the details of the one called "AI Startups"

管理项目

Show me the first 10 items from my "AI Startups" webset with all their enrichment data

添加更多项目

Run another search on my "AI Startups" webset for 20 more companies focused on
enterprise voice agents, appending to the existing items

高级富集

Add an enrichment to my webset that extracts the company's latest product launch 
and the CEO's LinkedIn profile

工作流示例

以下是构建公司研究数据库的完整工作流：

1. 创建集合：

   Create a webset called "SaaS Companies" that searches for 
   "B2B SaaS companies with $10M+ revenue"

2. 添加富集：

   Add enrichments to extract: annual recurring revenue, number of customers, 
   primary market segment, and tech stack used

3. 订阅事件：

   Create a webhook to https://example.com/hook subscribed to
   webset.search.completed and webset.enrichment.completed

4. 查看结果：

   Show me all items with their enrichment data, sorted by revenue

工具详情

create_webset

创建一个新的 webset 集合，支持可选的自动填充和富集。

参数：

• externalId (可选)：你自己的 webset 标识符（最多 300 个字符）

• searchQuery (可选)：用于查找实体的自然语言查询

• searchCount (可选)：要查找的实体数量（默认：10，最小：1）

• searchEntity (可选)：搜索的实体类型，例如 {type: "company"}。对于 "custom" 类型，请包含 description。

• searchCriteria (可选)：额外的过滤标准 — [{description: "..."}]（最多 5 个）

• searchBehavior (可选)："override"（默认）替换现有项目，"append" 添加到现有项目

• searchExclude (可选)：要排除结果的导入/websets — [{source: "webset"|"import", id: "..."}]

• searchScope (可选)：将搜索范围限定为现有的导入或 webset — 通过 relationship 启用跳跃搜索

• searchRecall (可选)：是否计算搜索的召回指标

• searchMaxPeoplePerCompany (可选)：人员搜索中每家公司的人员软上限

• searchMetadata (可选)：与搜索关联的键值元数据

• enrichments (可选)：为每个项目自动提取的数据富集

• metadata (可选)：与 webset 关联的键值元数据

• excludes (可选)：全局排除 — 在此 webset 的所有操作中省略其结果的源

注意：webset 本身没有顶级的 name 或 description 参数。创建后请使用带有 title 的 update_webset，或使用 metadata 附加任意键值对。

示例：

{
  "externalId": "tech-unicorns-2024",
  "searchQuery": "Technology companies valued over $1 billion",
  "searchCount": 50,
  "searchEntity": {"type": "company"},
  "searchCriteria": [
    {"description": "Valued at over $1 billion"},
    {"description": "Technology sector"}
  ],
  "enrichments": [
    {
      "description": "Current company valuation in USD",
      "format": "number"
    },
    {
      "description": "Names of company founders",
      "format": "text"
    },
    {
      "description": "Company stage",
      "format": "options",
      "options": [
        {"label": "Series A"},
        {"label": "Series B"},
        {"label": "Series C+"},
        {"label": "Public"}
      ]
    }
  ]
}

create_enrichment

添加新的数据富集以从每个 webset 项目中提取自定义信息。

参数：

• websetId：webset 的 ID

• description：关于要提取内容的详细描述

• format (可选)："text"、"date"、"number"、"options"、"email"、"phone"、"url" 之一 — 如果省略则自动选择

• options (可选)：当 format 为 "options" 时，富集代理从中选择的选项 — [{label: "..."}]

• metadata (可选)：与此富集关联的键值元数据

示例：

{
  "websetId": "webset_abc123",
  "description": "Total number of full-time employees as of the most recent data",
  "format": "number"
}

监控（定时刷新/搜索）由底层 Websets API 公开，但目前未作为此服务器中的 MCP 工具呈现。请直接通过 Websets API 或 websets.exa.ai 配置监控。

API 端点

服务器连接到 Exa 的 Websets API：https://api.exa.ai/websets/v0。

完整 API 文档：docs.exa.ai/reference/websets

高级配置

仅启用特定工具

要仅启用某些工具，请使用 enabledTools 配置：

{
  "mcpServers": {
    "websets": {
      "command": "npx",
      "args": [
        "-y",
        "websets-mcp-server",
        "--tools=create_webset,list_websets,list_webset_items"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

调试模式

启用调试日志以排查问题：

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

故障排除

连接问题

1. 验证你的 API 密钥是否有效

2. 确保 API 密钥周围没有空格或引号

3. 完全重启你的 MCP 客户端（不仅仅是关闭窗口）

4. 检查 MCP 日志以获取错误消息

API 速率限制

Websets API 有以下限制：

• 在 exa.ai/dashboard 查看你的套餐限制

• 对大型 websets 使用分页

• 在仪表板中监控 API 使用情况

常见错误

• 401 Unauthorized：API 密钥无效或缺失

• 404 Not Found：Webset ID 不存在或已被删除

• 422 Unprocessable：查询或标准格式无效

• 429 Rate Limited：请求过多，请稍后重试

资源

• Exa Websets 文档

• Exa 仪表板

• MCP 协议规范

• 获取 Exa API 密钥

开发

从源码构建

git clone https://github.com/exa-labs/websets-mcp-server.git
cd websets-mcp-server
npm install
npm run build

项目结构

websets-mcp-server/
├── src/
│   ├── index.ts              # Main server setup
│   ├── types.ts              # TypeScript type definitions
│   ├── tools/                # MCP tool implementations
│   │   ├── config.ts         # API configuration
│   │   ├── createWebset.ts
│   │   ├── listWebsets.ts
│   │   ├── getWebset.ts
│   │   ├── updateWebset.ts
│   │   ├── deleteWebset.ts
│   │   ├── listItems.ts
│   │   ├── createEnrichment.ts
│   │   ├── createSearch.ts
│   │   ├── createWebhook.ts
│   │   ├── createImport.ts
│   │   └── ...
│   └── utils/
│       ├── api.ts            # Shared API client and error handling
│       └── logger.ts         # Logging utilities
├── package.json
└── tsconfig.json

许可证

MIT

贡献

欢迎贡献！请在 github.com/exa-labs/websets-mcp-server 提交 issue 或 PR。

支持

• 文档：docs.exa.ai

• Discord：加入 Exa 社区

• 电子邮件：support@exa.ai