- Forked from coreyhaines31/marketingskills v1.1.0 (MIT license) - Removed 4 SaaS-only skills (churn-prevention, paywall-upgrade-cro, onboarding-cro, signup-flow-cro) - Reworked 2 skills (popup-cro → hvac-estimate-popups, revops → hvac-lead-ops) - Adapted all 28 retained skills with HVAC industry context and Compendium integration - Created 10 new HVAC-specific skills: - hvac-content-from-data (flagship DB integration) - hvac-seasonal-campaign (demand cycle marketing) - hvac-review-management (GBP review strategy) - hvac-video-repurpose (long-form → social) - hvac-technical-content (audience-calibrated writing) - hvac-brand-voice (trade authenticity guide) - hvac-contractor-website-audit (discovery & analysis) - hvac-contractor-website-package (marketing package assembly) - hvac-compliance-claims (EPA/rebate/safety claim checking) - hvac-content-qc (fact-check & citation gate) - Renamed product-marketing-context → hvac-marketing-context (global) - Created COMPENDIUM_INTEGRATION.md (shared integration contract) - Added Compendium wrapper tools (search, scrape, classify) - Added compendium capability tags to YAML frontmatter - Updated README, AGENTS.md, CLAUDE.md, VERSIONS.md, marketplace.json - All 38 skills pass validate-skills.sh - Zero dangling references to removed/renamed skills Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
136 lines
2.5 KiB
Markdown
136 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
|