feat: add 23 new CLI tools and integration guides
New tools across 13 categories: - Email/Newsletter: beehiiv, klaviyo, postmark, brevo, activecampaign - Data Enrichment: clearbit, apollo - CRO/Testing: hotjar, optimizely - Analytics: plausible - Scheduling: calendly, savvycal - Forms: typeform - Messaging: intercom - Social: buffer - Video: wistia - Payments: paddle - Affiliate: partnerstack - Reviews: trustpilot, g2 - Push: onesignal - Webinar: demio, livestorm Each tool includes a zero-dependency CLI and integration guide. Registry and CLI README updated with all new entries. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,147 @@
|
||||
# Hotjar
|
||||
|
||||
Behavior analytics platform with heatmaps, session recordings, and surveys for understanding user experience.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Surveys, Responses, Sites, Heatmaps, Recordings |
|
||||
| MCP | - | Not available |
|
||||
| CLI | ✓ | [hotjar.js](../clis/hotjar.js) |
|
||||
| SDK | ✓ | JavaScript tracking snippet, Identify API, Events API |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: OAuth 2.0 Client Credentials
|
||||
- **Token endpoint**: `POST https://api.hotjar.io/v1/oauth/token`
|
||||
- **Header**: `Authorization: Bearer {access_token}`
|
||||
- **Get credentials**: Hotjar Dashboard > Integrations > API
|
||||
- **Token expiry**: 3600 seconds (1 hour)
|
||||
|
||||
### Token Request
|
||||
|
||||
```bash
|
||||
POST https://api.hotjar.io/v1/oauth/token
|
||||
Content-Type: application/x-www-form-urlencoded
|
||||
|
||||
grant_type=client_credentials&client_id={client_id}&client_secret={client_secret}
|
||||
```
|
||||
|
||||
### Token Response
|
||||
|
||||
```json
|
||||
{
|
||||
"access_token": "<token>",
|
||||
"token_type": "Bearer",
|
||||
"expires_in": 3600
|
||||
}
|
||||
```
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### List Sites
|
||||
|
||||
```bash
|
||||
GET https://api.hotjar.io/v1/sites
|
||||
|
||||
Authorization: Bearer {access_token}
|
||||
```
|
||||
|
||||
### List Surveys
|
||||
|
||||
```bash
|
||||
GET https://api.hotjar.io/v1/sites/{site_id}/surveys
|
||||
|
||||
Authorization: Bearer {access_token}
|
||||
```
|
||||
|
||||
### Get Survey Responses
|
||||
|
||||
```bash
|
||||
GET https://api.hotjar.io/v1/sites/{site_id}/surveys/{survey_id}/responses?limit=100
|
||||
|
||||
Authorization: Bearer {access_token}
|
||||
```
|
||||
|
||||
Supports cursor-based pagination with `cursor` and `limit` parameters.
|
||||
|
||||
### List Heatmaps
|
||||
|
||||
```bash
|
||||
GET https://api.hotjar.io/v1/sites/{site_id}/heatmaps
|
||||
|
||||
Authorization: Bearer {access_token}
|
||||
```
|
||||
|
||||
### List Recordings
|
||||
|
||||
```bash
|
||||
GET https://api.hotjar.io/v1/sites/{site_id}/recordings
|
||||
|
||||
Authorization: Bearer {access_token}
|
||||
```
|
||||
|
||||
### List Forms
|
||||
|
||||
```bash
|
||||
GET https://api.hotjar.io/v1/sites/{site_id}/forms
|
||||
|
||||
Authorization: Bearer {access_token}
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Survey Response Data
|
||||
- `response_id` - Unique response identifier
|
||||
- `answers` - Array of question/answer pairs
|
||||
- `created_at` - Response timestamp
|
||||
- `device_type` - Desktop, mobile, tablet
|
||||
|
||||
### Heatmap Data
|
||||
- `url` - Page URL
|
||||
- `click_count` - Total clicks tracked
|
||||
- `visitors` - Unique visitors
|
||||
- `created_at` - Heatmap creation date
|
||||
|
||||
### Recording Data
|
||||
- `recording_id` - Unique recording ID
|
||||
- `duration` - Session duration
|
||||
- `pages_visited` - Pages in session
|
||||
- `device` - Device information
|
||||
|
||||
## Parameters
|
||||
|
||||
### Survey Responses
|
||||
- `limit` - Results per page (default: 100)
|
||||
- `cursor` - Pagination cursor from previous response
|
||||
- `sort` - Sort order (default: created_at desc)
|
||||
|
||||
### Recordings
|
||||
- `limit` - Results per page
|
||||
- `cursor` - Pagination cursor
|
||||
- `date_from` - Start date filter
|
||||
- `date_to` - End date filter
|
||||
|
||||
## When to Use
|
||||
|
||||
- Analyzing user behavior patterns on landing pages
|
||||
- Collecting qualitative feedback via on-site surveys
|
||||
- Identifying UX issues through session recordings
|
||||
- Understanding scroll depth and engagement via heatmaps
|
||||
- Validating CRO hypotheses with user behavior data
|
||||
- Form abandonment analysis
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- 3000 requests/minute (50 per second)
|
||||
- Rate limited by source IP address
|
||||
- Cursor-based pagination for large result sets
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- page-cro
|
||||
- ab-test-setup
|
||||
- analytics-tracking
|
||||
- ux-audit
|
||||
- landing-page
|
||||
Reference in New Issue
Block a user