Apollo

@pipeworx/apollo

来自 Apollo.io 的公司和人员数据：组织搜索与信息补全、人员搜索与信息补全，以及公司的当前职位招聘信息。请使用你自己的 Apollo API 密钥——每次调用都会使用你自己的 Apollo 账户和账户内的额度。

属于 Pipeworx——一个将 AI Agent 连接到 1872+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联，未获其认可，也不是由其发布。

工具

• apollo_search_organizations(...) — 按行业、员工人数、总部所在地、使用中的技术以及融资历史／规模搜索公司。
• apollo_enrich_organization(...) — 根据域名、网站或 LinkedIn URL 补全一家公司的信息：行业、员工人数、收入、融资轮次、技术。
• apollo_search_people(...) — 按职位名称、资历级别和雇主域名／组织 ID 搜索人员。返回经过混淆处理的姓氏，绝不返回电子邮箱或电话号码——可搭配 apollo_enrich_person 获取真实联系方式。
• apollo_enrich_person(...) — 根据电子邮箱、LinkedIn URL 或姓名+域名／组织补全特定人员的信息：职位名称、资历级别、部门、雇主，以及（如果你的账户已解锁）工作邮箱。
• apollo_org_job_postings(...) — 根据 Apollo organization_id 获取公司的当前职位招聘信息（职位名称、地点、发布日期／最后发现日期）。

身份验证

仅使用自带密钥。每个工具都需要 _apiKey——你自己的 Apollo API 密钥，可在 Apollo 应用的 Settings → Integrations → API 下获取（参见 https://docs.apollo.io/docs/create-api-key）。Pipeworx 不持有 Apollo 密钥，也绝不会代为提供密钥：如果未提供 _apiKey，所有工具都会在发起任何网络调用前拒绝请求，并指出所需参数和获取密钥的页面。

受限范围的密钥必须启用相应的端点（Apollo 允许按端点设置密钥范围）；主密钥可用于全部五个端点。Apollo 规定每个端点每小时最多调用 600 次。

额度成本（由 Apollo 自行收取，计入你的账户）

• apollo_search_organizations — 每页 1 个额度（每页最多 100 条结果）。
• apollo_enrich_organization — 每补全一家组织消耗 1 个额度。
• apollo_search_people — 0 个额度（此端点不会返回电子邮箱／电话号码）。
• apollo_enrich_person — 找到电子邮箱／人口统计数据时消耗 1 个额度；只有获取手机号码时才额外消耗 8 个额度（此工具包不会请求手机号码）；没有匹配结果时消耗 0 个额度。
• apollo_org_job_postings — 每页 1 个额度，最多 10,000 条招聘信息。

Pipeworx 绝不会加价或转售这些服务——这是 Apollo 自行计费并收取的用量费用。Pipeworx 自身按调用收取的费用另行计算，与 Apollo 的额度成本无关。

数据来源

• Apollo.io — 公司和联系人数据库（组织、人员、职位招聘信息），你的 Apollo 账户已可访问这些数据。

已知的局限和注意事项

• apollo_search_people 永远不会返回电子邮件或电话号码。 Apollo 刻意让此端点免扣额度，因此不会包含这些信息 — 你会得到名字、经过模糊处理的姓氏，以及 has_email 之类的布尔值。 对搜索结果调用 apollo_enrich_person，尝试解析出真实联系方式。
• 匹配到但被锁定的电子邮件会由 Apollo 以字面字符串 email_not_unlocked@<domain> 返回，HTTP 200 — 不是 null，也不是错误。 此工具包会将该占位符视为未命中：apollo_enrich_person 会将其映射为 email: null, email_locked: true，而不会返回占位符文本本身。解锁需要 消耗你自己的 Apollo 额度或订阅套餐；此工具包无法改变这一点。
• 无法显示电话号码。 Apollo 的 reveal_phone_number 是异步的 — 它会稍后将号码发送到 webhook_url，而不是放在响应中 — 因此无法合理地映射到一次无状态工具调用。此工具包 不实现此功能；如需使用，请直接通过 Apollo 自有的控制面板/API 操作。
• 不支持序列、联系人/列表创建或发送电子邮件。 Apollo 的 API 支持这三项功能；此工具包出于设计考虑均未实现（D3，见 docs/gtm-wave-2026-10-08.md）。
• 绝不使用平台密钥。 此工具包按设计仅支持 BYOK（D4）：Apollo 是 个人数据供应商，而 D4 禁止新增采用平台密钥的供应商。不要在此工具包的网关清单条目中添加 platformKeyEnv。
• 不内置枚举数据。 Apollo 的行业标签 ID 和 1,500+ 个技术 UID 都是由 Apollo 维护的开放列表，因此这里不会枚举这些值 — 它们是普通的 string/string[] 字段。请在 Apollo UI 自带的筛选器中查找准确值。
• 也可在 enrich_find_email （@pipeworx/enrich-waterfall）中作为供应商环节（_apolloKey）使用， 与其他电子邮件查找供应商搭配。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "apollo": {
      "url": "https://gateway.pipeworx.io/apollo/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/apollo/mcp 上的 tools/list 会返回上表中的工具， 以及 Pipeworx 通用元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关范围内的其他工具。 因此，你看到的工具数量会多于此表：目前，单工具包端点除了该工具包自身的工具外， 还会列出约 30 个通用工具。连接的 initialize 响应会说明其确切范围， 是当天情况的权威依据。

这是有意为之，并非意外的多路复用。元工具可以让 限定范围的连接回答此工具包未涵盖的问题 — 通过 ask_pipeworx 跨整个目录进行路由 — 无需你再添加第二个 MCP 服务。目前无法在不包含这些工具的情况下挂载工具包端点；如果额外的架构定义占用的上下文多于路由功能带来的价值， 请只连接一次完整网关，而不要连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出每个工具包的所有工具， 而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1872+ 个数据源。唯一的区别是哪些工具包的工具会被 直接列出；无论连接哪个 URL，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

此工具包需要你自己的 API 密钥（_apiKey）— 我们不会为它提供代持密钥，因此这里没有不带密钥也能运行的 curl 命令。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/apollo_search_organizations。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需 gateway 账号）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账号，也无需经过网关往返：

{
  "mcpServers": {
    "apollo": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-apollo"]
    }
  }
}

或者直接运行，确认它可以启动：

npx -y @pipeworx/mcp-apollo

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此软件包中的工具，不包含上方网关连接额外提供的任何共享元工具。使用相同的源代码和工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——这既适用于上方的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Apollo data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT