ActiveCampaign 营销分析爪

要解决什么问题

ActiveCampaign 控制台能看报表，但很难用自然语言把「最近哪类主题行在掉量」「列表里有多少角色邮箱」「自动化哪一步在漏人」串成可执行的晨会结论。营销和销售往往要在 API 文档、导出 CSV 和多个报表页之间来回切，且改联系人、合并标签一旦误操作，影响面很难追溯。

技能如何工作

本技能直连 ActiveCampaign v3 API，安装时运行 calibrate.py 扫描账户：taxonomy（列表、标签、自定义字段、管道等）与 90 天活动基线写入本地 ~/.activecampaign-skill/state.json，后续对话不必从零问配置。

分析为主： scripts/ 下 60+ 脚本以只读拉数、输出 Markdown 报告为主，覆盖：

• 表现分析 — 活动复盘、主题行、发送时段/频率、域名拆分、参与度衰减、基线漂移
• 列表与联系人 — 列表审计、重复联系人、角色地址、字段完整度、导入前 CSV 校验
• 线索与销售 — 热线索排序、 slipping deals、MQL→SQL、按来源赢输（需账户含 Deals 能力）
• 自动化与元数据卫生 — 孤儿自动化、逐步漏斗流失、标签/字段/分段/表单审计
• 合规与运维 — 退订/订阅审计、抑制列表导出、按联系人导出、webhook 与账户快照

recipes/ 提供参数化工作流（每日 digest、列表审计、欢迎序列规格等）；frameworks/ 嵌入邮件与分段等领域知识。战略类问题（该用 tag 还是 custom field、欢迎/再激活序列规格）可在不调用 API 的情况下给出可在 AC UI 里落地的蓝图。

写入路径（可选）： 少数脚本可在你明确确认后更新联系人、标签、列表订阅、自动化注册、Deal 与自定义字段。经 _ac_client.py 单一路径：支持 AC_READ_ONLY=1 全拒写、单次进程写入上限、删除二次确认、破坏性操作默认 dry-run；审计写入 writes.jsonl（记录 payload 哈希而非正文）。数据与报告仅落本地，无跨账户、无第三方遥测。

适用边界与注意点

• 认证头为 Api-Token，不是 Bearer；Token 绑定创建用户，建议专用集成账号且非必须 Admin。
• v3 API 不能在技能内直接创建自动化或发送活动；(spec) 类输出是你在 AC 界面组装的方案。
• Deals、Tasks、Saved Responses、B2B Accounts 相关报告依赖对应套餐/能力，缺失时脚本应干净退出。
• state.json 建议每月重校准；超过约 30 天可提示再跑校准。本地 history.jsonl、快照等需自行按保留策略清理。