get_clarity_insights
Get Microsoft Clarity dashboard insights for the last 1-3 days: traffic, scroll depth, engagement, rage/dead clicks, and script errors, with optional breakdown by up to three dimensions and URL filter.
Instructions
Fetch Microsoft Clarity dashboard insights (traffic, scroll depth, engagement time, rage/dead clicks, script errors, etc.) for the last 1-3 days, optionally broken down by up to 3 dimensions. IMPORTANT: Clarity's API only supports a rolling 1-3 day lookback (no custom date ranges), and this project is limited to 10 requests per day total, so batch dimensions thoughtfully rather than making repeated calls. Optional urlFilter applies a case-insensitive substring match on the URL field AFTER Clarity returns its response (post-processing only) — results are still capped at Clarity's 1,000-row response limit, so a very broad urlFilter on a large site can still be affected by rows Clarity already dropped before filtering ever sees them. If urlFilter is set and none of dimension1-3 is 'URL', it's auto-added to the first open slot; if all 3 are already used by other dimensions, the call fails with an error asking you to free a slot.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| numOfDays | Yes | How many days back to pull data for: 1 = last 24h, 2 = last 48h, 3 = last 72h. | |
| urlFilter | No | Case-insensitive substring match on the URL field, applied AFTER Clarity returns data (post-processing only). | |
| dimension1 | No | Optional first breakdown dimension. | |
| dimension2 | No | Optional second breakdown dimension. | |
| dimension3 | No | Optional third breakdown dimension. |