技能名称: mixpanel-analytics

Mixpanel 分析技能

使用数据导出 API 从 Mixpanel 查询产品分析数据。

设置

选项 A — 服务账户（推荐，适用于新项目）

bash
export MIXPANELSERVICEACCOUNT_USERNAME=your-sa-username
export MIXPANELSERVICEACCOUNT_SECRET=your-sa-secret
export MIXPANELPROJECTID=12345678

获取方式：Mixpanel → 组织设置 → 服务账户 → 创建服务账户

选项 B — API 密钥（旧版/项目级别）

bash
export MIXPANELAPISECRET=your-api-secret

获取方式：Mixpanel → 项目设置 → 访问密钥 → API 密钥

数据驻留（可选）

bash
export MIXPANELDATAREGION=eu # 用于欧盟数据驻留（默认：us）

核心工作流

热门事件（最近 30 天）

bash
python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py events --days 30

事件计数随时间变化

bash
python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py segmentation \
--event 注册 --from-date 2026-01-01 --to-date 2026-03-21 --unit day

事件的独立用户数

bash
python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py segmentation \
--event 购买 --type unique --days 7

漏斗分析

bash
python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py funnel \
--funnel-id 12345 --from-date 2026-03-01 --to-date 2026-03-21

列出所有漏斗

bash
python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py funnels

留存队列（每日）

bash
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

用户画像查询

bash
python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py profile --distinct-id user@example.com

导出原始事件

bash
python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py export \
--from-date 2026-03-20 --to-date 2026-03-21 \
--event 购买 --limit 100

列出所有事件

bash
python3 ~/.openclaw/workspace/skills/mixpanel-analytics/scripts/mx.py list-events

直接 API 调用（高级）

对于欧盟数据驻留，请将 data.mixpanel.com 替换为 data-eu.mixpanel.com。

bash

按事件分段并细分

关键概念

• - 事件：在产品中追踪的用户操作（点击、购买、注册）
• 独立 ID：Mixpanel 中每个用户的唯一标识符
• 漏斗：转化路径（例如：浏览 → 加入购物车 → 购买）
• 留存：用户在触发事件后返回的频率
• 队列：具有共同行为用于分析的用户组

代理用例

• - 每日增长简报：events 获取昨日热门事件 + 独立用户数
• 转化监控：segmentation 分析关键事件（注册 → 激活）
• 漏斗回归警报：funnel 进行周环比比较
• 用户调试：profile 查询用于调查支持问题
• 每周留存报告：retention 分析 7 天和 30 天窗口

备注

• - 数据导出 API 的速率限制为 60 次请求/小时
• 原始事件导出可能返回大量数据集 — 使用 --limit 限制数量
• 漏斗 ID 可在 Mixpanel UI 的 URL 中找到：/report/funnels/XXXX
• 所有日期应使用 YYYY-MM-DD 格式