Claude Code 建潜客名单：Firecrawl 实战

摘要：在 Claude Code 里建潜客名单，可以把工作拆成四条看板任务：通过 Firecrawl Alexandria 免费跑 Apollo 人员搜索，对搜索已经返回的字段做一轮筛选，只对留下来的线索用 People Data Labs 做付费补全，最后在任何外联之前交给人审核。一把 Firecrawl key 覆盖所有数据提供方，每条任务都会报告自己花了多少。

你也可以在 Claude Code 里用一个很长的会话建潜客名单。你说「找这十家公司里负责工程的 VP，要工作邮箱」，Agent 就去搜索、补全，最后交回一个 CSV。问题从账单开始：Agent 花钱补全了那些光看职位就该被删掉的人。

Firecrawl Alexandria 让「先便宜、后付费」的顺序容易强制执行。它把几百个数据提供方放在一把 Firecrawl API key 后面，规则本身也很清楚：发现工具免费，执行时按每个工具标出的 credits 计费。本文把这条流水线拆成 HiFox 上的任务，用 Claude Code 或 Codex 作为 Runtime，并列出每个阶段的 credits 成本。

Firecrawl Alexandria 能给建名单的 Agent 什么

Firecrawl Alexandria 是一个数据提供方库，Agent 通过一把 Firecrawl key 就能调用。Alexandria 页面列出 400 多个提供方和 2,500 多项能力。Agent 可以免费发现工具，读它的输入和价格，然后用与抓网页相同的 scrape 端点执行。

做潜客名单，重要的是 People 这一类。它有 12 个提供方，包括用于补全的 Apollo、People Data Labs、FullEnrich 和 Data Legion，也包括制裁名单、NPI Registry 这类公开来源。本文用到其中两个：

Apollo 在 Alexandria 上的页面列了一个内置技能「Search-first prospect list」。它的说明用一句话概括了整套策略：先免费搜索，只揭开值得付费的人，再按成本从低到高找可验证的工作邮箱。下面的看板把这句话变成四条有处理人的任务。

为什么名单需要分阶段，而不是一个大提示词

一个会话会把真正决定成本的那一步藏起来：谁在付费调用之前被删掉。Firecrawl 的价格让差距变得具体。

假设 Apollo 在你的十个域名下返回 40 个人。按每人 60 credits 全部补全要 2,400 credits，是 Free 套餐每月 1,000 credits 的两倍多。如果先按职位筛一轮，只留下 12 人，补全只要 720 credits，Free 套餐就装得下。

这条删除规则是业务判断。得有人决定「Head of Platform」算不算买家。它埋在提示词里时，没有人审；它变成一条有处理人的任务时，就有负责人、状态和变更记录。

怎么用 Agent 建名单：四条任务

下面是看板上的流水线。用阻塞 / 被阻塞标出先后顺序。它们只表达依赖，不会自动卡住执行或改状态；每个阶段仍要按完成情况手动或由自动化推进。

第 1 步：把 ICP 变成一次免费的 Apollo 搜索

第一条任务把你的理想客户画像变成 Apollo 的搜索输入。这个能力接收 person_titles、q_keywords、q_organization_domains_list、page 和 per_page，每页最多 100 条结果。Apollo 的 playground 显示这次调用是 0 credits。

发现工具同样免费。如果 Agent 不知道该用哪个工具，就带 sources: ["alexandria"] 去问 Alexandria。Firecrawl 的文档提醒，把 "web" 加进 sources 也会返回付费的网页结果，所以发现阶段只留工具。

# Free tool discovery: tools only, no paid web results
curl https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "find people by job title at a company", "sources": ["alexandria"], "limit": 3}'

# Apollo people search at the target domains (listed at 0 credits)
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "apollo",
    "capability": "people/search",
    "options": {
      "person_titles": ["VP of Engineering", "Head of Platform"],
      "q_organization_domains_list": ["example-one.com", "example-two.com"],
      "page": 1,
      "per_page": 100
    }
  }
}'

结果落在 alexandria[0].data 下。Firecrawl 的文档要求在使用每个工具结果前先检查错误，所以把它写进验收标准：Agent 贴出行数，并说明它遇到的任何错误，这条任务才算完成。

第 2 步：只用搜索已返回的字段做筛选

筛选任务不花钱。它读取搜索结果，只根据手上已有的数据删行：职位不对、公司不对、同一个人重复。不再发起新调用。

把删除规则放在每个 Agent 都会读的地方。HiFox 的技能可以打包 Agent 工作可复用的指令，于是规则变成一个技能，绑定到每个建名单的 Agent 上，具体做法见这篇技能说明。

# lead-rules.md (owner: the person who approves the send)
keep_titles: ["VP of Engineering", "Head of Platform", "Director of Engineering"]
drop_if: [title_not_in_keep_titles, company_domain_not_in_list, duplicate_person]
max_enrich_calls_per_run: 15
pdl_min_likelihood: 6
every_task_reports: [rows_in, rows_out, credits_spent, errors]

第 3 步：只补全留下来的线索

这是付费阶段。People Data Labs person/enrich 标价每次调用 60 credits。只要有 pdl_id、email 或 email_hash 之一就能调用，另外还有 18 个可选字段。让 Agent 先用 findTools 读完整的输入契约，再把搜索字段映射到补全输入。

最能控制账单的设置是 min_likelihood。它从 1 到 10，默认 2；Firecrawl 说默认值下，只有 10% 到 30% 的匹配结果是正确的人。调高之后，弱匹配会变成 404，提供方页面把好处说得很直接：「这里 404 免费，错记录不免费。」

// One enrich call per qualified person; client set up with $FIRECRAWL_API_KEY
const result = await firecrawl.scrape({
  alexandria: {
    provider: "people-data-labs",
    capability: "person/enrich",
    options: {
      email: person.email,      // or pdl_id / email_hash
      min_likelihood: 6,        // weak matches 404 instead of billing a wrong record
      titlecase: true,
    },
  },
});
const record = result.alexandria[0];
if (record.error) report.errors.push(record.error);

People Data Labs 通过 Alexandria 还有配额：每个客户组织每年 50,000 次 API 调用，person 和 company 端点共用。重试也算，配额在每年 1 月 1 日 UTC 重置。这也是要在规则文件里限制每次运行补全次数的原因。

如果调用失败并返回 THIRD_PARTY_DATA_TERMS_REQUIRED，响应里会带 requiresAction.url。组织管理员要去那里接受提供方条款，Firecrawl 的文档说 Agent 必须先得到用户明确授权才能接受条款。把它当成一次交接：Agent 让任务停在等待人工回复。

第 4 步：外联之前由人审核

最后一条任务属于人。Agent 附上补全后的名单，把任务留在等待人工审阅。审核人抽几条对照公开资料，删掉不该联系的人，然后批准。

这和编程 Agent 的审批关卡是同一道门。名单是数据；联系某个人是需要人签字的决定。

每个阶段的 credits 账单

十个目标域名、找到 40 人、12 人通过筛选，按标价算出来是这样：

把 credits 换算成美元要看套餐，不要把套餐差异四舍五入掉。按 Firecrawl 定价页，按月付费时 Hobby 是 19 美元 5,000 credits，每个 credit 0.0038 美元，720 credits 大约是 2.74 美元的套餐额度。Standard 是 99 美元 100,000 credits，每个 credit 0.00099 美元，同样一次运行大约 0.71 美元。Free 套餐每月 1,000 credits，这次运行花 0 美元就装得下。

如果没有筛选任务，同一次运行是 2,400 credits：Hobby 上大约 9.12 美元，而且超过 Free 套餐的额度。筛选是账单上最便宜的一行，却省得最多。

HiFox 如何让这条流水线可核查

Claude Code 或 Codex 负责调用。HiFox 负责承载这条流水线。

• 任务和处理人。每个阶段都有状态和负责人，不管这个人是 Agent、小队还是成员。
• key 不写进任务正文。把 FIRECRAWL_API_KEY 加到 Agent 设置的环境变量里，Agent 进程启动时会注入。HiFox 把这些值作为授权管理者可查看和编辑的明文配置，不是密钥保管箱；值默认隐藏，需要时再显示。用一把只覆盖这项工作的 key。
• 审阅状态。Agent 可以让任务停在等待人工回复或等待人工审阅；关联对话的交接会实时显示在主侧栏的「对话」，并通过桌面横幅和飞书 / Slack 提醒触达负责人。
• 运行记录。每次运行都会显示开始和结束时间、工具调用和失败详情，credits 报告背后有迹可查。

如果你不想手工建四条任务，小队队长可以判断要不要拆分，并在评论里 @ 成员分工；四张任务卡仍由你建，或让队长在评论里列出阶段，具体见这篇小队说明。HiFox 可以免费开始用，以官网定价为准。模型用量由你 Runtime 上已有的 Claude Code 或 Codex 提供，具体计费方式待核实。

按计划运行，审核仍然手工

四条任务稳定跑上一周后，把第 1 到第 3 条放进自动化，用任务状态变化或 Webhook 作为触发条件：新的域名列表进入任务后，触发免费搜索和限额补全。第 4 条保持手工。想同时看多个这样的运行，见怎么监控并行运行的编程 Agent。

从免费阶段开始

照 Apollo 技能描述的方式用 Agent 建名单：免费搜索，用已有字段筛选，只为留下来的人付费，在任何人被联系之前把人放进名单。先从 HiFox 里的第 1、2 条任务开始。它们花 0 credits，还能告诉你付费阶段会花多少。

常见问题

Firecrawl Alexandria 是什么？

一个数据提供方库，Agent 通过一把 Firecrawl API key 调用。发现免费，每个工具会标出自己的执行价格。Firecrawl 在 2026 年 9 月 22 日上线了它（Firecrawl 公告）。

通过 Firecrawl 用 Apollo 搜人免费吗？

Apollo 的 people/search 能力在 Firecrawl playground 里显示 0 credits。揭开联系方式是另一个付费步骤，执行前先看那个能力标出的价格。

People Data Labs 补全在 Firecrawl 上多少钱？

person/enrich 标价每次调用 60 credits。按月付费时，在 Hobby 上约 0.23 美元，Standard 上约 0.06 美元。调高 min_likelihood 后返回的 404 不收费。

能把 Claude Code 换成 Codex 吗？

可以。Firecrawl 提供 CLI、SDK 和带 firecrawl_search、firecrawl_find_tools、firecrawl_scrape 的 MCP server，Agent 可以在任一 Runtime 上运行。通用配置见「AI Agent 任务管理：谁派活，谁验收？」。

Agent 应该自己按名单发外联吗？

不应该。把发送放在人工审阅任务后面。Agent 的工作到一份可核验的名单和一份 credits 报告为止。