PostHog 事件漏斗与留存分析

解决数据接入与分析的碎片化

在产品分析的日常工作中，工程师和分析师经常需要在 PostHog 和自动化流程之间反复横跳。无论是通过代码手动埋点、在界面里配置漏斗，还是编写脚本调用 API 拉取事件数据，这些操作都容易因为环境配置繁琐、参数传递不一致而出错。当需要批量捕获事件、动态调整功能开关或跨项目查询数据时，手动操作不仅耗时，还难以保证操作的一致性和可追溯性。

核心能力与工作流

该技能通过 Rube MCP 接入 Composio 的 PostHog 工具包，将产品分析能力封装为可编程的工具序列，从而无缝融入自动化工作流。在使用前，需确保已连接 Rube MCP 并通过 RUBE_MANAGE_CONNECTIONS 激活 PostHog 连接。

核心工作流涵盖以下关键环节：

• 事件捕获与查询：使用 POSTHOG_CAPTURE_EVENT 发送事件数据，支持自定义事件名、distinct_id 及属性对象。通过 POSTHOG_LIST_AND_FILTER_PROJECT_EVENTS 按时间范围和事件名检索历史数据。
• 功能开关管理：利用 POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS 和 POSTHOG_CREATE_FEATURE_FLAGS_FOR_PROJECT 创建或修改目标规则，控制灰度发布比例。
• 项目与身份校验：调用 POSTHOG_LIST_PROJECTS_IN_ORGANIZATION_WITH_PAGINATION 获取项目 ID，或通过 POSTHOG_WHOAMI 验证 API 权限与组织归属。

适用边界与工程注意点

该技能适用于明确的数据分析和产品运营场景，但并非万能替代品。使用时需注意：

• ID 解析：大多数 API 端点依赖数字类型的 project_id，必须先解析项目名称。
• 命名规范：系统事件（如 $pageview）强制使用 $ 前缀，而自定义事件应避免使用，且事件名区分大小写。
• 分页与限流：事件和项目列表采用基于 offset 的分页机制；事件摄入存在吞吐量限制，高频操作需考虑批处理。
• 响应解析：返回的数据可能嵌套在 data 或 results 键下，事件属性为嵌套对象，需进行防御性解析。