posthog-automation

PostHog Automation 通过 Rube MCP 与 Composio 的 PostHog 工具包对接，用于自动化 PostHog 的产品分析与功能开关管理任务。

一、用途 该技能用于在客户端中通过 MCP 协议自动化执行 PostHog 相关操作，包括事件捕获、事件查询与筛选、功能开关的创建与管理、项目与组织信息的查看，以及当前 API 用户身份的核验。

二、主要能力

1. 捕获事件：使用 POSTHOG_CAPTURE_EVENT 向 PostHog 发送一条或多条事件，参数包括 event（事件名称）、distinct_id（必填的用户唯一标识）、properties（事件属性对象）与 timestamp（可选，ISO 8601 时间戳，默认使用服务器时间）。系统事件使用 $ 前缀（如 $pageview、$identify），自定义事件不应使用 $ 前缀；事件为异步处理，通常有数秒的摄取延迟。
2. 查询与筛选事件：使用 POSTHOG_LIST_AND_FILTER_PROJECT_EVENTS 按项目查询事件，参数含 project_id（必填）、event、person_id、after、before、limit、offset。日期筛选使用 ISO 8601 格式；大数据量需分页；结果默认按时间倒序返回，事件属性为嵌套结构需谨慎解析。
3. 管理功能开关：使用 POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS 列出开关，POSTHOG_RETRIEVE_FEATURE_FLAG_DETAILS 获取开关详情，POSTHOG_CREATE_FEATURE_FLAGS_FOR_PROJECT 创建开关。创建参数包括 project_id、key（开关键，项目内唯一，建议使用 kebab-case）、name、filters（定向规则与放量百分比）、active（是否启用）。开关键在项目内必须唯一；active 为 true 时立即对匹配用户生效；变更通常在数秒内传播。
4. 管理项目：使用 POSTHOG_LIST_PROJECTS_IN_ORGANIZATION_WITH_PAGINATION 列出组织内的项目，参数含 organization_id（视认证方式可能可选）、limit、offset。项目 ID 为数字，是多数其他接口的参数；分页为 offset 方式，需迭代直至结果为空。
5. 用户资料与认证：使用 POSTHOG_WHOAMI 检查 API 连通性，使用 POSTHOG_RETRIEVE_CURRENT_USER_PROFILE 获取当前用户的详情、权限与组织信息，两者均无需参数。

三、使用方式 前置条件：Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）；通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 posthog 的 PostHog 连接并确认状态为 ACTIVE；每次操作前应先调用 RUBE_SEARCH_TOOLS 获取最新工具 schema。 设置：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器，无需 API key，添加端点即可工作；确认 RUBE_SEARCH_TOOLS 有响应；调用 RUBE_MANAGE_CONNECTIONS 并选择 posthog；若连接非 ACTIVE，按返回的授权链接完成 PostHog 认证；确认连接状态为 ACTIVE 后再执行任何工作流。 常见模式：ID 解析方面，可先列出组织内项目，按名称找到项目并提取数字 id 供其他接口使用；功能开关可由名称查找后提取 id 以进行详情操作。功能开关定向支持按组配置，组内 properties 按用户特征过滤，rollout_percentage 决定匹配用户中看到该开关的比例，多个组按顺序评估，首个匹配的组决定放量。分页方面，事件、功能开关、项目均使用 offset 与 limit，持续拉取直至结果数组为空或小于 limit。

四、适用场景 适用于在 AI 工作流或自动化流程中集成 PostHog 分析能力，例如发送自定义事件用于埋点、批量查询与筛选项目事件、自动化创建与管理功能开关以实现灰度发布与定向放量、查看项目与组织信息，以及核验 API 访问权限。

五、限制与注意事项 项目 ID 为多数接口所必需，应先将项目名称解析为数字 ID；一个组织可有多个项目。事件名称区分大小写，需保持一致；系统事件使用 $ 前缀，自定义事件不应使用。功能开关键项目内唯一，删除操作不可恢复，可考虑改为禁用而非删除。事件摄取有吞吐限制，应尽量批量发送；API 接口有每分钟速率限制。响应数据可能嵌套在 data 或 results 键下，分页响应包含 count、next、previous 字段，事件属性为嵌套对象，应带 fallback 防御性解析。

六、快速参考 捕获事件：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（无参数）。

资料未提供收费、价格、具体效果或平台支持范围的信息。