用途:审计 HubSpot 列表,清理未使用、空白或重复的列表定义,减小界面杂乱,避免掩盖真正重要的列表。
主要能力:通过 Lists API(v3)批量拉取列表清单,记录列表 ID、名称、处理类型(DYNAMIC/MANUAL)、成员数量、创建与最后更新时间,并导出 CSV 供审阅。可标记以下候选:创建超过 30 天且零成员、未被任何工作流、邮件或广告受众引用、名称重复或筛选条件几乎相同、名称含 test/temp/copy of/old 的测试临时列表、6 个月以上未更新的静态列表。
必要用法:先与用户确认是直接删除还是先加 "[ARCHIVE]" 前缀留待下季度删除,并确认绝不可触碰的列表(抑制列表、合规细分、活跃活动受众)。删除前须交叉核对工作流与邮件活动,零成员列表仍可能被用作注册触发器。列出候选后等待用户明确确认,再通过 DELETE /crm/v3/lists/{listId} 或界面删除。删除后重跑清单确认,并记录清理日志(名称、ID、原因),通知相关创建者。
限制:需要 HubSpot 私有应用访问令牌(.env 中 HUBSPOT_ACCESS_TOKEN),权限含 crm.lists.read,删除还需 crm.lists.write;需要 Python 3.10+ 与 uv。某些套餐层级访问 Lists API 可能返回 403,此时需在界面手动审计。HubSpot 没有列表回收站,删除不可恢复,删除前应导出列表定义(筛选条件),静态列表如需保留成员数据应先导出成员 ID。