mcpField
M
mixpanel-automation

mixpanel-automation

github.com/composiohq数据与数据库78.3k87 次安装14 周前更新
代码仓库

关于 mixpanel-automation

通过 Composio 工具包运行 Mixpanel 产品分析的技能，面向处理事件数据、漏斗、用户档案和群组的 Agent。文档说明查询流程以及 Mixpanel 专用参数和限制。

主要功能

  1. 01汇总事件计数
  2. 02按属性细分事件
  3. 03查询已保存的转化漏斗
  4. 04搜索并更新用户档案
  5. 05列出群组并运行 JQL 或洞察查询

适用场景

  1. 01统计指定日期范围内的事件
  2. 02按用户属性比较事件
  3. 03查看漏斗转化和流失
  4. 04查找或更新用户档案

MCP 相关

通过 Rube MCP 使用 Composio 的 Mixpanel 工具包。需要先获取当前工具模式，并确认 Mixpanel 连接已激活。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/composiohq/awesome-claude-skills --skill mixpanel-automation

安装后在 Claude Code 中输入/mixpanel-automation确认已加载。

详细介绍

通过 Rube MCP 自动化 Mixpanel

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

工具包文档：composio.dev/toolkits/mixpanel

前置条件

  • 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
  • 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Mixpanel 连接，工具包为 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

核心工作流

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、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 键下
  • 事件数据通常按日期和细分分组
  • 数值可能以字符串形式返回；请显式解析
  • 空日期范围会返回空对象，而非空数组

快速参考

任务工具标识关键参数
列出项目MIXPANEL_GET_ALL_PROJECTS（无）
聚合事件MIXPANEL_AGGREGATE_EVENT_COUNTSevent, from_date, to_date, unit
细分MIXPANEL_QUERY_SEGMENTATIONevent, on, from_date, to_date
列出漏斗MIXPANEL_LIST_FUNNELS（无）
查询漏斗MIXPANEL_QUERY_FUNNELfunnel_id, from_date, to_date
查询用户档案MIXPANEL_QUERY_PROFILESwhere, output_properties, page
批量更新用户档案MIXPANEL_PROFILE_BATCH_UPDATE（用户档案更新对象）
列出群组MIXPANEL_COHORTS_LIST（无）
JQL 查询MIXPANEL_JQL_QUERYscript
查询洞察MIXPANEL_QUERY_INSIGHTbookmark_id

由 Composio 提供支持

评论

支持 Markdown