posthog-automation

通过 Rube MCP 自动化 PostHog

通过 Rube MCP 使用 Composio 的 PostHog 工具包，自动化 PostHog 产品分析和功能标记管理。

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 PostHog 连接，并使用工具包 posthog
• 始终先调用 RUBE_SEARCH_TOOLS，以获取当前工具架构

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。MCP 端点仍需要通过已安装的 Rube 服务提供的提供商连接和授权流程；仅添加 URL 并不会授予账户访问权限。

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

核心工作流

1. 捕获事件

适用场景：用户希望向 PostHog 发送事件数据，以进行分析跟踪

工具调用顺序：

1. POSTHOG_CAPTURE_EVENT - 向 PostHog 发送一个或多个事件 [必需]

关键参数：

• event：事件名称（例如，'$pageview'、'user_signed_up'、'purchase_completed'）
• distinct_id：唯一用户标识符（必需）
• properties：包含事件特定属性的对象
• timestamp：ISO 8601 时间戳（可选；默认为服务端时间）

注意事项：

• 每个事件都必须提供 distinct_id；它用于标识用户或设备
• PostHog 系统事件使用 $ 前缀（例如，'$pageview'、'$identify'）
• 自定义事件不应使用 $ 前缀
• 属性格式自由；请在不同事件中保持架构一致
• 事件会异步处理；通常只需数秒即可完成数据摄取

2. 列出并筛选事件

适用场景：用户希望浏览或搜索已捕获的事件

工具调用顺序：

1. POSTHOG_LIST_AND_FILTER_PROJECT_EVENTS - 使用筛选条件查询事件 [必需]

关键参数：

• project_id：PostHog 项目 ID（必需）
• event：按事件名称筛选
• person_id：按个人 ID 筛选
• after：此 ISO 8601 时间戳之后的事件
• before：此 ISO 8601 时间戳之前的事件
• limit：返回的事件数量上限
• offset：分页偏移量

注意事项：

• 必须提供 project_id；请先通过 LIST_PROJECTS 获取
• 日期筛选条件使用 ISO 8601 格式（例如，'2024-01-15T00:00:00Z'）
• 事件量较大时需要分页；请使用 offset 和 limit
• 默认按时间倒序返回结果
• 事件属性为嵌套结构；请仔细解析

3. 管理功能标记

适用场景：用户希望创建、查看或管理功能标记

工具调用顺序：

1. POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS - 列出现有功能标记 [必需]
2. POSTHOG_RETRIEVE_FEATURE_FLAG_DETAILS - 获取标记的详细配置 [可选]
3. POSTHOG_CREATE_FEATURE_FLAGS_FOR_PROJECT - 创建新的功能标记 [可选]

关键参数：

• 列表查询：project_id（必需）
• 查询详情：project_id、id（功能标记 ID）
• 创建标记：
  • project_id：目标项目
  • key：标记键（例如，'new-dashboard-beta'）
  • name：易于理解的名称
  • filters：定向规则和发布百分比
  • active：标记是否已启用

注意事项：

• 功能标记的 key 在项目内必须唯一
• 标记键应使用 kebab-case（例如，'my-feature-flag'）
• filters 用于定义定向用户组及其属性和发布百分比
• 使用 active: true 创建标记后，匹配的用户会立即启用该标记
• 由于 PostHog 的轮询机制，标记更改会在数秒内生效

4. 管理项目

何时使用：用户想要列出或查看 PostHog 项目和

工具序列：

1. POSTHOG_LIST_PROJECTS_IN_ORGANIZATION_WITH_PAGINATION - 列出所有项目 [必需]

关键参数：

• organization_id：组织标识符（取决于认证方式，可能为可选）
• limit：每页结果数量
• offset：分页偏移量

注意事项：

• 项目 ID 为数字；在大多数其他端点中用作参数
• 可能需要组织 ID；请检查你的 PostHog 设置
• 分页基于偏移量；持续迭代直到结果为空
• 项目设置包括 API 密钥和配置详情

5. 用户资料与认证

何时使用：用户想要查看当前用户详情或验证 API 访问

工具序列：

1. POSTHOG_WHOAMI - 获取当前 API 用户信息 [可选]
2. POSTHOG_RETRIEVE_CURRENT_USER_PROFILE - 获取详细用户资料 [可选]

关键参数：

• 两次调用均无必需参数
• 返回当前已认证用户的详情、权限和组织信息

注意事项：

• WHOAMI 是轻量级检查；用于验证 API 连通性
• 用户资料包括组织成员关系和权限
• 这些端点确认 API 密钥的访问级别和范围

常见模式

ID 解析

组织 -> 项目 ID：

1. Call POSTHOG_LIST_PROJECTS_IN_ORGANIZATION_WITH_PAGINATION
2. Find project by name in results
3. Extract id (numeric) for use in other endpoints

功能标志名称 -> 标志 ID：

1. Call POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS with project_id
2. Find flag by key or name
3. Extract id for detailed operations

功能标志定向

功能标志支持精细的定向：

{
  "filters": {
    "groups": [
      {
        "properties": [
          {"key": "email", "value": "@company.com", "operator": "icontains"}
        ],
        "rollout_percentage": 100
      },
      {
        "properties": [],
        "rollout_percentage": 10
      }
    ]
  }
}

• 分组按顺序评估；第一个匹配的分组决定发布范围
• 属性根据用户特征筛选用户
• 发布百分比决定匹配用户中看到该标志的比例

分页

• 事件：使用 offset 和 limit（基于偏移量）
• 功能标志：使用 offset 和 limit（基于偏移量）
• 项目：使用 offset 和 limit（基于偏移量）
• 持续进行直到结果数组为空或小于 limit

已知注意事项

项目 ID：

• 大多数 API 端点都需要
• 始终先将项目名称解析为数字 ID
• 一个组织中可以存在多个项目

事件命名：

• 系统事件使用 $ 前缀（$pageview、$identify、$autocapture）
• 自定义事件不应使用 $ 前缀
• 事件名称区分大小写；保持一致

功能标志：

• 标志键在项目内必须唯一
• 标志键使用 kebab-case
• 更改会在几秒内传播
• 删除标志是永久性的；考虑改为禁用

速率限制：

• 事件摄取有吞吐量限制
• 尽可能批量处理事件以提高效率
• API 端点有每分钟速率限制

响应解析：

• 响应数据可能嵌套在 data 或 results 键下
• 分页响应包括 count、next、previous 字段
• 事件属性是嵌套对象；请谨慎访问
• 对可选字段使用回退值进行防御性解析

快速参考

任务	工具 Slug	关键参数
捕获事件	POSTHOG_CAPTURE_EVENT	event, distinct_id, properties
列出事件	POSTHOG_LIST_AND_FILTER_PROJECT_EVENTS	project_id, event, after, before
列出功能标志	POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS	project_id
获取标志详情	POSTHOG_RETRIEVE_FEATURE_FLAG_DETAILS	project_id, id
创建标志	POSTHOG_CREATE_FEATURE_FLAGS_FOR_PROJECT	project_id, key, filters
列出项目	POSTHOG_LIST_PROJECTS_IN_ORGANIZATION_WITH_PAGINATION	organization_id
我是谁	POSTHOG_WHOAMI	（无）
用户资料	POSTHOG_RETRIEVE_CURRENT_USER_PROFILE	（无）

何时使用

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

限制

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

写入前，请确认项目、事件负载以及功能标志的确切定向和发布范围。启用中的标志会影响真实用户；请保留回滚配置，并测试范围受限的发布。不要导出个人或事件数据，也不要记录查询结果中的项目 API 密钥。事件捕获确认不代表查询已可用；请限制轮询时长，并在重试时保留插入标识符。