email-search

Email Finder

将 LinkedIn 个人资料转换为已验证的电子邮件和电话号码。接收 people-search 的输出，并通过 Prospeo 或 Fullenrich 等联系人信息增强服务进行处理。

相关技能

list-segmentation → people-search → email-search → email-generation → email-response-simulation → campaign-sending

people-search 找到要联系的对象（及其 LinkedIn URL）后，此技能会获取他们经过验证的联系信息。

Extruct API 操作

此技能将所有 Extruct API 调用委托给 extruct-api 技能。

对于所有 Extruct API 操作，请阅读并遵循 skills/extruct-api/SKILL.md 中的说明。

此技能中唯一的 Extruct 操作是读取人员表数据。联系人信息增强使用独立的服务提供商（Prospeo、Fullenrich 等），各自拥有独立的 API。

输入

输入	来源	必需
人员表 ID	people-search 创建的子表	是（或 CSV）
人员 CSV	claude-code-gtm/csv/input/{campaign}/people_linkedin.csv	是（或表）
服务提供商偏好	用户选择	是
包含手机号码	用户选择	否（默认：否）

选择服务提供商

询问用户想使用哪家联系人信息增强服务提供商。如果用户需要建议，可参考以下内容：

• 有 LinkedIn URL 吗？ → 选择 LinkedIn 信息增强效果最佳的服务提供商
• 需要尽可能高的电子邮件命中率吗？ → 按顺序尝试多个来源的瀑布式服务提供商
• 注重预算吗？ → 查看每次匹配的积分费用
• 需要手机号码吗？ → 确认服务提供商涵盖电话号码数据
• 想要最大覆盖范围吗？ → 先运行一家服务提供商，再用第二家处理未匹配项

如果用户不知道从何入手，references/ 中提供了带有本地参考文档的预配置选项。

工作流

步骤 0：确认服务提供商并了解 API

1. 询问用户想使用哪家联系人信息增强服务提供商
2. 获取或阅读服务提供商的 API 文档，并确定：
   • 信息增强端点（单条和批量）
   • 必需的输入字段（LinkedIn URL、姓名、域名等）
   • 身份验证方式和凭据
   • 吞吐量限制和请求约束
   • 响应格式（电子邮件、电话号码、验证状态）
   • 积分／定价模式
3. 请用户提供其 API 凭据并确认访问权限
4. 规划实现方案，并在继续之前向用户确认

步骤 1：加载人员数据

选项 A：从 Extruct 人员表获取（推荐） — 使用 extruct-api 技能从人员表中获取数据。从每一行提取 full_name、profile_url、role 和 parent_row_id。将全名拆分为名和姓。

选项 B：从 CSV 获取 — 读取 claude-code-gtm/csv/input/{campaign}/people_linkedin.csv。

步骤 2：检查积分

运行信息增强之前，使用步骤 0 中确定的端点，检查用户在所选服务提供商处可用的积分或配额。根据需要增强信息的联系人数量，提供费用估算。

步骤 3：运行信息增强

使用所选服务提供商的 API（来自步骤 0）：

1. 按服务提供商要求的格式准备联系人数据（LinkedIn URL、姓名 + 域名等）
2. 根据服务提供商的速率限制，分批提交联系人
3. 如果服务提供商使用轮询来获取异步响应，则进行相应处理
4. 收集结果：电子邮件、电话号码、验证状态
5. 跟踪已匹配和未匹配的联系人

如果用户需要瀑布式处理（使用两家服务提供商），先运行第一家，收集未匹配项，再用第二家处理这些未匹配项。

步骤 4：去重和清理

按电子邮件去重。筛除：

• 没有电子邮件的条目
• 服务提供商标记为验证无效的结果

步骤 5：输出联系人 CSV

将增强后的联系人保存到 claude-code-gtm/csv/input/{campaign}/contacts.csv，列包括：

• first_name、last_name、email、email_verified、job_title、company_name、domain、linkedin_url、phone、location、source

步骤 6：与用户一起审查

呈现摘要：

Enrichment Results:
- Contacts submitted: N
- Emails found: N (X% hit rate)
- Emails verified: N
- Phones found: N
- No match: N
- Provider: [chosen provider]

展示 10 位联系人的示例供抽查：

姓名	职位	公司	邮箱	电话	来源
...	...	...	...	...	...

询问：

• “命中率可以接受吗？（>60% 算不错，>80% 很好）”
• “要不要使用其他提供商处理未命中的联系人？”
• “准备好继续进行 email-generation 了吗？”

API 参考

预先配置的提供商文档位于 references/ 目录中。对于其他提供商，文档会在步骤 0 中获取。