用途：补全 HubSpot 联系人和公司上缺失的国家、州、城市字段。地理数据可用于区域分配、区域报表和合规（GDPR、州隐私法）。
前提条件：需要 HubSpot 私有应用访问令牌（.env 中的 HUBSPOT_ACCESS_TOKEN），具备联系人和公司读写权限；Python 3.10+ 与 uv；已先运行 /standardize-geo-values 统一地理值格式。
增强方式：方式一，HubSpot 工作流增强（最简单），使用 Operations Hub 数据质量工具或 Breeze Intelligence（若套餐支持）自动填充，触发条件为 country 未知且 email 已知，增强成功则完成，失败则分支转人工复核。方式二，基于 API 的公司域名查询，对有关联公司但无地理数据的联系人，把关联公司的 country/state/city 复制到联系人。方式三，外部数据源，使用 /waterfall-enrich-contacts，提供可插拔供应商适配器（默认 FullEnrich，另含 Apollo、Hunter、Dropcontact，或自带）、单次费用上限、不覆盖保护和 CSV 审计记录；外部查询按联系人消耗额度，内部数据免费，应先穷尽方式一、二。
使用步骤：Stage 1 规划，按数量、套餐层级和预算选择方式并与用户确认，确认只填充空字段的不覆盖规则。Stage 2 评估缺口，统计缺失国家、州、城市的联系人数量，按来源细分，改前先导出 CSV 基线。Stage 3 执行，按每批 100 条处理以遵守速率限制，并用 /standardize-geo-values 格式校验增强值。Stage 4 验证，重新统计缺失数并计算改善比例，抽查 20-30 条准确性，建立新联系人卫生工作流防止未来缺口。
回滚：若增强数据不准确，按 hs_lastmodifieddate 范围筛选被增强的联系人并清空地理字段；运行前保留原始数据备份。提示：表单提交的 IP 地理信息已由 HubSpot 存于 ip_city、ip_state、ip_country，标准字段为空时可复制；不要用增强数据覆盖手工录入的地理数据，写入前始终检查是否为空。具体价格、套餐限制与外部供应商费用资料未提供。