核心用法
activecampaign-claw 是一款面向营销人员和销售团队的 ActiveCampaign 深度分析工具，通过 v3 API 对接，提供 50 余种专业报告能力。首次使用需运行 calibrate.py 扫描账户，建立包含列表、标签、自定义字段、管道、自动化及 90 天基准指标的 state.json 文件。
主要功能分四大板块：
- Performance Analysis：营销活动复盘、主题行分析、发送时间优化、疲劳度检测、域名参与度分析（Gmail vs Outlook）、参与度衰减追踪
- List & Contact Health：列表审计、重复联系人查找、角色邮箱检测、字段完整性分析、休眠联系人识别、新订阅者质量评估
- Lead Scoring & Sales：热门线索排序、交易下滑预警、MQL→SQL 转化诊断、输赢归因分析
- Automation Hygiene：孤立自动化检测、漏斗步骤流失分析、多自动化重叠检测、停滞注册识别
工具采用分析优先设计：50+ 脚本默认只读，通过 AC_READ_ONLY=1 可强制锁定只读模式。修改操作需经显式确认，单次写入上限 10 条，所有变更记录至 writes.jsonl 审计日志。
显著优点
1. 嵌入式领域知识：内置资深营销/销售专家知识库，可直接回答"该用标签还是自定义字段""主题行为何下滑"等策略问题
2. 账户校准机制：首次运行建立基准线，后续报告均基于用户历史表现对比，而非泛泛的行业平均值
3. 多层架构设计：Recipes（工作流）→ Frameworks（策略理论）→ References（API 文档），匹配不同深度需求
4. 合规就绪：内置 GDPR 第 15 条数据主体导出、退订/许可审计、Webhook 可达性检测
5. 防御性编程：单进程写入上限、显式确认流程、删除二次确认、dry-run 默认模式
潜在局限
- API 能力边界：无法通过 v3 API 发送活动或创建自动化（仅可读取结构、注册联系人），需用户在 AC UI 中执行最终操作
- 计划层级限制：Deals、Tasks、Saved Responses、B2B Accounts 等端点受 AC 订阅层级限制，遇 403 会友好退出而非报错
- 数据完整性限制：无法读取网站跟踪页面访问、垃圾投诉数据；部分计划缺失
/messageActivities端点，导致打开率分析退化为点击-only 模式 - 交易阶段时长：v3 API 不暴露阶段移动时间戳，无法计算 time-in-stage 指标
- 速率限制：5 req/s，大规模账户导出需分页等待
适合人群
- 营销运营人员：日常列表健康审计、活动复盘、发送策略优化
- 销售团队负责人：管道卫生管理、热门线索识别、交易下滑预警
- CRM 管理员：标签/字段/列表治理、自动化 hygiene 维护、重复数据清理
- 合规与数据团队：GDPR 主体权利响应、订阅许可审计、数据导出
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据泄露 | API Token 泄露可导致账户数据暴露 | 使用最小权限集成用户，非管理员；Token 存储于环境变量 |
| 误删数据 | 批量删除联系人/交易/标签 | 删除需二次确认；优先用标签抑制替代删除；单次写入上限 10 条 |
| 覆盖写入 | 重复运行脚本导致数据覆盖 | 显式确认流程；audit log 可追溯 |
| 合规违规 | GDPR 数据处理不当 | 内置 SAR 导出工具；退订审计脚本 |
| 注入攻击 | API 返回数据含恶意内容 | 所有写入经 `_ac_client.py` 清洗；禁止直接 shell 插值 |
| 计划超支 | 高频 API 调用触发 AC 速率限制 | 内置退避重试；5 req/s 限速 |