联系人管理服务

Apollo.io MCP服务器

精益MCP服务器通过STDIO JSON-RPC 2.0向AI代理公开Apollo.io搜索、丰富和联系人管理。零外部依赖。

设置

pip install -e .

设置API密钥：

export APOLLO_API_KEY=your_key

用法

直接运行

python -m apollo_mcp          # production
python -m apollo_mcp --debug  # debug logging to stderr

克劳德桌面/克劳德代码

添加到MCP配置中：

{
  "mcpServers": {
    "apollo": {
      "command": "python",
      "args": ["-m", "apollo_mcp"],
      "env": {
        "APOLLO_API_KEY": "your_key"
      }
    }
  }
}

工具

搜索

search_people --免费

搜索阿波罗的人员数据库。返回姓名、职务、公司、领英网址，但不返回电子邮件或电话（使用 enrich_people 为此）。

参数（全部可选）：

• q_keywords --关键字搜索
• q_organization_name --按公司名称筛选
• person_titles --例如。 ["CEO", "VP Engineering"]
• person_seniorities — senior, manager, director, vp, c_suite, owner, partner
• person_locations --例如。 ["San Francisco, CA"]
• organization_ids --阿波罗组织ID
• q_organization_domains --例如。 ["stripe.com"]
• organization_locations --公司总部所在地
• organization_num_employees_ranges — "1-10", "11-50"等等。
• organization_industry_tag_ids --行业标签
• page （默认值1）/ per_page （默认值25，最大值100）

search_organizations --1学分/结果

搜索阿波罗的组织数据库。

参数（全部可选）：

• q_organization_name --姓名搜索
• organization_locations
• organization_industry_tag_ids
• organization_num_employees_ranges
• revenue_range — {"min": number, "max": number}
• organization_keywords
• page （默认值1）/ per_page （默认值25，最大值100）

富集

enrich_people --1学分/场

获取1-10人的完整联系方式（电子邮件、电话、职位、公司）。通过姓名+域名、LinkedIn URL或Apollo个人ID识别每个人 search_people.

• details （必填）--对象数组，包含： first_name, last_name, name, email, organization_name, domain, id, linkedin_url
• reveal_personal_emails --默认为false，可能需要额外的学分
• reveal_phone_number --默认为false，可能需要额外的学分

enrich_organizations --1学分/场

获取1-10个组织的完整公司详细信息（行业、规模、资金、技术）。通过域名（最佳）、名称或阿波罗组织ID进行识别 search_organizations.

• details （必填）--对象数组，包含： domain, name, id

联系人管理

联系人是您的CRM记录。这些工具使用 联系人ID，而不是搜索中的人员/组织ID。

阶段名称（例如“冷”、“感兴趣”）会自动解析，无需手动查找ID。

list_contact_stages --免费

列出团队的所有管道阶段。返回阶段名称、ID和类别。

search_contacts --免费

搜索您团队的CRM联系人。不像 search_people，这只会返回您已添加到Apollo的联系人。

参数（全部可选）：

• q_keywords --跨姓名、职务、公司、电子邮件的关键字搜索
• contact_stages --按阶段名称或ID过滤，例如。 ["Cold", "Interested"]
• owner_id --按联系人所有者ID筛选
• sort_by_field --例如。 "contact_updated_at"
• sort_ascending --默认值为false（最新值优先）
• page （默认值1）/ per_page （默认值25，最大值100）

create_contacts

将1-100人添加到您的CRM。重复项将在中单独返回 existing_contacts.

• contacts （必填）--对象数组，包含： first_name, last_name, email, phone_number, title, organization_name, account_id, owner_id, contact_stage_id, run_dedupe=True

update_contacts

更新1-100个现有CRM联系人的字段。将相同的值应用于所有指定的联系人。

• contact_ids （必填）--联系人ID数组
• owner_id, contact_stage_id, title, organization_name, account_id --要更新的字段

update_contact_stages

将1-100个触点移动到新的管道阶段。优先选择 update_contacts 只有舞台在变化。

• contact_ids （必填）--联系人ID数组
• contact_stage （必填）--舞台名称（例如“感兴趣”）或舞台ID

账户管理

账户是明确添加到您的Apollo CRM中的公司，与Apollo全球数据库中的组织不同（通过以下方式搜索 search_organizations / enrich_organizations).帐户是您拥有、跟踪和管理的CRM记录。

create_accounts

将1-100家公司添加到您的CRM中作为帐户。现有匹配项将单独返回，不进行修改。

• accounts （必填）--对象数组，包含： name （必填）， domain, website_url, phone, industry, owner_id, raw_address

update_accounts

更新1-100个现有CRM帐户的字段。将相同的值应用于所有指定的帐户。

• account_ids （必需）--帐户ID数组
• name, domain, website_url, phone, industry, owner_id, raw_address --要更新的字段

view_account

查看CRM中单个帐户的完整详细信息。

• account_id （必填）--Apollo帐户ID

序列

序列工具需要 API主密钥 （不是常规密钥）。

search_sequences --免费

搜索团队的电子邮件序列。返回序列名称、ID和状态。

参数（全部可选）：

• q_keywords --跨序列名称的关键字搜索
• page （默认值1）/ per_page （默认值25，最大值100）

add_contacts_to_sequence

将1-100个CRM联系人添加到电子邮件序列中。

• sequence_id （必填）--阿波罗序列ID（来自 search_sequences)
• contact_ids （必填）--联系人ID数组（来自 create_contacts 或 search_contacts)

典型工作流程

search_people → enrich_people → create_contacts → search_sequences → add_contacts_to_sequence

1. 搜索 查找人员或组织（人员免费，组织积分）
2. 丰富 获取完整的联系方式（每人1学分）
3. 创建联系人 将它们添加到您的CRM
4. 更新 通过管道阶段接触或移动它们
5. 添加到序列 开始自动电子邮件外展