核心用法
activecampaign-claw 是一款面向 ActiveCampaign 用户的深度分析型技能，通过 Python 脚本套件与 API 直连，为营销和销售运营提供数据驱动的决策支持。核心工作流包括：
1. 账户校准（Calibration）：首次运行时扫描账户结构（列表、标签、自定义字段、管道、自动化），建立 90 天性能基线，写入 ~/.activecampaign-skill/state.json
2. 日常分析：50+ 独立脚本覆盖六大领域——
- 绩效分析：campaign 复盘、主题行 A/B 效果、发送时间优化、域名参与度对比（Gmail vs Outlook）、参与度衰减队列
- 列表健康：重复联系人检测、角色邮箱清理、字段完整度、新订阅者质量评估
- 线索与销售：复合评分热线索排名、 slipping deals 预警、MQL→SQL 转化诊断、赢单/输单归因
- 自动化卫生：孤儿自动化检测、漏斗逐步流失、多自动化重叠冲突、停滞报名排查
- 标签/字段/列表审计：拼写错误标签合并、未使用自定义字段清理、列表重叠矩阵
- 合规与运营：GDPR 数据主体导出、退订/选择加入审计、webhook 可达性检测
3. 策略建议（无 API）：欢迎序列、再激活流程、滴灌 campaign 的完整蓝图设计，用户需在 AC UI 中手动搭建
显著优点
- 深度领域知识嵌入：
frameworks/目录包含细分理论、邮件最佳实践，输出的是"资深营销总监会如何解读"而非原始数据 - 安全优先的写入架构：分析优先设计，默认只读；修改操作需
AC_READ_ONLY=0、单进程写入上限（默认 10 条）、显式确认、审计日志（writes.jsonl），删除操作双重确认 - 上下文感知：每次对话自动读取
state.json和insights.md，对比历史基线而非孤立数字 - 计划降级优雅：Deals/Tasks/Accounts 等端点返回 403 时自动输出"当前计划不可用"报告，不中断流程
潜在缺点与局限性
- 无法发送 campaign 或创建自动化：ActiveCampaign v3 API 本身限制，技能仅提供设计规格
- 部分端点数据缺失：
/messageActivities未暴露时自动降级为点击数据（无打开事件）；deal 阶段停留时间无法计算（无 stage-movement 时间戳） - 需要技术初始化：必须配置
AC_API_URL+AC_API_TOKEN，运行calibrate.py，对非技术用户有门槛 - 依赖 Python3 环境：
scripts/_ac_client.py为核心依赖，Windows 支持未明确 - 令牌权限管理：需创建最小权限集成用户，误用管理员令牌会扩大风险面
适合人群
- 增长营销经理：每日简报、发送时间优化、主题行模式分析、再激活策略设计
- 销售运营/SDR：热线索优先级队列、管道卫生、slipping deals 预警、跟进任务审计
- 营销自动化专员：自动化漏斗诊断、标签治理、列表健康维护、自定义字段审计
- 数据合规官：GDPR 数据导出、退订审计、抑制列表管理
- 代理/咨询公司：多账户快照导出、schema diff、基线漂移检测
常规风险
- API 速率限制：5 req/s，脚本内置退避但大批量操作仍需注意
- 数据残留风险：
state.json虽声称"无 PII"，但 taxonomy 信息仍属账户敏感数据，文件权限 0600 依赖系统配置 - 误删除风险：尽管有多重确认，标签合并、联系人删除等操作仍可能因用户误确认导致数据丢失
- 令牌泄露：
AC_API_TOKEN环境变量传递，多用户共享 shell 环境存在泄露风险 - 计划变更导致功能失效：AC 计划降级时部分脚本静默降级输出，可能被误判为"数据正常"而非"功能受限"