blitz-list-builder

Blitz 列表构建器

Prospeo 以职位为先：“寻找所有 B2B SaaS 公司的市场副总裁。”Blitz 以域名为先：“针对这 500 个餐厅域名，找出每家餐厅的所有者。”

如果你已经知道目标公司（来自 Google 地图、竞争对手 CSV 或手动整理的列表），Blitz 就能帮你找到相关人员。

何时使用 Blitz，何时使用 Prospeo

你的情况	使用
“我有 5,000 个域名，帮我找出所有者”	Blitz
“找出美国员工人数为 100-500 的 SaaS 公司的所有 CFO”	Prospeo
“我需要为同一批公司补充 Prospeo 结果中的联系人”	Blitz
“我想尽可能广泛地覆盖某个垂直领域”	Prospeo
“我正在锁定明确列出的目标客户（ABM）”	Blitz

通常的做法是：先用 Prospeo 构建初始列表，再用 Blitz 为每家公司增加 1-2 个联系人。

前提条件

• Blitz API 密钥（环境变量：BLITZ_API_KEY）——在其网站注册
• 目标公司域名列表（包含 company_domain 列的 CSV，或每行一个域名）

输入

• --domains-file=<path> — 包含公司域名的 CSV 或 txt 文件（每行一个域名，或包含名为 company_domain 的列）
• --titles=<csv> — 用于筛选的职位关键词，以逗号分隔（默认值：owner,founder,ceo,president,cto,vp）
• --out=<path> — CSV 输出路径

输出

包含以下列的 CSV：company_domain, first_name, last_name, job_title, linkedin_url, email, email_source, company_name, company_industry, company_headcount, company_phone

Blitz 返回邮箱时会填入相应字段。使用 /list-builder 第 5 阶段（scripts/contacts.ts）处理输出，补全缺失的邮箱，然后使用 MillionVerifier（/cold-email-starter-kit）进行验证。

用法

export BLITZ_API_KEY=xxx

# Pull owner/founder/CEO contacts for 5000 SMB domains
npx tsx scripts/find-contacts.ts \
  --domains-file=restaurants.csv \
  --titles=owner,founder,ceo,general-manager \
  --out=restaurant-owners.csv

# Domain-first discovery with custom title match
npx tsx scripts/find-contacts.ts \
  --domains-file=saas-companies.txt \
  --titles=vp-marketing,head-of-growth,cmo,director-marketing \
  --out=saas-marketers.csv

API 概览

我们使用 Blitz 的两个主要端点：

公司信息补充（查找员工）：

POST {BLITZ_BASE_URL}/api/enrichment/company
Body: { "domain": "acme.com" }
Response: { employees: [{ first_name, last_name, title, linkedin_url, email }], company: { name, industry, headcount, phone } }

邮箱信息补充（根据 LinkedIn URL 查找邮箱）：

POST {BLITZ_BASE_URL}/api/enrichment/email
Body: { "linkedin_profile_url": "https://linkedin.com/in/..." }
Response: { email: "...", status: "verified" }

速率限制

此脚本会限制请求速率为每秒 30 个请求，并发数为 10。这符合 Blitz 公布的限制。如果遇到 429 错误，请降低并发数。

命中率预期

大致基准（来自实际营销活动）：

• **中小企业（餐厅、诊所、美容院）：**联系人查找率为 70-80%，邮箱查找率为 40-60%
• **B2B 科技公司（员工人数为 10-500）：**联系人查找率为 80-90%，邮箱查找率为 50-70%
• **大型企业（员工人数超过 1000）：**联系人查找率为 90% 以上，但筛选出正确人员比命中率更重要
• **个体经营者／微型企业：**30-50%——通常没有公开的 LinkedIn 资料

职位筛选——使用具体关键词

默认关键词（owner, founder, ceo, president, cto, vp）范围较广。请根据营销活动缩小范围：

# Restaurants
--titles=owner,operator,general-manager

# SaaS RevOps
--titles=revops,revenue-operations,vp-sales,director-sales

# Dental practices
--titles=dentist,owner,practice-manager

# Law firms
--titles=partner,managing-partner,principal

脚本使用不区分大小写的子字符串匹配。“vp”能匹配“VP Sales”，也能匹配“VP Product”——如果范围太宽，请进一步缩小。

常见注意事项

• **域名必须是纯域名。**Blitz 需要的是 acme.com，而不是 https://acme.com/ 或 sub.acme.com。
• **大型公司返回的员工列表会被截断。**Blitz 对每个域名最多返回约 50-100 名员工。对于大型企业占比较高的列表，请改用 Prospeo 或 LinkedIn 搜索。
• **LinkedIn 数据可能已过时。**Blitz 的缓存可能有 3-12 个月的延迟。职位可能已经变更。请通过邮箱瀑布流进行验证。
• **未返回邮箱 ≠ 联系不到此人。**40% 的命中结果没有邮箱。将这些结果交给 /list-builder 第 5 阶段（scripts/contacts.ts）处理，它会按成本顺序尝试 GetLeads、Blitz 和 Prospeo。
• **速率限制错误。**429 = 已达到上限。脚本会使用指数退避策略重试，但持续长时间大量请求仍会失败。

必需步骤：使用 /icp-prompt-builder 进行资质筛选

这是必需步骤，不要跳过。

在提取超过 500 家公司的联系人之前，先抽取约 50 家，并对其运行 /icp-prompt-builder：

1. 使用 AI 资质筛选提示词评估前 10 家
2. 你提供修正意见（“这家应该是 NO，因为它是竞争对手”）
3. 优化提示词，然后运行接下来的 10 家
4. 连续 2 轮无需修正后停止——提示词已调优
5. 将调优后的提示词应用于其余潜在客户，在付费进行邮箱补全前先筛选

为什么这是必需的： Blitz 查找联系人的成本很低，但后续的邮箱补全并不便宜。一次典型的 5,000 个联系人的运行，会产生 150 美元以上的邮箱查找 API 调用费用。如果列表中有 40% 的对象不匹配，你就会白白花掉约 60 美元，为永远不会转化的公司查找邮箱。ICP 提示词构建器只需 10–15 分钟，却能省下这笔钱。

如何安全跳过： 你不能跳过。如果你确定列表已经过了完美的资质筛选（例如，列表来自你想要推介产品的一份精选目标客户名单），仍要对其中 10 家运行 /icp-prompt-builder，并确认筛选结果与你现有的判断一致——此时提示词构建器起到的是校验作用，而非筛选作用。

成本

Blitz 的定价（请查看当前费率）：

• 公司信息补全：每个域名约 0.02–0.05 美元
• 邮箱补全：每个邮箱约 0.05–0.10 美元

5,000 个域名仅联系人信息就约需 150 美元。请做好预算规划。

输出 → 下一步

拿到 CSV 后，通常按以下流程处理：

1. 去重 — 删除重复邮箱和重复的 LinkedIn URL
2. 筛选 — 删除 job_title 与 ICP 不完全匹配的行
3. 补全缺失邮箱 — 对 email 为空的行运行 /list-builder（阶段 5，邮箱）
4. 验证 — 对所有邮箱运行 MillionVerifier（MillionVerifier 脚本见 /cold-email-starter-kit）
5. 上传 — 通过 /cold-email-starter-kit 脚本 smartlead-add-leads.ts 提交给 Smartlead

脚本

• scripts/find-contacts.ts — 主要的批量信息补全脚本

接下来要做什么

运行 /list-builder（阶段 5，邮箱），为 Blitz 未返回邮箱的行补充邮箱。然后运行 /list-quality-scorecard，评定最终列表。

完成评分卡后，继续执行 /campaign-copywriting → /smartlead-campaign-upload-public。

或者暂缓： 如果必需的 /icp-prompt-builder 步骤（上文）显示资质符合率低于 40%，说明域名源列表不合适。继续消耗 Blitz 额度前，请先修正列表。

相关技能

• /icp-prompt-builder — 在运行邮箱瀑布流程前，对此技能返回的联系人进行资质筛选
• /prospeo-full-export — 以职位为优先的替代方案
• /google-maps-list-builder — 用于本地商家域名列表
• /disco-like — 根据种子域名查找相似公司
• /list-builder（阶段 5，邮箱）— Blitz 未返回邮箱时使用
• /cold-email-starter-kit → 06-list-building-prospeo.md，了解更全面的列表构建背景