用途:当公司清单只有名称、没有域名,而下一步(数据丰富、去重、CRM 导入)需要域名时使用。输入支持 CSV/TSV、纯文本列表或聊天中粘贴的名称;CSV 需明确指定公司名称列。超过约 40 个名称时,应先告知用户每个名称是一次 HTTP 调用并确认后再开始。
主要能力:通过免费 Clearbit 自动补全端点解析域名,地址为 https://autocomplete.clearbit.com/v1/companies/suggest?query=<name>,无需密钥和认证,最多返回 5 个匹配、最佳猜测在前,无匹配返回 []。该端点是无文档的 typeahead,并非签约 API,应控制用量、放慢请求节奏,首次批量前阅读 references/endpoint-behavior.md,其中说明两种会静默污染列表的失败模式。
使用方式:一两个名称可直接用智能体的网页抓取工具查询并内联报告匹配结果,多个结果同名时需标注。批量时使用 references/resolver-script.md 中的解析脚本,按 plan → fetch → merge 运行:先按规范化键去重、查询前去掉法律后缀,再为每行评分。若环境阻止直接 HTTP,脚本的 plan 输出会列出 URL,可用网页抓取工具每批并行抓取 5–8 个,再把响应送回 merge 步骤。
置信度标签:exact(名称与域名都匹配且排第一,无需复核)、strong(唯一结果的域名与名称匹配,无需复核)、plausible(多个 TLD 上同一 slug,选了 gTLD,需抽查)、ambiguous(多个同名公司不同域名,需复核)、weak(没有对齐,顶部结果是猜测,需复核)、none(空响应,不在索引中,需复核)。
报告要求:给出各置信度计数,列出需复核的具体行及其备选。若 weak 加 none 超过列表三分之一,应明确说明输入可能含内部简称、DBA 名称或索引未覆盖的公司;对这些行可提议(不要自动执行)用网页搜索“<公司名称> official site”做第二轮。域名是数据丰富和 CRM 去重的连接键;人员级数据需交给真正的丰富步骤,该端点只返回名称和域名。
限制与规则:必须为每个已解析行附置信度标签,绝不返回裸的名称→域名列表;空响应须记为明确的 no-match,与从未抓取的行区分;绝不把 weak、ambiguous、none 行无人值守写入 CRM;绝不把该端点输出当作权威公司数据或承诺可获取 logo。常见错误是直接查询原始名称,法律后缀会破坏结果,如“Stripe Inc.”返回 stripe-inc.jp(错误公司),“Bright Data Ltd”无结果,而“Stripe”和“Bright Data”都能干净解析,因此每次查询前应去掉结尾的 Inc/Ltd/LLC/GmbH/Corp/Holdings/Group。