---

name: mixpanel-automation description: "通过 Rube MCP (Composio) 自动化 Mixpanel 任务：事件、分群、漏斗、群组、用户画像、JQL 查询。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Mixpanel 自动化

通过 Composio 的 Mixpanel 工具包经由 Rube MCP 自动化产品分析。

前置条件

• 必须连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 Mixpanel 连接，工具包为 mixpanel
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在你的客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应以验证 Rube MCP 可用
2. 使用工具包 mixpanel 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接未处于 ACTIVE 状态，按照返回的认证链接完成 Mixpanel 身份验证
4. 在运行任何工作流之前确认连接状态显示为 ACTIVE

核心工作流

1. 聚合事件数据

使用场景：用户想要统计事件数量、获取总计或跟踪事件随时间的趋势

工具调用顺序：

1. MIXPANEL_GET_ALL_PROJECTS - 列出项目以获取项目 ID [前置步骤]
2. MIXPANEL_AGGREGATE_EVENT_COUNTS - 获取事件计数和聚合 [必需]

关键参数：

• event：要聚合的事件名称或事件名称数组
• from_date / to_date：日期范围，格式为 'YYYY-MM-DD'
• unit：时间粒度（'minute'、'hour'、'day'、'week'、'month'）
• type：聚合类型（'general'、'unique'、'average'）
• where：事件属性的过滤表达式

注意事项：

• 日期格式必须为 'YYYY-MM-DD'；其他格式会导致错误
• 事件名称区分大小写；使用 Mixpanel 项目中的精确名称
• where 过滤器使用 Mixpanel 表达式语法（例如 properties["country"] == "US"）
• 最大日期范围可能受 Mixpanel 套餐限制

2. 运行分群查询

使用场景：用户想要按属性细分事件以进行详细分析

工具调用顺序：

1. MIXPANEL_QUERY_SEGMENTATION - 运行分群分析 [必需]

关键参数：

• event：要分群的事件名称
• from_date / to_date：日期范围，格式为 'YYYY-MM-DD'
• on：分群依据的属性（例如 properties["country"]）
• unit：时间粒度
• type：计数类型（'general'、'unique'、'average'）
• where：过滤表达式
• limit：返回的最大分群数

注意事项：

• on 参数使用 Mixpanel 属性表达式语法
• 属性引用必须使用 properties["prop_name"] 格式
• 对高基数属性进行分群会返回截断结果；使用 limit
• 结果按分群属性和时间单位分组

3. 分析漏斗

使用场景：用户想要跟踪转化漏斗并识别流失点

工具调用顺序：

1. MIXPANEL_LIST_FUNNELS - 列出已保存的漏斗以获取漏斗 ID [前置步骤]
2. MIXPANEL_QUERY_FUNNEL - 执行漏斗分析 [必需]

关键参数：

• funnel_id：要查询的已保存漏斗 ID
• from_date / to_date：日期范围
• unit：时间粒度
• where：过滤表达式
• on：漏斗分群依据的属性
• length：转化窗口（天数）

注意事项：

• funnel_id 为必填项；需先通过 LIST_FUNNELS 获取
• 漏斗必须先在 Mixpanel UI 中创建；API 只能查询已有漏斗
• 转化窗口（length）默认值各异；建议明确设置以确保准确性
• 大日期范围配合分群可能产生非常大的响应

4. 管理用户画像

使用场景：用户想要查询或更新 Mixpanel 中的用户画像

工具调用顺序：

1. MIXPANEL_QUERY_PROFILES - 搜索和过滤用户画像 [必需]
2. MIXPANEL_PROFILE_BATCH_UPDATE - 批量更新用户画像 [可选]

关键参数：

• where：画像属性的过滤表达式（例如 properties["plan"] == "premium"）
• output_properties：要包含在结果中的属性名称数组
• page：分页页码
• session_id：用于一致分页的会话 ID（来自首次响应）
• 批量更新：包含 $distinct_id 和属性操作的画像更新数组

注意事项：

• 画像查询返回分页结果；使用首次响应中的 session_id 确保分页一致性
• where 使用 Mixpanel 表达式语法处理画像属性
• BATCH_UPDATE 对画像应用操作（$set、$unset、$add、$append）
• 批量更新每次请求有最大画像数限制；较大更新需分批处理
• 画像属性名称区分大小写

5. 管理群组

使用场景：用户想要列出或分析用户群组

工具调用顺序：

1. MIXPANEL_COHORTS_LIST - 列出所有已保存的群组 [必需]

关键参数：

• 无必填参数；返回所有可访问的群组
• 响应包含群组 ID、名称、描述和创建日期