mixpanel-automation

通过 Rube MCP 自动化 Mixpanel

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

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过工具包 mixpanel，使用 RUBE_MANAGE_CONNECTIONS 建立有效的 Mixpanel 连接
• 始终先调用 RUBE_SEARCH_TOOLS，以获取最新的工具架构

设置

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

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用
2. 使用工具包 mixpanel 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，请根据返回的授权链接完成 Mixpanel 身份验证
4. 运行任何工作流前，确认连接状态显示为 ACTIVE

数据和变更范围

在比较计数前，确认具体的项目、数据区域、报表时区、身份识别／独立用户规则和日期边界。说明状态上限、数据新鲜度和不可用的维度；分段独立用户计数通常不能相加，漏斗相关性也不能证明因果关系。查询请求并不授权更新用户档案。批量写入前，预览准确的独立 ID／操作，保护个人身份信息（PII），并在重试累加／追加更新前核对结果。发现的实时架构优先于此静态参考。

核心工作流

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 界面中创建漏斗；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、name、description、count

注意事项：

• 用户群组在 Mixpanel 界面中创建和管理；API 提供读取权限
• 用户群组 ID 为数字；请使用列表结果中的准确 ID
• 对于非常大的用户群组，群组人数可能是近似值
• 可通过 where 表达式将用户群组用作其他查询的筛选条件

6. 运行 JQL 和洞察查询

使用时机：用户希望运行自定义 JQL 查询或洞察分析

工具顺序：

1. MIXPANEL_JQL_QUERY - 执行自定义 JQL（JavaScript Query Language）查询【可选】
2. MIXPANEL_QUERY_INSIGHT - 运行已保存的洞察查询【可选】

关键参数：

• JQL：包含 JQL JavaScript 代码的 script
• 洞察：已保存洞察的 bookmark_id
• project_id：查询所用的项目上下文

注意事项：

• JQL 使用 Mixpanel 特有的类 JavaScript 语法
• JQL 查询有执行时间限制；请优化查询以提高效率
• 洞察的 bookmark_id 必须指向现有的已保存洞察
• JQL 是一项旧版功能；请查阅 Mixpanel 文档，了解当前是否仍可用

常见模式

ID 解析

项目名称 -> 项目 ID：

1. Call MIXPANEL_GET_ALL_PROJECTS
2. Find project by name in results
3. Extract project id

漏斗名称 -> 漏斗 ID：

1. Call MIXPANEL_LIST_FUNNELS
2. Find funnel by name
3. Extract funnel_id

Mixpanel 表达式语法

用于 where 和 on 参数：

• 属性引用：properties["property_name"]
• 相等：properties["country"] == "US"
• 比较：properties["age"] > 25
• 布尔值：properties["is_premium"] == true
• 包含："search_term" in properties["name"]
• AND/OR：properties["country"] == "US" and properties["plan"] == "pro"

分页

• 事件查询：调整日期范围，按日期进行分页
• 档案查询：使用 page 页码和 session_id，以确保结果一致
• 漏斗和用户群组列表：通常会返回完整结果，无需分页

已知陷阱

日期格式：

• 始终使用 'YYYY-MM-DD' 格式
• 日期范围两端均包含在内
• 数据新鲜度取决于 Mixpanel 的摄取延迟（通常为几分钟）

表达式语法：

• 属性引用始终使用 properties["name"] 格式
• 字符串值必须加引号：properties["status"] == "active"
• 数值不加引号：properties["count"] > 10
• 布尔值：true / false（小写）

速率限制：

• Mixpanel API 对每个项目都有速率限制
• 大型细分查询可能会超时；请缩小日期范围或减少细分
• 在可用时使用批量操作以尽量减少 API 调用

响应解析：

• 响应数据可能嵌套在 data 键下
• 事件数据通常按日期和细分分组
• 数值可能以字符串形式返回；请显式解析
• 空日期范围返回空对象，而不是空数组

快速参考

任务	工具 Slug	关键参数
列出项目	MIXPANEL_GET_ALL_PROJECTS	（无）
聚合事件	MIXPANEL_AGGREGATE_EVENT_COUNTS	event, from_date, to_date, unit
细分	MIXPANEL_QUERY_SEGMENTATION	event, on, from_date, to_date
列出漏斗	MIXPANEL_LIST_FUNNELS	（无）
查询漏斗	MIXPANEL_QUERY_FUNNEL	funnel_id, from_date, to_date
查询用户画像	MIXPANEL_QUERY_PROFILES	where, output_properties, page
批量更新用户画像	MIXPANEL_PROFILE_BATCH_UPDATE	（profile update objects）
列出同期群	MIXPANEL_COHORTS_LIST	（无）
JQL 查询	MIXPANEL_JQL_QUERY	script
查询洞察	MIXPANEL_QUERY_INSIGHT	bookmark_id

何时使用

本技能适用于执行概述中描述的工作流或操作。

限制

• 仅在任务与上述范围明确匹配时使用本技能。
• 不要将输出视为特定环境验证、测试或专家评审的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。