hvac-marketing-skills/tools/integrations/mixpanel.md
bengizmo 1e70d8387b
Some checks failed
Sync Skills / sync (push) Has been cancelled
Validate Agent Skill / detect-changes (push) Has been cancelled
Validate Agent Skill / validate (push) Has been cancelled
feat: fork marketingskills → HVAC Marketing Skills for Compendium
- 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>
2026-03-10 21:05:49 -03:00

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