销售智能自动化服务器

Apollo MCP Server是一个提供34+工具的销售智能自动化服务器,用于自动化销售外展、潜在客户开发和管道管理。

  • by BlockchainRev
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 BlockchainRev/apollo-mcp-server

使用说明

阿波罗MCP服务器

一种模型上下文协议(MCP)服务器 阿波罗.io -领先的销售情报和参与平台。该服务器提供34多种工具,用于自动化销售推广、潜在客户和管道管理。

特性

  • 人员搜索和丰富 -从Apollo的275M+联系人数据库中查找并丰富联系人数据
  • 组织搜索和丰富 -按行业、规模、地点等搜索公司
  • 电子邮件序列 -通过A/B测试创建和管理自动化的外展活动
  • 联系人管理 -将联系人组织到列表中并管理管道阶段
  • 工作流自动化 -为您的销售流程构建事件驱动的自动化
  • 任务和活动 -创建和跟踪销售活动
  • 交易管道 -通过销售渠道管理机会
  • 分析 -跟踪序列性能和电子邮件传递能力

安装

先决条件

使用uv进行安装

# Clone the repository
git clone https://github.com/BlockchainRev/apollo-mcp-server.git
cd apollo-mcp-server

# Install dependencies
uv pip install -e .

使用pip安装

pip install -e .

配置

获取Apollo API密钥

  1. 登录到 阿波罗.io
  2. 首选 设置 > 集成 > API
  3. 生成或复制API密钥

设置环境变量

export APOLLO_API_KEY="your-api-key-here"

或者添加到您的shell配置文件中(~/.bashrc, ~/.zshrc等等):

echo 'export APOLLO_API_KEY="your-api-key-here"' >> ~/.zshrc

用法

使用克劳德代码

添加到您的Claude Code MCP配置中(~/.claude.json):

{
  "mcpServers": {
    "apollo": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/apollo-mcp-server", "python", "-m", "apollo_mcp.server"],
      "env": {
        "APOLLO_API_KEY": "your-api-key-here"
      }
    }
  }
}

独立

# Run the server
python -m apollo_mcp.server

可用工具

人员和联系人(6个工具)

工具 说明
people_search 使用过滤器搜索Apollo的275M+联系人数据库
people_enrich 通过电子邮件、姓名或领英丰富个人资料
contacts_search 在您的Apollo CRM中搜索联系人

组织(3个工具)

工具 说明
organization_search 按行业、规模、地点搜索公司
organization_enrich 按域获取全面的公司数据
organization_job_postings 获取公司当前的招聘信息

电子邮件序列(5个工具)

工具 说明
sequences_list 列出所有电子邮件序列
sequence_get 获取序列详细信息和统计数据
sequence_create 创建多步骤外展序列
sequence_add_contacts 将联系人添加到序列中
sequence_activate 激活或暂停序列

联系人列表(3个工具)

工具 说明
lists_get 获取所有已保存的列表
list_create 创建新联系人列表
list_add_contacts 将联系人添加到列表中

工作流程(7个工具)

工具 说明
workflows_list 列出所有工作流自动化
workflow_get 获取工作流详细信息
workflow_create 创建事件驱动的自动化
workflow_update 更新工作流配置
workflow_activate 激活或停用工作流
workflow_delete 删除工作流
workflow_templates_list 浏览工作流模板
workflow_create_from_template 从模板创建

电子邮件(2个工具)

工具 说明
email_preview 使用变量替换预览电子邮件
email_send 发送一次性电子邮件

任务(2个工具)

工具 说明
tasks_list 列出所有任务
task_create 为联系人创建任务

优惠(2工具)

工具 说明
deals_list 列出管道机会
deal_create 创建新交易

分析(2个工具)

工具 说明
analytics_sequences 获取序列性能指标
analytics_email_accounts 获取电子邮件送达率统计数据

实用工具(4个工具)

工具 说明
get_available_fields 列出电子邮件个性化变量
get_email_schedules 获取发送计划选项
get_contact_stages 获取联系渠道阶段
get_account_stages 获取帐户管道阶段

例子

寻找决策者

# Find VPs of Sales at tech companies in California
people_search(
    person_titles=["VP Sales", "Vice President of Sales"],
    organization_locations=["California, US"],
    organization_num_employees_ranges=["51,200", "201,500"]
)

创建外展序列

sequence_create(
    name="New Lead Outreach",
    steps=[
        {
            "type": "auto_email",
            "wait_time": 0,
            "wait_mode": "minute",
            "emailer_touches": [{
                "type": "new_thread",
                "subject": "Quick question about {{company}}",
                "body_html": "<p>Hi {{first_name}},</p><p>I noticed {{company}} is growing...</p>"
            }]
        },
        {
            "type": "auto_email",
            "wait_time": 3,
            "wait_mode": "day",
            "emailer_touches": [{
                "type": "reply",
                "subject": "Re: Quick question about {{company}}",
                "body_html": "<p>Following up on my last email...</p>"
            }]
        }
    ]
)

创建工作流自动化

workflow_create(
    name="New Contact Nurture",
    trigger_type="event",
    trigger_events=["contact_saved_or_created"],
    actions=[
        {"type": "add_to_sequence", "config": {"sequence_id": "abc123"}}
    ]
)

电子邮件个性化变量

在电子邮件模板中使用这些变量:

变量 描述
{{first_name}} 联系人的名字
{{last_name}} 联系人的姓氏
{{company}} 公司名称
{{title}} 职位名称
{{email}} 电子邮件地址
{{city}} 城市
{{state}} 州/地区
{{country}} 国家

API终点

服务器使用两个Apollo API端点:

  • 公共API (api.apollo.io/v1/):人员搜索、丰富
  • 应用程序API (app.apollo.io/api/v1/):序列、工作流、列表等。

所有请求都使用 X-Api-Key 用于身份验证的标头。

发展

项目结构

apollo-mcp-server/
├── apollo_mcp/
│   ├── __init__.py          # Package initialization
│   ├── server.py             # Main MCP server
│   ├── client.py             # HTTP client for Apollo API
│   ├── utils/
│   │   ├── __init__.py
│   │   ├── config.py         # Configuration and settings
│   │   └── formatting.py     # Output formatting utilities
│   └── tools/
│       ├── __init__.py       # Tool registration
│       ├── people.py         # People/contact tools
│       ├── organizations.py  # Organization tools
│       ├── sequences.py      # Email sequence tools
│       ├── lists.py          # List management tools
│       ├── workflows.py      # Workflow automation tools
│       ├── email.py          # Email tools
│       ├── tasks.py          # Task management tools
│       ├── deals.py          # Deal/opportunity tools
│       ├── analytics.py      # Analytics tools
│       └── utility.py        # Helper tools
├── examples/
│   └── basic_usage.py        # Usage examples
├── pyproject.toml            # Project configuration
├── requirements.txt          # Dependencies
└── README.md

运行测试

# Install dev dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

贡献

欢迎投稿!拜托:

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

许可证

MIT许可证-请参阅 许可证 了解详情。

致谢