内容
# Apollo 代理命令行工具
**在您的终端中使用 Apollo.io**。寻找潜在客户，丰富信息，管理联系人和账户，运行序列，跟踪交易 — 所有这些都可以在一个命令行中完成。
55 个命令，涵盖 16 个 API 组。全面覆盖 [Apollo.io](https://apollo.io) 的已文档化 REST API。为人类、脚本、CI/CD 管道和 AI 代理而构建。
```bash
npm install -g apollo-agent-cli
```
> **为什么是 `apollo-agent-cli` 而不是 `apollo-cli`？** `apollo-cli` 和 `apollo` 的 npm 名称被 Apollo GraphQL 的工具占用。我们遵循 `bcharleson` 代理 CLI 产品组合的约定：当官方 CLI 拥有明显的名字时，我们使用后缀 `-agent-cli`。二进制文件仍然是 `apollo`。
---
## 什么是 Apollo.io？
[Apollo.io](https://apollo.io) 是领先的销售情报和参与平台。它结合了 2.75 亿人的 B2B 数据库与 CRM、序列和分析功能，以便大规模开展外联：
- **寻找潜在客户** — 搜索 2.75 亿+ 联系人和 6000 万+ 公司，按职称、行业、员工人数、地点或技术栈过滤
- **信息丰富** — 验证电子邮件、查找电话号码、附加公司信息和检测招聘意向信号
- **CRM** — 使用自定义字段、阶段和标签管理联系人、账户和交易
- **序列** — 多步骤电子邮件外联，带有 A/B 测试、调度功能和联系人阶段自动化
- **参与** — 记录通话，跟踪打开/回复，并管理团队的销售漏斗
- **报告** — 拉取序列、交易和团队绩效的分析数据
## 本命令行工具的功能
您在 Apollo 仪表板上可以执行的每个操作，现在都可以在终端中完成：
**寻找潜在客户** — 搜索 Apollo 的数据库，批量丰富潜在客户信息，查找电子邮件和电话号码，并识别意向信号（职位发布、新闻提及） — 所有这些都可通过脚本实现。
**CRM 操作** — 创建联系人和账户，批量更新阶段和标签，管理自定义字段，并读取任意联系人、账户或交易的完整记录。
**序列编排** — 搜索序列，添加或删除联系人，激活或停用，存档，并检查逐步骤内容。
**销售漏斗管理** — 列出、创建、更新和报告交易（机会）。以编程方式移动交易通过销售漏斗阶段。
**团队分析** — 拉取已保存的报告，监控 API 使用情况，列出团队用户，并检查连接的发送邮箱。
**AI 代理集成** — 每个命令都可以用作 CLI 子命令和 MCP 工具，因此 AI 助手（Claude、Cursor、Windsurf）可以直接驱动您的 Apollo 工作区。
---
## 安装
### npm（推荐）
```bash
npm install -g apollo-agent-cli
```
### npx（零安装）
```bash
npx apollo-agent-cli people search --domain apollo.io
```
### 从源代码构建
```bash
git clone https://github.com/bcharleson/apollo-agent-cli.git
cd apollo-agent-cli
npm install && npm run build
npm link
```
---
## 身份验证
三种身份验证方式，按此顺序检查：
1. **`--api-key` 标志** — 在任意命令上传递：`apollo people search --api-key <key>`
2. **环境变量** — `export APOLLO_API_KEY=your-key`
3. **存储配置** — 运行 `apollo login` 将您的密钥保存到 `~/.apollo-cli/config.json`（文件模式 `0600`）
从 [app.apollo.io/#/settings/integrations/api](https://app.apollo.io/#/settings/integrations/api) 获取您的 API 密钥。
### 主 API 密钥
大约一半的 Apollo 端点（写入账户、交易、序列、任务、通话、用户、电子邮件账户、分析）需要 **主 API 密钥**。命令行工具会检测这些端点上的 403 响应，并显示明确的错误：
```bash
$ apollo deals create --name "Acme Q1" --account-id acc_123
Error: 此端点需要主 API 密钥：/opportunities
在 Apollo → 设置 → 集成 → API → 编辑密钥 → "设置为主要密钥" 中启用它
```
需要主密钥的端点在下面的命令列表中标有 `[主密钥]`。
---
## 快速入门
```bash
# 身份验证
apollo login
# 搜索 Apollo 的 2.75 亿+ 数据库（免费，无积分消耗）
apollo people search --domain stripe.com --title "VP Engineering" --limit 10
# 丰富单个潜在客户（消耗积分）
apollo people enrich --email founder@stripe.com --reveal-emails
# 按条件查找公司
apollo organizations search --keywords "SaaS" --employee-range "201,500" --limit 25
# 将联系人添加到您的 CRM
apollo contacts create --first-name Patrick --last-name Collison --email pc@stripe.com
# 添加到序列（主密钥）
apollo sequences add-contacts <sequence-id> --contact-ids "<contact-id>"
# 跟踪交易（主密钥）
apollo deals list --limit 10
```
---
## 输出格式
每个命令默认输出 JSON — 适用于输送到 `jq`、在脚本中解析或馈送到 AI 代理。
```bash
# 默认：紧凑的 JSON
apollo contacts search
# 美观打印的 JSON
apollo contacts search --pretty
# 纯文本表格（适用于终端）
apollo contacts search --output table
# 选择特定字段
apollo contacts search --fields "id,name,email,title"
# 禁止输出（仅退出代码）
apollo contacts search --quiet
```
---
## 命令
### 人员（3）— Apollo 的 2.75 亿+ 数据库
从 Apollo 的公共数据库（与您的 CRM 分开）搜索和丰富潜在客户。
```bash
apollo people search --domain apollo.io --title "VP Sales" --limit 25
apollo people search --keywords "fintech" --seniority "director,vp" --location "San Francisco"
apollo people enrich --email founder@stripe.com # 单个丰富（积分）
apollo people enrich --linkedin-url https://linkedin.com/in/x # 按 LinkedIn 匹配
apollo people bulk-enrich --emails "a@x.com,b@x.com,c@x.com" # 最多 10 个同时处理
```
> `people search` 免费（无积分）。`people enrich` 和 `people bulk-enrich` 按匹配次数消耗积分。
### 联系人（8）— 您的 CRM 联系人
```bash
apollo contacts search --limit 50 # 搜索您的 CRM
apollo contacts get <contact-id> # 读取单个联系人
apollo contacts create --first-name John --last-name Smith --email j@co.com
apollo contacts update <contact-id> --title "VP Engineering"
apollo contacts bulk-update --contacts '[{"id":"c1","title":"CTO"}]' # [主密钥]
apollo contacts update-stages --contact-ids "c1,c2" --stage-id "stg_x"
apollo contacts update-labels --contact-ids "c1,c2" --labels "hot,vip" # [主密钥]
apollo contacts stages # 发现阶段 ID
```
### 账户（8）— 您的 CRM 账户
```bash
apollo accounts search --limit 50
apollo accounts get <account-id> # [主密钥]
apollo accounts create --name "Acme Corp" --domain acme.com # [主密钥]
apollo accounts update <account-id> --name "Acme Corporation" # [主密钥]
apollo accounts bulk-create --accounts '[{"name":"X","domain":"x.com"}]' # [主密钥]
apollo accounts bulk-update --accounts '[{"id":"a1","name":"X"}]' # [主密钥]
apollo accounts update-labels --account-ids "a1,a2" --labels "tier1" # [主密钥]
apollo accounts stages # 发现阶段 ID
```
### 组织（7）— 公司情报
```bash
apollo organizations search --keywords "saas" --employee-range "201,500" # 免费，无积分
apollo organizations enrich --domain stripe.com # 单个丰富（积分）
apollo organizations bulk-enrich --domains "stripe.com,plaid.com"
apollo organizations get <organization-id> # [主密钥]（积分）
apollo organizations job-postings <organization-id> # 招聘意向信号
apollo organizations news <organization-id> # 近期新闻 / 外联钩子
apollo organizations postal-addresses <organization-id> # 总部 + 办公室
```
### 序列（8）— 电子邮件外联 `[主密钥]`
> Apollo 的 API 内部使用 `emailer_campaigns`；命令行工具将其别名为 `sequences` 以提高清晰度。
```bash
apollo sequences search # 列出序列
apollo sequences get <sequence-id> # 读取单个序列
apollo sequences add-contacts <sequence-id> --contact-ids "c1,c2"
apollo sequences remove-contacts --sequence-id <id> --contact-ids "c1"
apollo sequences activate <sequence-id> # 批准并启动
apollo sequences deactivate <sequence-id> # 暂停而不删除联系人
apollo sequences archive <sequence-id> # 存档序列
apollo sequences steps-list <sequence-id> # 检查逐步骤内容
```
### 电子邮件（2）— 外联跟踪 `[主密钥]`
```bash
apollo emails search --contact-id "contact_abc" --limit 50
apollo emails activities <email-id> # 打开，点击，弹回
```
### 交易（5）— 销售漏斗 / 机会 `[主密钥]`
> Apollo 的 API 内部使用 `opportunities`；命令行工具将其别名为 `deals`。
```bash
apollo deals list --limit 25 # 搜索交易
apollo deals list --stage-id <id> --owner-id <user-id>
apollo deals get <deal-id> # 单个交易记录
apollo deals create --name "Acme Q1" --account-id "acc_abc" --amount 50000
apollo deals update <deal-id> --stage-id "stage_closed_won"
apollo deals stages # 发现阶段 ID
```
### 任务（4）— 任务和待办事项 `[主密钥]`
```bash
apollo tasks search --type call --limit 50
apollo tasks get <task-id>
apollo tasks create --type call --contact-id "c1" --due-date "2026-04-01"
apollo tasks update <task-id> --status completed
```
### 通话（2）— 通话记录 `[主密钥]`
```bash
apollo calls search --contact-id "contact_abc" --limit 50
apollo calls create --contact-id "c1" --duration 300 --outcome "connected"
```
### 用户（1）— 团队成员 `[主密钥]`
```bash
apollo users list # 发现用户 ID
apollo users list --fields id,name,email
```
### 电子邮件账户（2）— 发送邮箱 `[主密钥]`
```bash
apollo email-accounts list # 所有连接的邮箱
apollo email-accounts get <email-account-id> # 单个邮箱详情
```
### 自定义字段（1） `[主密钥]`
```bash
apollo custom-fields list # 所有类型自定义字段
```
### 标签（1）
```bash
apollo labels list # 所有工作区标签
```
### 列表（1）
```bash
apollo lists list # 静态潜在客户列表
```
### 分析（1）— 已保存的报告 `[主密钥]`
```bash
apollo analytics report --report-id "rpt_abc" # 运行已保存的报告
```
### 使用情况统计（1）— API 遥测 `[主密钥]`
```bash
apollo usage-stats api # 工作区 API 使用情况
```
### 身份验证
```bash
apollo login # 交互式
apollo login --api-key <key> # 非交互式
apollo logout # 清除存储的配置
```
---
## MCP 服务器
命令行工具作为 [MCP（模型上下文协议）](https://modelcontextprotocol.io/) 服务器，为 AI 助手提供直接访问所有 55 个 Apollo 工具作为原生函数调用。
```bash
apollo mcp
```
### 这意味着什么
当您在 Claude、Cursor、VS Code 或 Windsurf 中配置 `apollo mcp` 作为 MCP 服务器时，您的 AI 助手可以：
- 在对话中搜索和丰富潜在客户信息
- 直接在您的 Apollo 工作区创建联系人和账户
- 按需运行分析和销售漏斗报告
- 将潜在客户添加到序列并跟踪交易的全过程
每个 `CommandDefinition` 同时支持 CLI 子命令和 MCP 工具 — 只有一个真实来源。
### 配置
添加至您的 MCP 设置（Claude Desktop, Cursor, VS Code, Windsurf）：
```json
{
"mcpServers": {
"apollo": {
"command": "npx",
"args": ["apollo-agent-cli", "mcp"],
"env": {
"APOLLO_API_KEY": "your-api-key"
}
}
}
}
```
这注册了 16 个组中 55 个工具：
| 组 | 工具 | 示例 |
|-------|-------|----------|
| people | 3 | `people_search`, `people_enrich`, `people_bulk_enrich` |
| contacts | 8 | `contacts_search`, `contacts_get`, `contacts_create`, `contacts_bulk_update` |
| accounts | 8 | `accounts_search`, `accounts_create`, `accounts_bulk_create`, `accounts_stages` |
| organizations | 7 | `organizations_search`, `organizations_enrich`, `organizations_news` |
| sequences | 8 | `sequences_search`, `sequences_add_contacts`, `sequences_activate`, `sequences_archive` |
| emails | 2 | `emails_search`, `emails_activities` |
| deals | 5 | `deals_list`, `deals_get`, `deals_create`, `deals_stages` |
| tasks | 4 | `tasks_search`, `tasks_get`, `tasks_create`, `tasks_update` |
| calls | 2 | `calls_search`, `calls_create` |
| users | 1 | `users_list` |
| email-accounts | 2 | `email_accounts_list`, `email_accounts_get` |
| custom-fields | 1 | `custom_fields_list` |
| labels | 1 | `labels_list` |
| lists | 1 | `lists_list` |
| analytics | 1 | `analytics_report` |
| usage-stats | 1 | `usage_stats_api` |
---
## 分页
Apollo 使用 **页码分页** (`page` + `per_page`)：
```bash
apollo contacts search --page 1 --limit 100
apollo contacts search --page 2 --limit 100
```
最大：每页 100 条记录，最多 500 页（50,000 条记录）。当 `pagination_info.has_more` 为 `false` 时，您已到达结尾。
---
## 示例工作流
### 潜在客户 → 丰富 → 添加到序列
```bash
export APOLLO_API_KEY=your-key
# 1. 查找潜在客户（免费）
PROSPECTS=$(apollo people search --domain stripe.com --title "VP Sales" --limit 5)
# 2. 选择一个电子邮件并创建 CRM 联系人
apollo contacts create --first-name Pat --last-name C --email pat@stripe.com
# 3. 查找我们刚刚创建的联系人 ID
CID=$(apollo contacts search --q-keywords "pat@stripe.com" --fields id | jq -r '.[0].id')
# 4. 添加到序列（主密钥）
apollo sequences add-contacts seq_abc --contact-ids "$CID"
```
### 公司情报外联前
```bash
# 丰富公司
apollo organizations enrich --domain stripe.com --pretty
# 检查招聘意向
apollo organizations job-postings <org-id> --limit 10 --fields title,location
# 查看近期新闻
apollo organizations news <org-id> --limit 5
```
### 销售漏斗管理
```bash
# 列出活动交易
apollo deals list --stage-id stage_active --limit 25
# 将交易移至关闭赢得
apollo deals update deal_xyz --stage-id stage_closed_won --close-date 2026-04-30
# 拉取已保存的分析报告
apollo analytics report --report-id rpt_pipeline_q1 --pretty
```
### 每天的收件箱 + 序列健康状况（cron）
```bash
# 每天的序列统计（添加到 crontab）
0 9 * * * APOLLO_API_KEY=... apollo sequences search --pretty >> /var/log/apollo.json
# 监控 API 配额耗尽
*/15 * * * * APOLLO_API_KEY=... apollo usage-stats api | jq '.api_usage'
```
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器