需要从 Apollo.io 查找和丰富 B2B 线索时，用…

适用于按职位、公司规模、行业等条件寻找 B2B 潜在客户并生成可外联线索报告的场景。

适用场景

解决思路

1. 检查 `APOLLO_API_KEY` 是否存在于环境变量或 `~/.claude/.env.global`；若不存在，提示用户通过 `export APOLLO_API_KEY=your_key_here` 或写入 `~/.claude/.env.global` 设置，并给出获取地址 `https://app.apollo.io/#/settings/integrations/api`。
2. 使用基础 URL `https://api.apollo.io`，通过 `X-Api-Key` header 或 `api_key` query parameter 认证；注意速率限制约 600 请求/小时（因套餐而异）。
3. 用 People Search 查找潜在客户：`POST https://api.apollo.io/api/v1/mixed_people/search`，设置 `Content-Type: application/json` 和 `X-Api-Key: ${APOLLO_API_KEY}`，请求体可包含 `q_keywords`、`person_titles`、`organization_num_employees_ranges`、`person_locations`、`page`、`per_page`。
4. 使用 People Search 过滤器：`q_keywords` 跨姓名/职位/公司关键字搜索；`person_titles` 职位数组；`person_locations` 地点数组；`organization_industry_tag_ids` 行业过滤；`organization_num_employees_ranges` 员工数范围（如 `"1,10"`、`"11,50"`、`"51,200"`、`"201,1000"`、`"1001,5000"`）；`q_organization_domains` 在指定公司域名内搜索。
5. 用 Organization Enrichment 从域名获取公司详情：`POST https://api.apollo.io/api/v1/organizations/enrich`，请求体 `{"domain": "example.com"}`；返回公司名、行业、员工数、收入、技术栈、社交链接、描述、成立年份等。
6. 用 Bulk Organization Lookup 批量查询公司：`POST https://api.apollo.io/api/v1/organizations/bulk_enrich`，请求体 `{"domains": ["example.com", "company2.com", "company3.com"]}`。
7. 用 People Enrichment 按邮箱补全联系人：`POST https://api.apollo.io/api/v1/people/match`，请求体包含 `email`、`reveal_personal_emails: false`、`reveal_phone_number: false`。
8. 定义 ICP：询问或推断目标职位、公司规模、行业、地理区域、技术栈、收入范围。
9. 构建搜索查询：把 ICP 翻译成 Apollo 搜索过滤器；用变体运行多次搜索——不同职位变体（如 VP Marketing = VP of Marketing = Vice President, Marketing）、相邻角色（如 CMO、Director of Marketing、Head of Growth）、公司规模分层分别搜索。
10. 补全结果：对每个找到的潜在客户，记录当前职位、公司、地点；补全其公司域名以获取额外上下文；寻找共同人脉或共同背景。
11. 对线索进行资格评分并排序：按标题匹配 30%、公司规模 25%、行业匹配 20%、近期性 15%、信号 10% 加权评分。
12. 输出线索列表：按指定 markdown 格式生成报告——标题 `# Lead Research Report: {ICP Description}`，日期、发现潜在客户数、代表公司数；`## Top Prospects` 表格含 #、Name、Title、Company、Employees、Industry、Score；`## Company Insights` 含 domain、industry、employees、revenue、tech stack、key contacts found；`## Outreach Recommendations` 含 personalization angles 和 suggested sequence（Email 1、Email 2、LinkedIn）。
13. 遵守速率限制：Apollo 速率限制严格（约 600/小时），批量请求并缓存结果。
14. 处理付费计划限制：某些 endpoint 需要付费计划，遇到 403 响应时优雅处理。
15. 隐私与合规：除非明确要求，不要在输出中存储或暴露个人邮箱或电话号码。
16. 尊重 opt-out 列表和 GDPR/CAN-SPAM 合规。
17. 仅将补全数据用于个性化，不要用于未经请求的垃圾邮件。

适用边界 · 注意事项

• 没有 `APOLLO_API_KEY` 或 Apollo.io 付费计划时，不应使用本技能；部分 endpoint 需要付费计划并会返回 403。
• 需要输出个人邮箱/电话号码，或用于未经许可的群发/违反 GDPR/CAN-SPAM 的场景，不应使用。
• 需要超过约 600 请求/小时的高频实时查询时，不应直接使用，需批量/缓存或换方案。