Agent Analytics

核心用法

Agent Analytics 是一款专为 AI Agent 设计的端到端分析工具，通过官方 CLI (npx --yes @agent-analytics/cli@0.5.21) 实现完整的增长分析工作流。核心能力涵盖：

项目管理：创建/更新项目、配置允许域名、管理多项目组合
事件追踪：自动捕获页面浏览、来源、UTM、设备/浏览器、会话等数据，支持自定义事件通过 data-aa-event 属性或 window.aa.track() API
查询分析：固定命令（stats、insights、events、breakdown、funnel、retention、paths）覆盖大部分场景，高级场景使用 query 配合 JSON 过滤器
实验管理：完整的 A/B 测试生命周期，支持多变量与目标事件配置
智能扫描：scan 命令分析网站后输出 minimum_viable_instrumentation 建议，指导优先追踪高价值事件而非泛化埋点

显著优点

1. Agent 原生设计：无需仪表盘，全程对话式完成分析-洞察-行动闭环
2. 分析优先策略：强制先执行网站扫描识别数据盲区，再针对性埋点，避免过度追踪
3. 多运行时适配：支持浏览器授权、分离式授权（--detached，适用于 OpenClaw/Paperclip 等问题驱动环境）、MCP 及 API 多种接入方式
4. 上下文记忆：context get/set 实现项目级持久化配置，存储激活定义、业务目标、事件 glossary，支持跨会话智能累积
5. 子代理委派：官方推荐按表面（homepage/scanner/onboarding/docs）拆分并行审计，父代理合成增长赌注与测量缺口
6. 中文支持：完整中文文档与 OpenClaw 专属指南

潜在缺点与局限性

• 功能分级限制：漏斗、留存、会话路径、热图、实时读取等高级功能需 Pro 付费（免费版 10 万事件/月，2 项目）
• 查询分组受限：group_by 仅支持内置字段（event/date/user_id/session_id/country），不支持按任意属性分组
• 时间精度限制：不支持 24h 等小时级简写，精确到小时的分析需手动构建时间戳过滤器
• CLI 版本锁定：强制使用固定版本 0.5.21，未来版本更新需手动迁移
• 浏览器回调依赖：非分离式登录需要本地浏览器回调，部分容器环境受限

适合人群

• 增长团队：需要快速诊断多表面转化瓶颈、迭代实验
• AI Agent 开发者：构建闭环自主分析能力，如自动化增长审计、实时监控告警
• 中国团队/OpenClaw 用户：中文文档与 issue 工作流优化
• 多项目管理者：批量跨项目分析，避免逐仪表盘手动操作

常规风险

• 过度追踪风险：虽文档强调"分析优先"，但新手仍可能忽略扫描建议直接泛化埋点
• 敏感数据暴露：context set 有 8KB 限制，需避免存储 PII、密钥；配置目录应加入 .gitignore
• 授权流转风险：分离式登录需妥善传递 finish code，避免会话混淆
• Pro 升级中断：分析中途遇 PRO_REQUIRED 需人工支付确认，无法完全自动化

核心用法

Agent Analytics 是一款面向 AI Agent 的 CLI 优先分析工具，通过 npx --yes @agent-analytics/cli@0.5.21 命令实现完整的增长分析工作流。核心能力包括：

• 项目创建与管理：create、projects、update、delete 等命令
• 智能网站扫描：scan <url> --json 自动识别数据盲点，输出 minimum_viable_instrumentation 建议
• 事件追踪与查询：events、properties、breakdown 等固定命令优先，query 用于高级过滤
• 漏斗与留存分析：funnel、retention、paths 支持转化诊断与用户旅程分析
• 实验管理：experiments create/list 完整的 A/B 测试生命周期
• 分离式认证：login --detached 适配 OpenClaw 等 Issue 型工作流，避免密钥粘贴

显著优点

1. Agent-Native 设计：全程 CLI 驱动，无需仪表盘操作，天然适配自动化 Agent 工作流
2. 分析优先策略：强制先 scan 再安装追踪代码，避免过度采集和无效数据
3. 智能委托支持：明确支持子 Agent 并行分析（homepage/scanner、onboarding、content、verification 四路分工）
4. 中文本地化：文档、安装指南完整支持中文，适配中国团队使用场景
5. 安全认证友好：分离式登录、浏览器授权、无 API Key 默认流程，降低密钥泄露风险
6. 上下文记忆：context get/set 实现项目级知识沉淀，跨会话分析更连贯

潜在缺点与局限性

1. 免费层限制：100k 事件/月、2 项目上限，高级功能（funnels、retention、heatmaps、experiments）需 Pro
2. 分组能力受限：group_by 仅支持内置字段，无法按任意 properties.* 字段分组，复杂归因分析受限
3. T3 来源可信度：个人开发者维护，非企业级背书，长期维护稳定性存疑
4. 时间窗口限制：不支持 24h 等小时级简写，精确滚动窗口需手动计算时间戳
5. CLI 版本锁定依赖：强制固定 @0.5.21 版本，需持续跟进官方更新

适合人群

• 希望用 Agent 自动化运营增长分析的产品团队和增长黑客
• 需要多项目组合分析、批量监控的规模化运营场景
• 追求分析驱动决策、反感"先装代码再看数据"的团队
• 中文用户/中国团队：完整本地化文档支持
• OpenClaw/Hermes 等 Agent 平台用户：原生适配委托与分离式认证

常规风险

• 供应链风险：依赖 npm 包 @agent-analytics/cli，需信任发布者
• 数据主权：事件数据上传至 agentanalytics.sh 托管服务
• Pro 功能阻塞：免费层达到上限后分析中断，需付费升级才能继续
• 委托复杂度：四路并行分析需协调 max_concurrent_children 限制，误用可能导致资源竞争