mcpField
I
integration-python

integration-python

github.com/posthogデータ・データベース7692 回インストール今日更新
リポジトリ

integration-python について

Python アプリケーションへの PostHog 分析機能の追加を支援するスキルです。段階的な手順、サンプルコード、イベント追跡やユーザー識別、エラー捕捉の指針を提供します。

主な機能

  1. 014段階の統合ワークフロー
  2. 02Python と PostHog の参考資料
  3. 03環境変数によるキー管理
  4. 04イベント追跡とユーザー識別
  5. 05例外捕捉と終了処理の指針

活用シーン

  1. 01Python アプリへの PostHog 分析機能の追加
  2. 02イベント内の個人情報を避けたユーザー行動の追跡
  3. 03API 境界でのエラー追跡の追加

インストール

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

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

インストール後、Claude Code で/integration-pythonを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

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

詳細

Python 向け PostHog 統合

このスキルは、Python アプリケーションに 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/EXAMPLE.md - Python サンプルプロジェクトのコード
  • references/python.md - Python - ドキュメント
  • references/posthog-python.md - PostHog Python 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 のコードを追加してください。既存のコードを置き換えたり、構成し直したりしないでください。
  • サンプルに合わせる：実装は、できる限りサンプルプロジェクトのパターンに従ってください。

フレームワークのガイドライン

  • ソースコードは venv/site-packages ディレクトリにあることを覚えておいてください。
  • posthog は Python SDK のパッケージ名です。
  • pip install posthog または pip install -r requirements.txt で依存関係をインストールしてください。また、シェルコマンドで >= のような引用符で囲まれていないバージョン指定子を直接使用しないでください。
  • CLI とスクリプトでは、終了前に必ず posthog.shutdown() を呼び出してください。呼び出さないと、すべてのイベントが失われます。
  • モジュールレベルの posthog.api_key 設定ではなく、必ず Posthog() クラスのコンストラクター（インスタンスベースの API）を使用してください。
  • 例外を自動的に追跡するため、Posthog() コンストラクターには必ず enable_exception_autocapture=True を含めてください。
  • capture() のイベントプロパティに個人識別情報（PII）を送信してはいけません。メールアドレス、氏名、電話番号、住所、IP アドレス、ユーザー生成コンテンツは含めないでください。
  • PII は capture() のイベントプロパティではなく、identify() の人物プロパティに設定してください。安全なイベントプロパティは、message_length、form_type、ブール値のフラグなどのメタデータです。
  • 終了時にすべてのイベントがフラッシュされるよう、posthog_client.shutdown を atexit.register() に登録してください。
  • Python SDK に identify() メソッドはありません。人物プロパティを設定するには posthog_client.set(distinct_id=user_id, properties={...}) を使用するか、コンテキスト内で identify_context(user_id) を使用してください。

ユーザーの識別

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

エラートラッキング

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

コメント

Markdown 対応