用 API 查客户联系方式 · AI 能力沉浸体验课

主线需联网

准备待查询的公司域名

只把已经核验为潜在客户的公司交给联系方式 API。

约待实测

操作步骤

从 Day1 的 Google、Google Maps 或 LinkedIn 目标客户结果中选 3 家已经打开官网核验过的公司。
新建 contact-lookup-targets.csv，表头固定为 domain,org_name,buyer_fit,evidence_url。
每行填写官网域名、公司名、为什么像目标客户和对应证据页；没有官网证据的公司不要放入。

完成标志

contact-lookup-targets.csv 含 3 个去重域名，每行都有公司名、买家匹配理由和官网证据 URL。

人工边界

只记录公开公司信息；不先猜姓名、邮箱或电话，不把搜索摘要当作官网证据。

我已完成并核对这一节

主线需联网

调用第一个 Demo API

看懂一次 API 调用里的地址、方法、参数、状态码和 JSON 响应。

约待实测

操作步骤

打开老师提供的 Demo API 文档，找到示例 endpoint、HTTP method 和参数。
在终端运行文档中的 curl 示例，把响应保存为 demo-api-response.json。
打开 demo-api-response.json，指出本次请求的 endpoint、method、status 和主要返回字段。

完成标志

demo-api-response.json 是一次成功请求返回的合法 JSON，并能说清 endpoint、method、参数、状态码和响应字段。

人工边界

只调用课程 Demo API；不把真实 API Key 写进命令历史、响应文件、聊天或截图。

我已完成并核对这一节

主线需联网

让 Agent 查询联系方式

把已核验公司域名交给联系方式 API，得到结构化联系线索。

约待实测

读取 contact-lookup-targets.csv，并使用老师提供的联系方式 API 文档和已经在本机配置好的 API 凭据。先告诉我将查询几个域名、会调用多少次接口以及是否消耗额度；在我明确确认之前不要发出真实请求。确认后逐个查询，把结果写入 contact-results.csv，表头固定为 domain,org_name,contact_name,title,email,phone,source_url,api_status,verification_status,notes。API 没返回的字段留空；没有来源链接时把 verification_status 写成 api-unverified；未找到时保留该公司一行并写 not-found。不要猜测姓名、邮箱或电话，也不要输出凭据、请求头或完整原始响应。

完成标志

contact-results.csv 覆盖 contact-lookup-targets.csv 中全部域名，找到、未找到和未核验状态均明确，且没有猜测联系方式。

人工边界

只查询公开 B2B 工作联系方式；真实请求及额度消耗必须先经人工确认；API Key 只保存在本机，不进入聊天、日志、截图或产出文件。

我已完成并核对这一节

主线需联网

核验 API 返回的联系方式

区分 API 返回值、公开页面证据和仍未核验的联系线索。

约待实测

操作步骤

复制 contact-results.csv 为 verified-contact-results.csv，保留全部原始行。
逐行打开 source_url 或公司官网公开页面，核对公司域名、联系人岗位和联系方式是否对应。
把 verification_status 更新为 verified、api-unverified、not-found 或 mismatch；无法核验时不要删除原记录。

完成标志

verified-contact-results.csv 保留全部查询结果，并为每行给出可追溯的核验状态。

人工边界

只核验公开职业信息；不添加私人联系方式，不自动发送邮件、加好友或提交表单。

我已完成并核对这一节