核心用法
activecampaign-claw 是一款面向营销人员和销售团队的 ActiveCampaign 智能分析助手，通过深度集成 ActiveCampaign v3 API，提供50+专业分析能力。用户通过自然语言指令即可调用各类分析脚本，涵盖四大核心场景：
1. 营销绩效分析：campaign 复盘、主题行优化、发送时间分析、疲劳度检测、域名分层表现（Gmail/Outlook/企业邮箱）、参与度衰减分析等
2. 列表与联系人健康度：列表审计、重复联系人查找、角色邮箱识别、字段完整度、休眠联系人识别、新订阅者质量评估
3. 线索评分与销售支持：热线索排序、滑单预警、MQL→SQL 转化诊断、赢单/输单来源分析、Pipeline 健康检查
4. 运营与合规审计：标签/字段/列表/自动化卫生检查、GDPR 数据主体导出、退订合规审计、Webhook 可用性检测
首次使用需运行 calibrate.py 扫描账户，建立基准数据（taxonomy、90天性能基线）。所有分析脚本位于 scripts/ 目录，按功能分类清晰。
显著优点
- 分析优先的安全设计：默认只读模式，通过
AC_READ_ONLY=1可强制禁用所有写入操作；写入操作需显式确认，单次写入上限10条，全程审计日志 - 嵌入式领域知识：内置邮件营销最佳实践、细分策略理论，可提供策略建议（如"该用标签还是自定义字段"）
- 工作流配方驱动：
recipes/目录提供参数化工作流（欢迎序列、每日简报、列表审计等），非裸露API调用 - 智能基准对比：所有指标自动与90天中位数对比，输出"27%打开率，比基准低1个百分点"而非原始数字
- 账户快照与版本对比：支持完整账户导出、schema diff，便于变更追踪
局限性与风险
- API 能力边界：无法通过 v3 API 发送邮件或创建自动化，只能设计规范由用户在 AC 界面手动搭建
- 计划层级限制：Deals、Tasks、Saved Responses、B2B Accounts 等功能需要对应 AC 计划，遇 403 会友好提示而非报错
- 数据完整性限制：
/messageActivities接口并非所有计划可用，部分报告会降级为仅点击分析；deal 阶段移动时间戳未暴露，无法计算 stage 停留时长 - 依赖人工确认：批量写入需逐批确认，大规模数据清理效率受限
适合人群
- 日均邮件量>1000的中大型 ActiveCampaign 用户
- 缺乏专职数据分析师但需要深度洞察的营销/销售运营
- 重视数据安全、需要审计追踪的合规敏感型企业
- 希望将 AC 数据用于战略决策而非仅执行发送的管理者
常规风险
1. API 令牌泄露：AC_API_TOKEN 需妥善保管，建议使用专用集成用户而非管理员账户
2. 误删除风险：虽有显式确认机制，但用户确认后操作立即执行，无回收站
3. 基准漂移：30天未校准的 state.json 可能导致对比失真，系统会提示但不会阻止
4. 速率限制：5 req/s 限制下大规模导出可能耗时较长
5. 第三方依赖：依赖作者个人仓库（ji282h7），需关注维护持续性