posthog-install-auth
Install and configure PostHog SDK/CLI authentication.Use when setting up a new PostHog integration, configuring API keys,or initializing PostHog in your project.Trigger with phrases like "install posthog", "setup posthog","posthog auth", "configure posthog API key".
When & Why to Use This Skill
This Claude skill automates the installation and configuration of the PostHog SDK and CLI for both Node.js and Python environments. It streamlines the developer onboarding process by handling package management (npm/pip), secure API key authentication, and environment variable setup, ensuring a fast and error-free integration of product analytics into any codebase.
Use Cases
- Quickly initializing PostHog in a new web application to start tracking user behavior and events.
- Configuring server-side analytics by installing the PostHog Python SDK and setting up necessary environment variables.
- Automating the creation of .env files and API key configurations to maintain security best practices during development.
- Troubleshooting initial connection issues by verifying SDK installation and authentication credentials against PostHog's API.
| name | posthog-install-auth |
|---|---|
| description | | |
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
PostHog Install & Auth
Overview
Set up PostHog SDK/CLI and configure authentication credentials.
Prerequisites
- Node.js 18+ or Python 3.10+
- Package manager (npm, pnpm, or pip)
- PostHog account with API access
- API key from PostHog dashboard
Instructions
Step 1: Install SDK
# Node.js
npm install @posthog/sdk
# Python
pip install posthog
Step 2: Configure Authentication
# Set environment variable
export POSTHOG_API_KEY="your-api-key"
# Or create .env file
echo 'POSTHOG_API_KEY=your-api-key' >> .env
Step 3: Verify Connection
// Test connection code here
Output
- Installed SDK package in node_modules or site-packages
- Environment variable or .env file with API key
- Successful connection verification output
Error Handling
| Error | Cause | Solution |
|---|---|---|
| Invalid API Key | Incorrect or expired key | Verify key in PostHog dashboard |
| Rate Limited | Exceeded quota | Check quota at https://docs.posthog.com |
| Network Error | Firewall blocking | Ensure outbound HTTPS allowed |
| Module Not Found | Installation failed | Run npm install or pip install again |
Examples
TypeScript Setup
import { PostHogClient } from '@posthog/sdk';
const client = new PostHogClient({
apiKey: process.env.POSTHOG_API_KEY,
});
Python Setup
from posthog import PostHogClient
client = PostHogClient(
api_key=os.environ.get('POSTHOG_API_KEY')
)
Resources
Next Steps
After successful auth, proceed to posthog-hello-world for your first API call.