核心用途
activecampaign-claw 是面向 ActiveCampaign 用户的深度分析型技能，将营销自动化平台的原始数据转化为可执行的洞察。它通过 50 余个专业脚本，覆盖三大核心场景：
营销运营：列表健康审计（跳出率、域名分布、重复联系人检测）、营销活动后验分析（主题行效果、发送时间优化、点击率衰减）、自动化漏斗诊断（步骤流失、注册停滞）、标签/自定义字段/细分 hygiene 清理。
销售管理：线索热力评分（综合参与度+成交阶段+内容深度）、管道 hygiene（逾期商机、阶段分布瓶颈）、MQL→SQL 转化诊断、按来源统计赢单/输单率。
合规与运维：GDPR 数据主体导出、退订/同意合规审计、账户快照与对比、Webhook 可用性检测。
显著优点
1. 账户校准机制：首次安装运行 calibrate.py 扫描账户结构（列表、标签、自定义字段、自动化、管道）并建立 90 天性能基线，后续所有分析均基于用户实际数据的中位数对比，而非行业泛泛指标。
2. 安全优先设计：
- 默认只读分析，所有脚本不修改数据
AC_READ_ONLY=1环境变量可物理阻断写入层- 写入操作需显式确认，单次进程默认最多 10 次写入，删除操作独立二次确认
- 完整审计日志（
writes.jsonl）记录每次修改的端点、方法、载荷哈希
3. 工作流配方（Recipes）：非裸端点调用，而是封装为「早间简报」「欢迎系列设计」「列表健康审计」等场景化工作流，降低使用门槛。
4. 嵌入式领域知识：frameworks/ 目录包含邮件最佳实践、细分理论等策略框架，使 AI 输出具备资深营销顾问的专业判断。
局限性与风险
API 能力边界（非本技能缺陷，需用户理解）：
- 无法通过 API 发送活动或创建自动化流程——技能输出为「设计规格书」，需用户在 AC UI 中手动搭建
- 部分端点（商机、任务、备注、B2B 账户）受 AC 套餐层级限制，遇 403 会友好退出而非报错
/messageActivitiesengagement 数据在部分套餐不可用，脚本自动降级为点击数据分析，可能导致「零打开但有点击」的显示
数据依赖风险：
- 严重依赖
state.json校准文件，超过 30 天未更新时建议重新校准，否则基线对比可能失真 - 商机阶段停留时长无法计算（AC v3 API 不暴露阶段变更时间戳）
运维注意：
- 需自行管理 API Token 安全，建议使用最小权限集成用户而非管理员账户
- 默认 5 req/s 速率限制，大规模账户导出可能需要较长时间
适合人群
- B2B 营销运营：负责线索培育、邮件序列优化、参与度分析的营销经理
- 销售运营（Sales Ops）：管理管道 hygiene、商机优先级排序、销售漏斗诊断的 RevOps 团队
- CRM 管理员：需要定期审计账户结构健康度（重复标签、废弃自动化、字段膨胀）的技术运营
- 合规专员：执行 GDPR 数据主体请求、退订审计的数据保护负责人
常规风险
- 误删风险：尽管有多层确认，用户在显式授权下仍可执行删除操作，需理解「标签合并」「字段删除」的级联影响
- 数据泄露风险：
state.json和审计日志可能包含账户结构信息（不含 PII），需确保文件权限（0600）和存储安全 - 分析误读风险：engagement 数据在 API 受限时自动降级为点击-only，用户需理解报告中「零打开」的技术原因而非真实表现