mcpField
I
integration-javascript_node

integration-javascript_node

github.com/posthog開発76130 回インストール今日更新
リポジトリ

integration-javascript_node について

JavaScript Node アプリに PostHog 分析を追加するためのスキルです。段階的な手順に加え、イベント計測、ユーザー識別、エラー捕捉などの Node.js 向け指針を示します。

主な機能

  1. 01順序に沿った設定と見直し
  2. 02Node.js SDK の利用指針
  3. 03ルートハンドラーでのイベント計測
  4. 04ユーザー識別パターンの案内
  5. 05例外捕捉の指針
  6. 06環境変数によるキー管理

活用シーン

  1. 01Node.js アプリへの PostHog 導入
  2. 02作成・更新・削除ルートの計測
  3. 03ログインや登録時のユーザー識別
  4. 04API 境界へのエラー追跡追加

インストール

コマンドをコピーしてターミナルで実行します。

$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() を追加してください。データを作成、更新、削除する各ルートでは、コンテキスト情報を含むプロパティとともにイベントをトラッキングしてください
  • アプリケーションのエラーハンドラー（Express のエラーミドルウェア、Fastify の setErrorHandler、Koa の app.on('error') など）に posthog.captureException(err, distinctId) を追加してください
  • 長時間稼働するサーバーでは、SDK がイベントを自動的にバッチ処理します。特別な理由がない限り、flushAt や flushInterval は設定しないでください
  • 短時間で終了するプロセス（スクリプト、CLI、サーバーレス）の場合は、イベントをすぐに送信するため、flushAt を 1、flushInterval を 0 に設定してください
  • サーバーサイドの Node.js ではリバースプロキシは不要です。広告ブロッカーを回避するためにプロキシが必要なのは、クライアントサイドの JavaScript のみです
  • ソースコードは node_modules ディレクトリにあることを忘れないでください
  • 変更を検証するには、package.json で型チェックやビルドのスクリプトを確認してください

ユーザーの識別

ログインおよびサインアップのイベント時にユーザーを識別してください。このフレームワークで適切な識別パターンを使うには、サンプルコードとドキュメントを参照してください。フロントエンドとバックエンドの両方のコードがある場合は、クライアント側のセッション ID と distinct ID を X-POSTHOG-DISTINCT-ID および X-POSTHOG-SESSION-ID ヘッダーで渡し、相関関係を維持してください。

エラートラッキング

関連ファイル、特に重要なユーザーフローや API 境界の周辺に、PostHog のエラートラッキングを追加してください。

コメント

Markdown 対応