用途
Verified Email Finder 用于构建经过验证的企业邮箱列表。它根据用户提供的起始输入，将其路由到合适的 Apify Actor，并在同一次运行中开启线索丰富与邮箱验证附加功能，从而返回已验证的企业邮箱。验证在同一个 Actor 运行内完成，无需第三方验证器（Hunter、NeverBounce、Apollo）。
主要能力
- 支持三种输入来源：位置 + 业务类型（Google Maps）、关键词/搜索查询（Google SERP）、用户已有的 URL 列表。
- 三种路由共用相同的三个附加字段，因此验证行为一致：
- maximumLeadsEnrichmentRecords（每域名/企业最大联系人数，默认 3，最小 1）
- leadsEnrichmentDepartments（部门过滤数组，可为空表示任意）
- verifyLeadsEnrichmentEmails（始终为 true，不可设为 false）
- 部门过滤支持：c_suite、product、engineering_technical、design、education、finance、human_resources、information_technology、legal、marketing、medical_health、operations、sales、consulting。
- 结果范围过滤（仅影响运行后筛选，不影响 Actor 运行方式）：
- verified-only（默认）：仅保留 emailVerification.result == "ok" 的线索
- verified-plus-catchall：ok 加 catch_all
- all-emails：邮箱非空即可
- with-phone：电话非空即可
- everything：保留全部线索
- 强制虚假匹配过滤：丢弃 companyWebsite 主机名与来源 URL 主机名不一致的线索。
- 去重：按小写邮箱分组，保留首次出现并合并来源；无邮箱的 with-phone 行按小写电话去重。
- 空结果呈现：若部门过滤导致某域名零线索，仍插入一行并标注 "no leads matched filter"，不静默丢弃。
- 输出格式：CSV 或 JSON，输出行包含 16 列（含 Departments）。
- 溯源：每行填充 Source 列，并在 run_metadata.json 中携带 Apify runId 与 datasetId。
使用方式
工作流分为五步：
- 收集六个必需锚点输入：起始输入类型、实际输入内容、部门过滤、每域名最大联系人数、输出格式、结果范围。
- 路由到正确的 Actor：
- 位置 + 业务类型 → compass/crawler-google-places
- 关键词/搜索查询 → apify/google-search-scraper
- 已有 URL 列表 → vdrmota/contact-info-scraper
- 若锚点不明确，先追问一次再运行。
- 构建 Actor 输入，始终设置上述三个字段。URL 列表需预先校验为 http/https 且可解析，无效项在输出中标注为 skipped。
- 运行 Actor 并等待。Maps 与 SERP 运行可能耗时数分钟，大任务需提高超时。
- MCP 路径（Claude 会话默认）：使用 call-actor 与 get-dataset-items 工具，callOptions 可设 {"timeout": 1800, "memory": 4096}。
- 脚本路径（CLI/定时/非 Claude）：需 .env 含 APIFY_TOKEN，Node.js 20.6+，命令示例：
node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js
--actor "ACTOR_ID"
--input 'JSON_INPUT'
--output YYYY-MM-DD_verified-emails.csv
--format csv
--timeout 900
- 过滤、去重并渲染：先应用强制虚假匹配过滤，再按结果范围过滤，然后去重，最后渲染输出。
适用场景
- 从 Google Maps 商家列表获取本地线索（含地址、电话、营业时间）。
- 从 Google 搜索结果中提取排名网站的联系人。
- 对已有域名列表进行邮箱查找（最省成本，无发现步骤）。
- 冷邮件营销（推荐 verified-only）、电话营销（with-phone）等。
限制
- 邮箱验证仅对决定性结果（ok / invalid / disposable）收费；catch_all / unknown / error 免费。线索丰富按成功提取的线索收费。具体费率需查看 Apify 控制台，随订阅层级和时间变化。
- 脚本路径需要 .env 文件含 APIFY_TOKEN 及 Node.js 20.6+。
- 缺失的数据集字段保持空白，不编造。
- 若锚点 #1 不明确，必须先追问再运行，不得猜测路由。
- 不得以 verifyLeadsEnrichmentEmails: false 提交运行。
- 错误处理详见 reference/troubleshooting.md。
- 更多示例与参考：examples/example-maps-input.md、examples/example-search-input.md、examples/example-url-list-input.md、reference/apify-actor-usage.md、reference/output-formats.md。