mcpField
M
mixpanel-automation

mixpanel-automation

github.com/davepoon数据与数据库3.7k114 次安装1 天前更新
代码仓库

关于 mixpanel-automation

mixpanel-automation 是通过 Rube MCP 和 Composio Mixpanel toolkit 自动化产品分析的技能，适用于需要查询事件、漏斗、用户档案和群组的工作流。

主要功能

  1. 01汇总事件数量与趋势
  2. 02按属性细分事件
  3. 03查询已保存的转化漏斗
  4. 04查询及批量更新用户档案
  5. 05列出用户群组
  6. 06执行 JQL 与 Insight 查询

适用场景

  1. 01按时间范围统计产品事件
  2. 02按国家等属性拆解事件表现
  3. 03检查漏斗转化与流失节点
  4. 04筛选并更新用户档案

MCP 相关

通过 Rube MCP 调用 Composio 的 Mixpanel toolkit；使用前需连接 Mixpanel，并先获取当前工具定义。

安装

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

$npx skills add https://github.com/davepoon/buildwithclaude --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