用途：在 HubSpot 中大规模合并重复联系人，避免数据丢失，适用于销售运营批量导入后清理重复记录、处理模糊匹配与合并后关联修复等生产场景。
主要能力：通过搜索 API 按邮箱等属性发现重复；按创建时间选择主记录，并支持退订状态与测试邮箱覆盖规则；对邮箱和电话做规范化以支持模糊匹配；合并前检查硬退信、GDPR 法律依据等合规标志；按速率限制执行合并并处理 429/5xx 重试；合并后校验 hs_email_optout 并审计、修复未自动转移的关联。
使用方式：使用私有应用令牌或 OAuth 令牌，请求头 Authorization: Bearer {your-token}，所需权限包括 crm.objects.contacts.read、crm.objects.contacts.write、crm.associations.read、crm.associations.write。依赖 Python 3.10+（requests、phonenumbers、rapidfuzz）、HubSpot Professional 或 Enterprise 账户、jq。核心调用为 POST /crm/v3/objects/contacts/search 查找重复，POST /crm/v3/objects/contacts/merge 执行合并，合并后可用 GET /crm/v4/objects/contacts/{id}/associations/deals 检查关联。
限制：HubSpot 仅在属性层面强制邮箱唯一，合并 API 无一次性去重端点，需逐对合并；大批量扫描受每日配额与突发速率限制，需设置停止阈值；合并 API 可能返回 200 但退订状态被错误覆盖，需合并后校验；自定义对象关联和部分第三方集成链接可能不会自动转移。具体价格、平台支持范围等资料暂未提供。