用途:按用户给定的业务类型、地理范围和数量,构建并筛选本地商户潜在客户名单。仅做调研,不代表获准发送外联或导入 CRM,除非用户明确要求。
主要能力:通过 /datasets/google-map-businesses/search 做批量发现,用 /facets?facet=category 获取精确、可能本地化的分类标签;数据集搜索支持 page_size 最大 100、结果窗口 10,000 条,半径搜索需 lat、lon、radius_m(最大 50,000 米)。数据集结果稀疏或需最新数据时,可用实时 Google Maps 搜索,Apple Maps 与 Yelp 可补充覆盖。支持对候选商户用实时详情刷新,并仅在需要联系或资质证据时抓取其官网。
使用方式:设置 CRAWLORA_API_KEY(来自 crawlora.net),在本技能目录或以绝对路径运行 scripts/crawlora.sh,它调用 https://api.crawlora.net/api/v1,带 x-api-key 并打印 JSON。参数见 reference/endpoints.md,各提供商的地理与分页字段不同。示例: scripts/crawlora.sh /datasets/google-map-businesses/search q=coffee city=Cambridge country=US page_size=10 实时搜索示例(body 字段为扁平结构,不嵌套在 mapSearchOption 下): scripts/crawlora.sh -X POST /google/map/search '{"keyword":"coffee cambridge massachusetts","language":"en","country":"us"}'
去重与输出:先按提供商 ID 去重;跨源合并需比较标准化名称、地址、域名和电话,证据一致才合并,仅共享连锁官网不视为同一分店。输出表格或 CSV 可选列包括 business_name、provider_ids、address、website、public_phone、public_email、rating、review_count、qualification_evidence、source_urls、retrieved_at、refresh_status,并区分数据集刷新时间与检索时间。
限制:permanently_closed=false 仅排除已知关闭,仍含状态未知(null),不保证全部营业。rating 为 null 表示未知,不得当作 0;数据集只有最低评分筛选,无最高评分,需在本地实现“低于四星”规则并排除未知评分。Google 评论接口仅返回第一页小样本。无固定地址的服务区域商户可能缺坐标,半径查询无法发现,需改用文本或区域搜索。不要推断邮箱,也不得声称已验证可送达。Google Maps 调用至少间隔 1 秒;429 需退避,瞬时 5xx 重试一次;401/403 停止。某一来源失败时保留可用结果并标记未刷新行。数量不足时应如实报告,不用弱匹配凑数。