用途:为 HubSpot 联系人补全缺失的邮箱、电话和职位,数据来自外部增强服务商,写回时保留完整审计记录。内部增强技能只能搬运门户已有数据,当字段在 HubSpot 中完全不存在时,才需要外部增强,且每次查询都产生费用,因此该技能围绕成本上限、预览和输入确认设计。
主要能力:服务商层可插拔,默认 FullEnrich(跨 20+ 来源的瀑布式聚合),另含 Apollo、Hunter、Dropcontact 适配器及自定义模板。通过环境变量 ENRICHMENT_PROVIDER=apollo 切换。脚本分三阶段:before.py 统计候选并打印成本上限(只读);execute.py 选取候选、要求输入 ENRICH 确认后调用适配器、计算写入、再要求输入 WRITE 确认后批量更新并写审计 CSV;after.py 对比基线并抽查。
使用方式:需 HubSpot 私有应用令牌(HUBSPOT_ACCESS_TOKEN,含联系人读写权限)、Python 3.10+ 与 uv、所选服务商的 API 密钥。配置项包括 ENRICHMENT_TARGET_FIELD(phone/email/jobtitle)、ENRICHMENT_MAX_CONTACTS(默认 100)、ENRICHMENT_OVERWRITE(默认 false)、ENRICHMENT_CREDITS_PER_CONTACT。运行命令:uv run skills/waterfall-enrich-contacts/scripts/before.py 等。
限制:增强会把联系人姓名和公司数据发给第三方并导入个人数据,运行前须确认符合数据处理协议及 GDPR/CCPA 等隐私规则。默认不覆盖已有非空值。瀑布式服务商为异步,轮询期间不要中断脚本,提交即消耗额度。匹配率 40-70% 属正常。补全的邮箱不等于营销同意。回滚可依据审计 CSV 的旧值批量恢复。具体价格与平台细节暂未提供。