Mixpanel Analytics — Mixpanel 分析
v1.0.0通过Mixpanel Data Export API 查询Mixpanel产品分析 —— 事件、漏斗、留存、用户资料和群组。使用时需要:(1)查询事件计数或随时间变化的唯一用户,(2)分析漏斗转化率,(3)检查留存指标,(4)查找或更新用户资料,(5)导出原始事件数据,(6)获取顶级事件或属性,(7)列出群组。需要MIXPANEL_SERVICE_ACCOUNT_USERNAME + MIXPANEL_SERVICE_ACCOUNT_SECRET(或用于遗产项目的MIXPANEL_API_SECRET)。
运行时依赖
安装命令
点击复制技能文档
Mixpanel Analytics Skill 查询 Mixpanel 产品分析数据,使用 Data Export API。 设置 选项 A — 服务账户(推荐,新项目) export MIXPANEL_SERVICE_ACCOUNT_USERNAME="你的服务账户用户名" export MIXPANEL_SERVICE_ACCOUNT_SECRET="你的服务账户密钥" export MIXPANEL_PROJECT_ID="12345678" 获取这些:Mixpanel → 组织设置 → 服务账户 → 创建服务账户 选项 B — API 密钥(遗留 / 项目级) export MIXPANEL_API_SECRET="你的 API 密钥" 获取它:Mixpanel → 项目设置 → 访问密钥 → API 密钥 数据驻留(可选) export MIXPANEL_DATA_REGION="eu" #用于 EU 数据驻留(默认:us) 核心工作流 最近 30 天的顶级事件 python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py events --days 30 事件随时间变化的数量 python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py segmentation --event "注册" --from-date 2026-01-01 --to-date 2026-03-21 --unit day 事件的唯一用户 python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py segmentation --event "购买" --type unique --days 7 漏斗分析 python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py funnel --funnel-id 12345 --from-date 2026-03-01 --to-date 2026-03-21 列出所有漏斗 python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py funnels 留存群组(每日) python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py retention --from-date 2026-03-01 --to-date 2026-03-21 --retention-type birth --unit day 用户个人资料查找 python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py profile --distinct-id "user@example.com" 导出原始事件 python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py export --from-date 2026-03-20 --to-date 2026-03-21 --event "购买" --limit 100 列出所有事件 python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py list-events 直接 API 调用(高级) 对于 EU 数据驻留,请用 data-eu.mixpanel.com 替换 data.mixpanel.com。 # 按事件划分,带有细分 curl -s "https://data.mixpanel.com/api/2.0/segmentation?project_id=$MIXPANEL_PROJECT_ID&event=注册&from_date=2026-03-01&to_date=2026-03-21&unit=day" -u "$MIXPANEL_SERVICE_ACCOUNT_USERNAME:$MIXPANEL_SERVICE_ACCOUNT_SECRET" 关键概念 事件:在产品中跟踪的用户操作(点击、购买、注册) Distinct ID:Mixpanel 中每个用户的唯一标识符 漏斗:转换路径(例如,查看 → 添加到购物车 → 购买) 留存:用户在触发事件后返回的频率 群组:具有共同行为的用户群体,用于分析 Agent 用例 每日增长简报:昨天的顶级事件 + 唯一用户 转换监控:关键事件的划分(注册 → 激活) 漏斗回归警报:漏斗比较,周比周 用户调试:在调查支持问题时的个人资料查找 每周留存报告:7 天和 30 天窗口的留存 注意 Data Export API 的速率限制为每小时 60 个请求 原始事件导出可以返回大型数据集 —— 使用 --limit 限制 漏斗 ID 可以在 Mixpanel UI 中找到:/report/funnels/XXXX 所有日期应以 YYYY-MM-DD 格式书写