核心功能
activecampaign-claw 是一款面向营销与销售团队的 ActiveCampaign 深度运营工具，通过 50+ 个专业脚本实现对邮件营销自动化平台的全方位诊断与分析。
显著优点
1. 分析优先的安全设计 — 默认只读模式，所有数据修改需经多重确认；支持 AC_READ_ONLY=1 环境变量强制锁定写入
2. 账户校准机制 — 首次运行自动扫描账户结构（列表、标签、自定义字段、管道、自动化），建立 90 天性能基线，后续对话基于真实数据而非冷启动
3. 营销全链路覆盖 — 从列表健康审计、送达率分析、主题行优化，到线索评分、管道卫生、MQL→SQL 转化诊断
4. 可审计的写入控制 — 单进程写入上限（默认 10 次）、独立审计日志（writes.jsonl）、SHA-256 载荷摘要，删除操作需额外确认
5. 工作流配方（Recipes） — 预置参数化工作流（欢迎序列、每日简报、重新激活 campaign），降低专业运营门槛
潜在局限
- API 功能限制：无法通过 v3 API 直接发送邮件或创建自动化（仅支持设计蓝图，需在 AC UI 手动实施）
- 功能分层限制：Deals、Tasks、Saved Responses、B2B Accounts 等高级功能需对应 AC 订阅层级，脚本遇到 403 会优雅退出
- 数据可见性缺口：站点追踪页面访问、垃圾邮件投诉数据、Deal 阶段停留时长等关键指标无法通过 API 获取
- 部分终端 404 降级：
/messageActivities未开通时，互动分析自动降级为仅点击数据（无打开事件）
适合人群
- 日活 ActiveCampaign 用户，需超越基础报表的深度运营洞察
- 缺乏专职数据分析师的中小营销团队
- 销售运营（Sales Ops）需管道健康度与线索优先级自动化评估
- 合规敏感行业需 GDPR Article 15 数据主体导出、退订审计功能
常规风险
- 凭证泄露：
AC_API_TOKEN需通过环境变量注入，避免硬编码；建议使用最小权限集成用户（非管理员） - 误操作数据：尽管有多重防护，批量标签合并、联系人去重等操作仍需谨慎确认
- 基线漂移：账户结构变化后需月度重新校准（
state.json>30 天自动提示） - 第三方依赖：Python 3 环境、网络可达性、AC API 稳定性
安全架构亮点
| 层级 | 机制 |
|------|------|
应用层 | 只读默认 + AC_READ_ONLY 强制开关 |
会话层 | 单进程写入配额 + 显式确认对话框 |
审计层 | writes.jsonl 结构化日志 + 文件权限 0600 |
传输层 | HTTPS + Api-Token 头部认证 |
注入防护 | Python 客户端统一处理，禁止 shell 拼接 |