已知的商家主页卡片连接到一份已核对的目录,旁边是缺失联系信息的卡片。
让缺失的联系字段保持可见。

工具设置与对照检查

在试运行中,把默认的两个主页示例清单替换为 startUrls 里一个拟使用的已知公开主页网址。

工具构建版本为 0.1.24。它接受的 startUrls 为 1 到 1000 个已知公开主页或个人资料网址,而不是搜索页或城市关键词发现。一行对应一次已尝试的输入。

输出指标包括 requestedChannels、acceptedProfileInputs、rejectedInputs、datasetRows、usefulRows、billableRows、nonUsefulRows 和 statusCounts。行字段包括 input、channelId、pageId、channelUrl、handle、displayName、alternateName、profileType、description、category、website、detectedLinks、detectedEmails、phone、email、address、profileTabs、status、statusReason、observedAt 和 isBillable。缺失字段为 null。channelId 与旧版或委托的 pageId 是不同的身份值,两者可以不一致。

对 NASA 的一次对照检查返回了已匹配的 ID、状态 ok、一段描述,以及两个检测到的 Facebook 分区链接。网站、电话、电子邮箱和地址不可用。这只证明,仅在该对照中,可选字段可以不可用。

目录创建与核验操作

  1. 在采集之前先确定目录用途和必填字段。使用一份已知的拟收录商家来源清单,其中包含本地行 ID,并记录每个网址的来源。城市搜索不在此工具范围内。人工发现是明确的前提,不是承诺的功能。
  2. 测试一个拟使用的公开主页。对照来源检查 channelId、pageId、channelUrl、displayName、profileType、status 和 statusReason。即使可选的“关于”字段被隐藏,仅返回的身份本身也可以有用。当两家商家同名时,不要仅凭名称匹配。
  3. 保留来源行和时间。将个人资料 ID 存为字符串,并单独保留旧版或委托主页 ID。对已核验的身份观察去重,但不要丢弃输入与来源清单的对应关系。
  4. 对每个必填字段记录 source_available、unavailable 或 needs_manual_check。让 website 与 detectedLinks 保持区分。Facebook 的“关于”或照片链接是个人资料分区,不是外部商家网站。detectedEmails 和 detectedLinks 是未经核验的线索,不是完整的商家联系方式集合。
  5. 如果目录需要城市服务区域或外部网站,请人工检查匹配的公开商家来源,并在单独的充实字段中记录证据、来源和时间。不要用来自 handle 的猜测城市覆盖 Actor 地址中的 null。此工具不执行这种关联网站检查。
  6. 针对所述用途定义目录行的就绪条件。例如,身份索引需要已匹配的身份;联系目录还需要一条已检查的公开联系路径;城市商家清单还需要有依据的本地相关性。让每条规则保持明确。缺少可选数据并不能证明该商家不具备该属性。
  7. 把记录分为 ready、needs_review 和 unavailable_target。分别统计已匹配身份、可用字段和就绪记录。失败的来源请求不是一条空白的成功商家记录。保留来源状态原因,以便以后可以把重试限定在相应范围。
  8. 导出有用的目录,并附上就绪原因和证据链接。需要时刷新观察结果,而不是断言该工具会提供过去的历史。本指南不发送外联,也不为商家做认证。

原创虚构示例与表格

以下文本为原创虚构。一个虚构的清洁商家目录有四个拟使用的主页。

原创虚构示例与表格
记录键已匹配身份原生状态原始网站原始地址检测到的链接人工地址 / 本地证据人工来源与检查(虚构)记录就绪状态与读者判定原因
B1已匹配 IDokhttps://example.com/b1-site (虚构)123 Main St(虚构)facebook.com/b1/about(虚构)虚构的 123 Main St,Target City,已根据其带日期的人工来源另行确认https://example.com/b1-source (2026-03-01, 本地检查)就绪(已匹配 ID,原生网站和地址存在,人工本地证据已确认)
B2已匹配 IDoknullnullfacebook.com/b2/photos(虚构)未知无人工来源与检查需要复核(已匹配 ID,原生网站/地址为 null,无人工证据)
B3无身份login_requirednullnullnull未知无人工来源与检查不可用目标(需要登录,未取回身份)
B4已匹配 IDoknullnullfacebook.com/b4/about, facebook.com/b4/photos(虚构)虚构的 8 Side Rd,Other City,已根据其带日期的人工来源另行确认https://example.com/b4-source (2026-03-02, 城市范围外)未就绪 / 超出范围(已匹配 ID,原生网站/地址为 null,链接是个人资料分区,人工检查证明在城市范围外)

三个已匹配身份并不能得到三条就绪记录。有一条就绪记录,两条需要复核或超出范围的记录,以及一个不可用目标。确切规则依据人工本地证据把 B4 排除出城市清单,而不是根据主页名称猜测。在这个虚构例子中,三个已匹配行的字段可用性是:网站为三中有一,返回的地址为三中有一。不可用目标 B3 单独报告。不要把这些分数当作真实的工具成功率。

来源和延伸阅读

作者 Chronometrica · 更新日期

返回顶部 ↑