prospeo-mcp-server

Prospeo MCP 服务

Prospeo 官方 Model Context Protocol（MCP）服务——让 AI 工具能够原生访问 B2B 潜在客户搜索与信息补全功能。

适用于任何兼容 MCP 的客户端：Claude、Cursor、Windsurf、Claude Code 等。

功能

• 搜索建议 — 用于查询地点、职位、技术、行业、NAICS 和 SIC 代码的标准筛选值的免费辅助工具（不消耗额度）
• 补全个人信息 — 根据姓名、LinkedIn URL 或电子邮件查找职业邮箱和手机号码
• 批量补全个人信息 — 单次调用最多补全 25 人——这是 search_person 的标准后续操作
• 补全公司信息 — 获取完整公司资料：员工人数、行业、收入、技术栈、融资和社交链接
• 批量补全公司信息 — 根据公司名称或域名列表，单次调用最多补全 25 家公司
• 搜索个人 — 使用筛选条件（职位、资历、地点、公司规模等）查询 Prospeo 的职业数据库
• 搜索公司 — 使用筛选条件（行业、员工人数、技术、收入等）查询 Prospeo 的公司数据库
• 账户信息 — 查看剩余额度、套餐和续订日期（免费，不消耗额度）

快速开始

选项 1：托管服务（推荐）

直接连接到 Prospeo 托管的 MCP 服务——无需安装。

服务 URL：

https://mcp.prospeo.io

通过 OAuth 或在 X-KEY 标头中传入 API 密钥进行身份验证。Claude.ai、Claude Desktop 和其他远程 MCP 客户端均支持。

选项 2：通过 npx 在本地运行

在本地以 stdio 模式运行服务。需要 Node.js 18+。

Claude Code

claude mcp add prospeo --env PROSPEO_API_KEY=your_api_key -- npx -y @prospeo/prospeo-mcp-server

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "prospeo": {
      "command": "npx",
      "args": ["-y", "@prospeo/prospeo-mcp-server"],
      "env": {
        "PROSPEO_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor / Windsurf

添加到 MCP 设置中（请参阅客户端文档）：

{
  "prospeo": {
    "command": "npx",
    "args": ["-y", "@prospeo/prospeo-mcp-server"],
    "env": {
      "PROSPEO_API_KEY": "your_api_key"
    }
  }
}

配置

环境变量

变量	必填	默认值	说明
PROSPEO_API_KEY	是（stdio 模式）	—	你的 Prospeo API 密钥。在 app.prospeo.io/api 获取
PROSPEO_API_BASE_URL	否	https://api.prospeo.io	API 基础 URL；旧版端点仍相对于此基础 URL
PROSPEO_API_V2_PREFIX	否	/api/v2	必须与后端的 API_V2_STR 一致，例如 /test-api
LOG_LEVEL	否	INFO	日志级别：DEBUG、INFO、WARN、ERROR

工具

后端提供的工具

启动时，stdio 和托管 HTTP 都会从配置的 Prospeo API 加载 POST /api/v2/mcp/tools。该表提供工具名称、严格的输入架构、注释和公共端点绑定。调用会根据这些架构进行验证，并使用调用方的 API 密钥转发。托管连接共享编译后的启动表；每次调用仍使用各自经过身份验证的密钥。

该表涵盖已启用、已实现且绑定了公共端点的规范服务器工具，但不包括内部辅助工具、浏览器工具和旧版别名。覆盖范围由后端目录决定，而非固定的工具数量。下文记录的八个兼容工具仍可用；规范工具 get_usage_and_credits 仍可通过 get_account_info 使用。

元数据无需用户凭据即可加载，路径由 API 基础 URL、PROSPEO_API_V2_PREFIX 和 /mcp/tools 组成。前缀默认为 /api/v2，且必须与后端的 API_V2_STR 一致。对于 /test-api，启动时会获取 POST /test-api/mcp/tools。生成的调用使用表中的确切服务器根路径；不会再次添加前缀。请保持基础 URL 不变，以便旧版工具继续调用现有的根级端点。

使用 API 密钥发起调用即直接授权相应操作，其中可能会扣除额度。prospeo/approvalRecommended 和 prospeo/credits 元数据可让客户端自行向用户显示确认提示。Find Mobile 使用常规会员额度上限，并返回回执和记录链接；用户需在经过身份验证的产品中查看已揭示的电话号码。线程搜索仅搜索密钥所有者的私有聊天记录。

如果无法获取或验证该表，服务器将以八个兼容工具启动，并记录降级情况。后端目录发布后，重启 MCP 进程以加载新发布的工具。请在同一发布窗口内协调后端、Assistant 和 MCP 的可用性。

生成的工具响应会保留公共 JSON 投影。工具调用失败时会设置 MCP isError: true，并返回包含 code 和 message 的 JSON 错误。

如需验证契约，请将 PROSPEO_PUBLIC_TABLE_PATH 设为后端公共工具测试输出的 JSON 表路径，然后运行 npm test。同时运行 npm run build 和 npm run build:http。

search_suggestions

在构建搜索条件前解析规范筛选值。免费端点，不消耗额度。速率限制为 15 req/sec。

每当用户提及地点、技术、行业、职位名称或 NAICS / SIC 代码时，都应先调用此工具——猜测字符串（例如，“SF”与“San Francisco, California, United States”）会导致搜索结果为空。

支持的类型： location、job_title、technology、industry、naics、sic。

enrich_person

查找某人的工作邮箱和／或手机号码。若要丰富多位联系人的信息，请改用 bulk_enrich_person（每条记录费用相同，一次调用即可完成，无需多次调用）。

必需输入（至少一项）：

• linkedin_url — 此人的 LinkedIn 个人资料 URL
• email — 已知邮箱地址
• person_id — 来自先前 search_person 结果
• first_name + last_name + company_name 或 company_website

bulk_enrich_person

单次调用即可丰富最多 25 位联系人的信息，是 search_person 的规范后续步骤。将每条结果的 person_id 作为一条记录传入；响应中的 matched.identifier 与该 person_id 相同，便于将结果关联回原始列表。

每条记录的额度费用与 enrich_person 相同（每个匹配邮箱 1 个额度；每个匹配邮箱和手机号码组合 10 个额度）。每条记录返回精简响应（不包含 job_history 和 skills，公司摘要也经过缩略）。如果需要某个人的完整资料，请使用 enrich_person。

enrich_company

获取完整的公司资料，包括员工人数、行业、收入、技术栈、融资、社交链接、属性和招聘职位。

必需输入（至少提供一项）：

• company_website（推荐，准确度最高）
• company_name
• company_linkedin_url
• company_id — 来自之前的搜索或丰富查询结果

bulk_enrich_company

一次调用可丰富最多 25 家公司的资料——当你已有公司名称或域名列表（CRM 导出数据、客户名单、竞争对手地图）时，这是标准查询工具。返回每家匹配公司的完整资料。每家匹配公司消耗 1 个额度。如果提供了 company_id，identifier 默认为 company_id，因此从 search_company 结果继续查询非常简单。

search_person

使用带类型的筛选条件搜索 Prospeo 的专业人士数据库。每页最多返回 25 条结果。每页结果消耗 1 个额度。

筛选条件包括： person_job_title、person_seniority、person_location_search、company_industry、company_headcount_range、company_technology、person_search、person_name、person_job_change、person_contact_details 等。

search_company

使用带类型的筛选条件搜索 Prospeo 的公司数据库。每页最多返回 25 条结果。每页结果消耗 1 个额度。

筛选条件包括： company_industry、company_headcount_range、company_location_search、company_technology、company_revenue、company_funding、company_intent、company_icp、company_lookalike、company_key_execs、company_website_traffic、company_integrations 等。

get_account_info

查看你的 Prospeo 账户状态——剩余额度、套餐名称、续订日期和团队规模。免费接口，不消耗额度。

示例

示例 1：通过 LinkedIn 查找某人的电子邮箱

提示词：

查找 linkedin.com/in/johndoe 上这个人的工作邮箱

执行过程： 服务会使用 LinkedIn URL 调用 enrich_person，并返回此人经过验证的工作邮箱、当前职位、公司，以及可用时的电话号码。

示例 2：外联前研究公司

提示词：

提供 stripe.com 的完整资料——员工人数、融资、技术栈等所有信息

执行过程： 服务会使用域名调用 enrich_company，并返回公司的行业、员工人数、收入范围、使用的技术、融资轮次、社交链接和总部所在地。

示例 3：使用筛选条件构建潜在客户名单

提示词：

查找美国 SaaS 公司中 VP 级别、员工人数为 50-200 人的人士

执行过程： 服务会使用资历、行业、员工人数和所在地筛选条件调用 search_person。每页最多返回 25 位匹配的专业人士，并附上姓名、职位、公司、电子邮箱和 LinkedIn URL。

示例 4：查找使用特定技术的公司

提示词：

搜索使用 Salesforce 且员工人数超过 500 人的公司

执行过程： 服务会使用技术和员工人数筛选条件调用 search_company。返回匹配公司的域名、行业、规模、所在地和技术栈详情。

示例 5：查看剩余额度

提示词：

我还剩多少 Prospeo 额度？

执行过程： 服务会调用 get_account_info，返回你的当前套餐、剩余额度、续订日期和团队规模，不消耗任何额度。

身份验证

托管服务（mcp.prospeo.io）

托管服务支持两种身份验证方式：

1. OAuth 2.0 — 供 Claude.ai 和 Claude Desktop 使用。通过 MCP 目录连接时，OAuth 授权流程会自动处理。
2. API 密钥请求头 — 在 X-KEY 请求头中传入 API 密钥，以便直接通过程序访问。

本地服务（stdio 模式）

通过 PROSPEO_API_KEY 环境变量传入 API 密钥。服务会在启动时验证密钥；如果缺少密钥，则会显示明确的错误并退出。

隐私政策

查看我们的隐私政策：https://prospeo.io/privacy-policy

支持

• 邮箱：[email protected]
• 帮助中心：https://help.prospeo.io
• MCP 文档：https://prospeo.io/mcp-docs
• REST API 文档：https://prospeo.io/api-docs
• 问题反馈：https://github.com/prospeo-v2/prospeo-mcp-server/issues

发布

从 main 分支的 Actions 选项卡中运行 Publish 工作流，并选择 patch、minor 或 major。该工作流会更新 package.json 和 server.json 中的版本，将其发布到 npm 和 MCP Registry，然后提交并为此次发布创建标签。

许可证

MIT