Metadata-Version: 2.4
Name: ljj-apollo-mcp
Version: 0.1.0
Summary: Apollo.io MCP server — sales intelligence tools for account research. Search companies, people, and contacts via Apollo API.
Project-URL: Repository, https://github.com/anthropics/knowledge-work-plugins
Project-URL: Documentation, https://github.com/anthropics/knowledge-work-plugins/blob/main/skills-zhengli/Sales/account-research/mcp/README.md
Author: liujingjing
License: MIT
Keywords: account-research,apollo,enrichment,mcp,sales
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Requires-Python: >=3.12
Requires-Dist: mcp[cli]>=1.12.3
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# Apollo MCP Server

Apollo.io 数据富化 MCP 服务器，为 `account-research` skill 提供公司/联系人数据。

## 安装

### 1. 获取 Apollo API Key（免费）

打开 https://app.apollo.io → 注册免费账号 → Settings → API Keys → Create API Key → 复制

### 2. 设置环境变量

```bash
export APOLLO_API_KEY="你的API_Key"
```

### 3. 构建 & 安装

```bash
cd mcp
uv build                # 构建 wheel 包
uv pip install .        # 安装到当前环境
```

或者直接运行源码：

```bash
cd mcp
python src/apollo_mcp/__init__.py
```

## 工具列表

| 工具 | 作用 | account-research 对应步骤 |
|------|------|-------------------------|
| `search_companies` | 按名称搜索公司 | Step 3: Enrichment |
| `search_people` | 搜人物（按名字/公司/职位） | Step 3: 关键人物 |
| `get_company_enrichment` | 按域名获取公司详情 | Step 3: 公司档案 |
| `search_contacts` | 搜联系人（含邮箱/电话） | Step 3: 联系方式 |

## 平台配置

在你的 MCP 客户端配置中添加：

```json
{
  "mcpServers": {
    "apollo-mcp": {
      "command": "python",
      "args": ["-m", "apollo_mcp"],
      "cwd": "/path/to/account-research/mcp/src",
      "env": {
        "APOLLO_API_KEY": "你的API_Key"
      }
    }
  }
}
```

## 验证

配置后重启平台，测试：

> "用 search_companies 搜索 Stripe"
> "用 get_company_enrichment 查 stripe.com 的详细信息"
