insight-clarity

Analyze Microsoft Clarity user behavior data and generate HTML dashboards with quota-managed caching.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/natthasath/natthasath-marketplace --skill insight-clarity-natthasath
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: insight-clarity
Source: https://github.com/natthasath/natthasath-marketplace/tree/main/plugins/insight/skills/insight-clarity
Command: npx skills add https://github.com/natthasath/natthasath-marketplace --skill insight-clarity-natthasath

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Microsoft Clarity's Data Export API allows only 10 requests per day per project, so repeated analysis questions can silently exhaust the daily quota. This Skill analyzes website user behavior (rage clicks, dead clicks, scroll depth, engagement time) through the official Clarity MCP server while enforcing a mandatory local cache and quota check before every API call. ## Core Features & Use Cases - Quota-Safe API Access: Every call to the Clarity MCP tools passes through a local cache script that checks for same-day cached results, tracks daily usage, and blocks calls when the quota is exhausted. - Three Analysis Modes: Per-page UX health checks (rage clicks, dead clicks, excessive scrolling), engagement time and scroll depth analysis, and retrieval of notable session recordings filtered by URL, device, browser, OS, country, or city. - Self-Contained Dashboard Output: Results are rendered as an HTML Artifact dashboard with stat tiles, session recording links, a cache/fresh data label, and the remaining daily quota in the footer. - Use Case: A site owner asks why visitors are not clicking a signup button. The Skill checks the cache, queries Clarity for rage and dead clicks on that page within the 3-dimension and 3-day API limits, and produces a dashboard showing where users actually struggle. ## Quick Start Run /insight-clarity with your Clarity project ID and ask it to analyze rage clicks and scroll depth on a specific page of your website.

Frequently Asked Questions about insight-clarity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze rage clicks and dead clicks with Microsoft Clarity?▼

Connect the official microsoft/clarity-mcp-server MCP tools with an API token from your Clarity project settings, then request a UX health check for a specific URL. The Skill queries rage clicks, dead clicks, and excessive scrolling metrics and renders them in an HTML dashboard.

What is the Microsoft Clarity API rate limit per day?▼

The Clarity Data Export API allows only 10 requests per day per project, resetting at midnight UTC. It also limits queries to a 3-day lookback and a maximum of 3 dimensions per request, so the Skill caches every response and checks the cache before any real API call.

How do I get a Microsoft Clarity API token for the MCP server?▼

Generate the token in your Clarity project under Settings, Data Export, Generate new API token. The Skill does not install the MCP server or request tokens; it only works after the get-clarity-data and list-sessions tools are already connected.

Can I filter Clarity session recordings by device or country?▼

Yes, the list-sessions tool supports filtering by URL, device, browser, OS, country, and city. The Skill uses these filters to find sessions with abnormal signals such as high rage clicks so you can review the recordings manually.

What happens when the Clarity daily quota runs out?▼

When the quota reaches zero the Skill refuses to call the API and informs you that it resets at midnight UTC. It suggests using any relevant cached data from earlier queries instead of making new requests.