mcpField
I
integration-python

integration-python

github.com/posthog数据与数据库7692 次安装今天更新
代码仓库

关于 integration-python

此技能帮助 Python 应用集成 PostHog 分析，提供分阶段流程、示例代码及事件追踪、用户识别和错误捕获指南。

主要功能

  1. 01四步集成流程
  2. 02Python 与 PostHog 参考资料
  3. 03通过环境变量管理密钥
  4. 04事件追踪与用户识别
  5. 05异常捕获及关闭指南

适用场景

  1. 01为 Python 应用添加 PostHog 分析
  2. 02追踪用户活动并避免在事件中发送个人信息
  3. 03在 API 边界添加错误追踪

安装

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

$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 安装依赖，切勿在 shell 命令中直接使用未加引号的版本限定符，例如 >=
  • 在 CLI 和脚本中：退出前必须调用 posthog.shutdown()，否则所有事件都会丢失
  • 始终使用 Posthog() 类构造函数（基于实例的 API），不要使用模块级别的 posthog.api_key 配置
  • 始终在 Posthog() 构造函数中加入 enable_exception_autocapture=True，以自动跟踪异常
  • 切勿在 capture() 事件属性中发送 PII——包括电子邮件、全名、电话号码、实际地址、IP 地址或用户生成的内容
  • PII 应放在 identify() 的个人属性中，而不是 capture() 的事件属性中。安全的事件属性包括 message_length、form_type、布尔标记等元数据
  • 使用 atexit.register() 注册 posthog_client.shutdown，确保退出时刷新所有事件
  • Python SDK 没有 identify() 方法——使用 posthog_client.set(distinct_id=user_id, properties={...}) 设置个人属性，或在上下文中使用 identify_context(user_id)

识别用户

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

错误跟踪

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

评论

支持 Markdown