核心定位
activecampaign-claw 是面向营销与销售团队的ActiveCampaign深度分析工具，通过本地Python脚本套件直接与AC v3 API交互，提供50余种专业级报告与诊断能力。
核心用法
安装与初始化：首次运行需配置AC_API_URL与AC_API_TOKEN环境变量，执行calibrate.py完成账户扫描，生成本地state.json（含taxonomy、90天基线、发送规律等）。
日常操作模式：
- 快速查询：单条记录查询（联系人、Deal、标签、自动化）通过专用脚本秒级返回
- 审计诊断：名单健康、标签 hygiene、自动化孤儿检测、Pipeline阶段分析等批量诊断
- 性能分析：Campaign复盘、主题行A/B分析、发送时间优化、域名参与度（Gmail vs Outlook）、参与度衰减队列
- 销售运营：热线索排序、滑落Deal预警、MQL→SQL转化诊断、销售代表记分板
- 策略咨询：欢迎序列/再激活流程设计（输出蓝图，用户在AC UI中构建）
数据安全架构：
- 纯本地运行，所有报告、快照、审计日志写入
~/.activecampaign-skill/（权限0600） - 可选
AC_READ_ONLY=1纯分析模式，写操作需显式确认并受单进程写入上限（默认10次）约束 - 完整审计轨迹：
writes.jsonl记录每次POST/PUT/DELETE的endpoint、方法、payload哈希
显著优点
1. 深度领域嵌入：内置资深营销知识（frameworks/email-best-practices.md、segmentation-theory.md），输出为可执行业务建议而非原始数据
2. 账户感知：calibrate.py建立90天性能基线，所有指标自动对比"你的中位数"而非行业泛泛标准
3. 零外部传输：无第三方SaaS依赖，PII不出本地机器
4. 渐进式权限：支持最小权限集成用户，写操作多重确认门控
5. 工作流可复现：recipes/参数化工作流+history.jsonl结果日志，支持趋势追踪
局限性与风险
- API能力边界：无法发送Campaign、无法创建自动化（AC v3限制），策略输出为蓝图需人工在AC UI实施
- 计划层级限制：Deals、Tasks、Saved Responses、B2B Accounts等功能需AC Plus+计划，遇403自动降级
- 数据完整性：部分端点（
/messageActivities、site tracking）不可用，参与度分析可能退化为点击-only - 技术门槛：需Python 3环境、API凭证配置，非技术用户上手有摩擦
- 本地化负担：快照、历史文件需手动清理（建议90天轮转）
适合人群
- 增长营销经理：名单健康审计、发送频率优化、再激活策略设计
- 销售运营：Pipeline诊断、热线索优先级、Deal流失预警
- CRM管理员：标签/字段/自动化 hygiene 清理、合规审计（退订/Opt-in）
- 数据驱动型中小企业：无预算购买昂贵BI，愿以技术配置换取深度分析能力
常规风险提示
- 写操作脚本（
tag_merge.py等）默认dry-run，需--confirm显式激活 - 删除操作不可逆，脚本强制二次确认并说明数据丢失范围
- API Token权限过大可能导致意外数据修改，务必遵循最小权限原则创建专用集成用户
- 本地
state.json超过30天未更新时，建议重新校准以保证基线准确性