用途:对 HubSpot CRM 门户做全面诊断审计,覆盖数据库规模、邮件送达率、数据完整度、互动健康、重复数据、负责人健康、列表与工作流、交易管道八个维度,逐项评级并给出按优先级排序的行动建议。
主要能力:统计联系人数/公司数/交易数、营销联系人占比;硬退信、软退信、全局退订、从未发信、非法邮箱格式;各类字段缺失;活跃度分布与从未互动;重复邮箱与重复公司域名;失效负责人仍持有记录;空列表、长期无注册工作流、无提交表单;缺金额/缺关闭日期/停滞交易。按受影响记录比例给出 A–F 评级,并映射到后续清理技能形成有序处方。
使用方式:在 .env 配置 HUBSPOT_ACCESS_TOKEN=pat-na1-xxxxxxxx,无需安装依赖,脚本带 PEP 723 元数据,用 uv run skills/hubspot-audit/scripts/audit_portal.py 执行;先 mkdir -p reports,报告保存为 reports/hubspot-audit-{YYYY-MM-DD}.md。
技术要点:用 NOT_HAS_PROPERTY 判断从未设置的属性;Search API 单次上限 10000 条,超出需按属性分段求和;查失效负责人需 archived=true;私有应用限 100 请求/10 秒,遇 429 做退避。
限制:API 无法原生模糊匹配公司名,只能精确去重后人工复核;聚合的邮件打开/点击率需用营销邮件统计 API 或界面查看;hs_current_customer、hs_marketable_status 为只读属性。