121 lines
2.6 KiB
Markdown
121 lines
2.6 KiB
Markdown
---
|
|
description: Analyze user behavior patterns and cohorts using PostHog
|
|
category: analytics
|
|
tools: Task, TodoWrite
|
|
model: inherit
|
|
version: 1.0.0
|
|
---
|
|
|
|
# Analyze User Behavior
|
|
|
|
Query PostHog to understand user behavior patterns, cohorts, and product usage.
|
|
|
|
## Prerequisites
|
|
|
|
- PostHog MCP must be enabled (this plugin should be enabled)
|
|
- `POSTHOG_AUTH_HEADER` environment variable configured
|
|
- Access to PostHog project
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
/analyze-user-behavior <query>
|
|
|
|
Examples:
|
|
/analyze-user-behavior "checkout abandonment last 30 days"
|
|
/analyze-user-behavior "feature adoption for new dashboard"
|
|
/analyze-user-behavior "user retention cohorts by signup month"
|
|
```
|
|
|
|
## What This Command Does
|
|
|
|
Uses PostHog MCP tools to:
|
|
|
|
1. Query user events and properties
|
|
2. Analyze cohorts and segments
|
|
3. Calculate conversion metrics
|
|
4. Identify behavior patterns
|
|
5. Generate insights with charts/data
|
|
|
|
## Available PostHog Capabilities
|
|
|
|
When this plugin is enabled, you have access to ~43 PostHog tools:
|
|
|
|
**User Analysis**:
|
|
|
|
- Query user properties and events
|
|
- Segment users by behavior
|
|
- Track user journeys
|
|
- Analyze cohort retention
|
|
|
|
**Product Metrics**:
|
|
|
|
- Feature usage tracking
|
|
- Conversion funnel analysis
|
|
- A/B test results
|
|
- Session replay analysis
|
|
|
|
**Trends & Insights**:
|
|
|
|
- Event trends over time
|
|
- User engagement metrics
|
|
- Feature adoption rates
|
|
- Custom dashboard queries
|
|
|
|
## Example Queries
|
|
|
|
### Conversion Analysis
|
|
|
|
```bash
|
|
/analyze-user-behavior "Show conversion rate from signup to first purchase, broken down by traffic source"
|
|
```
|
|
|
|
### Feature Adoption
|
|
|
|
```bash
|
|
/analyze-user-behavior "How many users adopted the new search feature in the last week?"
|
|
```
|
|
|
|
### Retention Cohorts
|
|
|
|
```bash
|
|
/analyze-user-behavior "Show weekly retention for users who signed up in December 2024"
|
|
```
|
|
|
|
### User Journey
|
|
|
|
```bash
|
|
/analyze-user-behavior "What's the typical path users take before upgrading to paid plan?"
|
|
```
|
|
|
|
## Output Format
|
|
|
|
The command will:
|
|
|
|
1. Translate your natural language query to PostHog API calls
|
|
2. Fetch relevant data
|
|
3. Present findings with:
|
|
- Key metrics and numbers
|
|
- Trends and patterns
|
|
- Visualizations (when possible)
|
|
- Actionable insights
|
|
|
|
## Tips
|
|
|
|
- Be specific about time ranges ("last 30 days", "this quarter")
|
|
- Mention specific events or features by name
|
|
- Ask for comparisons ("vs last month", "broken down by...")
|
|
- Request segmentation ("by country", "by plan type")
|
|
|
|
## Context Cost
|
|
|
|
**This plugin adds ~40,645 tokens** to your context window. Disable when not analyzing metrics:
|
|
|
|
```bash
|
|
/plugin disable catalyst-analytics
|
|
```
|
|
|
|
---
|
|
|
|
**See also**: `/product-metrics`, `/segment-analysis`
|