mcpField
I
integration-javascript_node

integration-javascript_node

github.com/posthog开发76130 次安装今天更新
代码仓库

关于 integration-javascript_node

用于指导在 JavaScript Node 应用中集成 PostHog 分析的 Skill，提供分步工作流及 Node.js 特定建议，涵盖事件跟踪、用户识别和错误捕获。

主要功能

  1. 01按顺序执行设置与修订
  2. 02Node.js SDK 使用指导
  3. 03在路由处理中跟踪事件
  4. 04用户识别模式指导
  5. 05异常捕获指导
  6. 06通过环境变量管理密钥

适用场景

  1. 01为 Node.js 应用添加 PostHog
  2. 02跟踪路由中的创建、更新和删除
  3. 03在登录或注册时识别用户
  4. 04在 API 边界添加错误跟踪

安装

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

$npx skills add https://github.com/posthog/skills --skill integration-javascript_node

安装后在 Claude Code 中输入/integration-javascript_node确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
basic-integration-1.0-begin.md
basic-integration-1.3-conclude.md
basic-integration-1.2-revise.md
basic-integration-1.1-edit.md
identify-users.md
posthog-node.md
node.md

详细介绍

JavaScript Node 的 PostHog 集成

此技能可帮助你在 JavaScript Node 应用程序中添加 PostHog 分析。

工作流

按顺序完成集成：

  1. basic-integration-1.0-begin.md - PostHog 设置 - 开始 ← 从这里开始
  2. basic-integration-1.1-edit.md - PostHog 设置 - 编辑
  3. basic-integration-1.2-revise.md - PostHog 设置 - 修订
  4. basic-integration-1.3-conclude.md - PostHog 设置 - 结束

参考文件

  • references/node.md - Node.js - 文档
  • references/posthog-node.md - PostHog Node.js SDK
  • references/identify-users.md - 识别用户 - 文档
  • references/basic-integration-1.0-begin.md - PostHog 设置 - 开始
  • references/basic-integration-1.1-edit.md - PostHog 设置 - 编辑
  • references/basic-integration-1.2-revise.md - PostHog 设置 - 修订
  • references/basic-integration-1.3-conclude.md - PostHog 设置 - 结束

示例项目展示了目标实现模式。请查阅文档了解 API 详情。

核心原则

  • 环境变量：始终使用环境变量存储 PostHog 密钥。切勿将其硬编码。
  • 最小改动：在现有集成旁添加 PostHog 代码。不要替换或重构现有代码。
  • 遵循示例：实现应尽可能贴合示例项目中的模式。

框架指南

  • posthog-node 是 Node.js 服务端 SDK 包名——服务端切勿使用 posthog-js
  • 在 PostHog 构造函数选项中包含 enableExceptionAutocapture: true
  • 在路由处理程序中针对有意义的用户操作添加 posthog.capture() 调用——每个创建、更新或删除数据的路由都应使用上下文属性跟踪事件
  • 在应用程序的错误处理程序中添加 posthog.captureException(err, distinctId)（例如，Express 错误中间件、Fastify setErrorHandler、Koa app.on('error')）
  • 对于长时间运行的服务器，SDK 会自动批量发送事件——除非有特定原因，否则切勿设置 flushAt 或 flushInterval
  • 对于短生命周期进程（脚本、CLI、无服务器函数），将 flushAt 设为 1、flushInterval 设为 0，以立即发送事件
  • 服务端 Node.js 无需反向代理——只有客户端 JavaScript 需要代理来避免广告拦截器
  • 请记住，源代码位于 node_modules 目录中
  • 检查 package.json 中的类型检查或构建脚本，以验证更改

识别用户

在登录和注册事件期间识别用户。请参考示例代码和文档，了解此框架的正确识别模式。如果前后端代码都存在，请使用 X-POSTHOG-DISTINCT-ID 和 X-POSTHOG-SESSION-ID 标头传递客户端会话和 distinct ID，以维持关联。

错误跟踪

在相关文件中添加 PostHog 错误跟踪，尤其是在关键用户流程和 API 边界处。

评论

支持 Markdown