Mixpanel Automation 通过 Rube MCP 使用 Composio 的 Mixpanel 工具包，自动化 Mixpanel 产品分析相关任务。
一、用途 该技能用于以自动化方式访问 Mixpanel 数据，支持事件统计、细分分析、漏斗转化、用户画像查询与更新、群组读取，以及自定义 JQL 和已保存洞察查询，适合需要在工作流中批量调用 Mixpanel 分析能力的场景。
二、前置条件与设置
- Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）。
- 必须通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Mixpanel 连接（toolkit 为 mixpanel）。
- 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。
- 在客户端配置中把 https://rube.app/mcp 添加为 MCP 服务器，无需 API key。
- 确认 RUBE_SEARCH_TOOLS 有响应；调用 RUBE_MANAGE_CONNECTIONS 并传入 toolkit mixpanel；若连接非 ACTIVE，按返回的授权链接完成 Mixpanel 认证；确认状态为 ACTIVE 后再运行工作流。
三、核心工作流
- 聚合事件数据：先调用 MIXPANEL_GET_ALL_PROJECTS 获取项目 ID，再调用 MIXPANEL_AGGREGATE_EVENT_COUNTS。关键参数包括 event（事件名或数组）、from_date / to_date（YYYY-MM-DD）、unit（minute、hour、day、week、month）、type（general、unique、average）、where 过滤表达式。注意日期格式、事件名大小写敏感、where 使用 Mixpanel 表达式语法、日期范围上限可能受套餐限制。
- 运行细分查询：调用 MIXPANEL_QUERY_SEGMENTATION。关键参数包括 event、from_date / to_date、on（细分属性，如 properties["country"]）、unit、type、where、limit。注意 on 使用属性表达式语法，高基数属性结果会被截断，需要用 limit。
- 分析漏斗：先调用 MIXPANEL_LIST_FUNNELS 找到 funnel_id，再调用 MIXPANEL_QUERY_FUNNEL。关键参数包括 funnel_id、from_date / to_date、unit、where、on、length（转化窗口天数）。注意漏斗必须先在 Mixpanel UI 中创建；length 建议显式设置；大日期范围加细分会产生很大响应。
- 管理用户画像：调用 MIXPANEL_QUERY_PROFILES，可选 MIXPANEL_PROFILE_BATCH_UPDATE。关键参数包括 where、output_properties、page、session_id，以及批量更新的 $distinct_id 和属性操作。注意分页需沿用首次响应的 session_id；批量更新支持 $set、$unset、$add、$append，且有单次上限，需分块处理；属性名大小写敏感。
- 管理群组：调用 MIXPANEL_COHORTS_LIST，无需必填参数，返回 id、name、description、count。注意群组在 Mixpanel UI 中创建和管理，API 为只读；群组 ID 为数字；超大群组计数可能为近似值；群组可通过 where 表达式作为其他查询的过滤条件。
- JQL 与洞察查询：可选调用 MIXPANEL_JQL_QUERY（script 参数）和 MIXPANEL_QUERY_INSIGHT（bookmark_id 参数）。注意 JQL 使用 Mixpanel 专有的类 JavaScript 语法，有执行时间限制，且为旧版功能，需查阅 Mixpanel 文档确认当前可用性。
四、常见模式 ID 解析：项目名到项目 ID 用 MIXPANEL_GET_ALL_PROJECTS；漏斗名到 funnel_id 用 MIXPANEL_LIST_FUNNELS。表达式语法：属性引用为 properties["property_name"]，比较、布尔、包含、AND/OR 均按 Mixpanel 语法书写。分页：事件查询按日期区间调整；画像查询用 page 与 session_id；漏斗/群组列表通常返回完整结果。
五、已知限制 日期必须为 YYYY-MM-DD 且首尾包含；数据新鲜度取决于 Mixpanel 摄入延迟（通常为分钟级）。字符串值需加引号，数值不加引号，布尔值小写。Mixpanel API 有按项目的速率限制；大细分查询可能超时；建议使用批量操作减少调用。响应数据可能嵌套在 data 键下，数值可能以字符串返回，空日期范围返回空对象。
六、适用场景 适合需要通过 MCP 工作流自动化执行 Mixpanel 事件统计、细分、漏斗、画像与群组读取及自定义查询的团队或个人。