用途:端到端检查 PostHog SDK 是否已加载并按预期发送事件。适合在运行 npx @posthog/wizard 后确认安装有效、部署影响分析或埋点代码后验证、客户反馈看不到事件时区分是片段、网络还是过滤问题,以及新站点或营销页上线前的冒烟测试。
主要能力与流程:第一步用 check_posthog_loading MCP 工具检查首页、关键产品页、登录、结账、营销页等目标 URL,返回各页面是否初始化 PostHog、加载方式(head_snippet / snippet / array_js_only)及初始化配置;重点关注 loaded 为 false 的页面、api_key 或 api_host 不一致的情况。第二步在已确认加载的 URL 上调用 simulate_new_user(模拟少量全新浏览器访问,确认首次访客触发 $pageview 并分配匿名 distinct_id)和 simulate_returning_user(同一会话内多次页面浏览,确认 cookie 持久且 $pageview 持续触发);至少采集到一个 $pageview 且无错误时返回 verified: true。第三步在 PostHog 界面交叉核对,排查约 30 秒的采集延迟、api_host 是否与项目采集主机一致、功能开关与采集警告。
验证标准:目标每个 URL 的 check_posthog_loading 均返回 loaded: true;两种模拟均每次访问至少返回一个 $pageview 且无错误;可选地在 1-2 分钟内于 PostHog 界面看到事件。
限制:不检查自定义事件(如 signup_completed),需自行驱动真实用户流程;不检查服务端采集,只观察浏览器 SDK 发送的内容;不验证会话录制质量,仅报告初始化配置中是否启用录制。