edcc34aa6d
Create centralized tools/ directory with REGISTRY.md index and 29 integration guides covering analytics, SEO, CRM, payments, referral, email, ads, automation, and commerce platforms. Each guide includes API endpoints, authentication, common operations, and links to relevant skills. Updated AGENTS.md and key skills (referral-program, analytics-tracking, email-sequence, paid-ads) with tool integration references. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
138 lines
2.5 KiB
Markdown
138 lines
2.5 KiB
Markdown
# Mixpanel
|
|
|
|
Product analytics platform for tracking user behavior and retention.
|
|
|
|
## Capabilities
|
|
|
|
| Integration | Available | Notes |
|
|
|-------------|-----------|-------|
|
|
| API | ✓ | Ingestion API, Query API, Data Export |
|
|
| MCP | - | Not available |
|
|
| CLI | - | Not available |
|
|
| SDK | ✓ | JavaScript, iOS, Android, Python, etc. |
|
|
|
|
## Authentication
|
|
|
|
- **Ingestion**: Project token (public)
|
|
- **Query API**: Service Account (username:secret as Basic auth)
|
|
- **Export**: API Secret
|
|
|
|
## Common Agent Operations
|
|
|
|
### Track event (Ingestion API)
|
|
|
|
```bash
|
|
POST https://api.mixpanel.com/track
|
|
|
|
{
|
|
"event": "signup_completed",
|
|
"properties": {
|
|
"token": "{project_token}",
|
|
"distinct_id": "user_123",
|
|
"plan": "pro",
|
|
"time": 1705312800
|
|
}
|
|
}
|
|
```
|
|
|
|
### Set user profile
|
|
|
|
```bash
|
|
POST https://api.mixpanel.com/engage
|
|
|
|
{
|
|
"$token": "{project_token}",
|
|
"$distinct_id": "user_123",
|
|
"$set": {
|
|
"$email": "user@example.com",
|
|
"$name": "John Doe",
|
|
"plan": "pro"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Query events (Query API)
|
|
|
|
```bash
|
|
POST https://mixpanel.com/api/2.0/insights
|
|
|
|
{
|
|
"project_id": {project_id},
|
|
"bookmark_id": null,
|
|
"params": {
|
|
"events": [{"event": "signup_completed"}],
|
|
"time_range": {
|
|
"from_date": "2024-01-01",
|
|
"to_date": "2024-01-31"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Get funnel data
|
|
|
|
```bash
|
|
GET https://mixpanel.com/api/2.0/funnels?funnel_id={funnel_id}&from_date=2024-01-01&to_date=2024-01-31
|
|
```
|
|
|
|
### Export raw events
|
|
|
|
```bash
|
|
GET https://data.mixpanel.com/api/2.0/export?from_date=2024-01-01&to_date=2024-01-01
|
|
```
|
|
|
|
### Get retention data
|
|
|
|
```bash
|
|
GET https://mixpanel.com/api/2.0/retention?from_date=2024-01-01&to_date=2024-01-31&retention_type=birth&born_event=signup_completed
|
|
```
|
|
|
|
## JavaScript SDK
|
|
|
|
```javascript
|
|
// Initialize
|
|
mixpanel.init('YOUR_TOKEN');
|
|
|
|
// Identify user
|
|
mixpanel.identify('user_123');
|
|
|
|
// Set user properties
|
|
mixpanel.people.set({
|
|
'$email': 'user@example.com',
|
|
'plan': 'pro'
|
|
});
|
|
|
|
// Track event
|
|
mixpanel.track('Feature Used', {
|
|
'feature_name': 'export'
|
|
});
|
|
```
|
|
|
|
## Key Concepts
|
|
|
|
- **Events** - User actions (signup, purchase, etc.)
|
|
- **Properties** - Attributes on events
|
|
- **User Profiles** - Persistent user data
|
|
- **Cohorts** - Saved user segments
|
|
- **Funnels** - Conversion sequences
|
|
- **Retention** - User return patterns
|
|
|
|
## When to Use
|
|
|
|
- Tracking product usage events
|
|
- Analyzing conversion funnels
|
|
- Measuring feature adoption
|
|
- Retention analysis
|
|
- User segmentation
|
|
|
|
## Rate Limits
|
|
|
|
- Ingestion: No hard limit (batch recommended)
|
|
- Query API: Varies by plan
|
|
|
|
## Relevant Skills
|
|
|
|
- analytics-tracking
|
|
- ab-test-setup
|
|
- onboarding-cro
|