ComposioHQ/Microsoft-Clarity-Automation

Microsoft Clarity Automatisierung

Exportieren Sie Microsoft Clarity-Analysedaten zum Nutzerverhalten direkt aus Claude Code. Rufen Sie Heatmap-Daten, Sitzungsmetriken und Engagement-Erkenntnisse ab, die nach mehreren Dimensionen segmentiert sind, ohne Ihr Terminal verlassen zu müssen.

Toolkit-Dokumentation: composio.dev/toolkits/microsoft_clarity

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Microsoft Clarity-Konto, wenn Sie dazu aufgefordert werden. Der Agent stellt einen Authentifizierungslink bereit.
3. Stellen Sie sicher, dass in Ihrem Clarity-Projekt ausreichend Datenerfassung für die gewünschten Dimensionen aktiviert ist.

---

Kern-Workflows

1. Aktuelle Analysedaten exportieren

Exportieren Sie Clarity-Analysedaten der letzten 1-3 Tage, segmentiert nach bis zu drei Dimensionen gleichzeitig.

Werkzeug: MICROSOFT_CLARITY_DATA_EXPORT

Wichtige Parameter:

• numOfDays (erforderlich) – Anzahl der zu exportierenden Tage: 1 (letzte 24h), 2 (letzte 48h) oder 3 (letzte 72h)
• dimension1 – erste Aufschlüsselungsdimension
• dimension2 – zweite Aufschlüsselungsdimension (optional)
• dimension3 – dritte Aufschlüsselungsdimension (optional)

Verfügbare Dimensionen:

• Browser – Chrome, Firefox, Safari, Edge, etc.
• Device – Desktop, Mobil, Tablet
• Country/Region – geografischer Standort der Nutzer
• OS – Windows, macOS, iOS, Android, etc.
• Source – Verkehrsquelle (z.B. google, direkt, referral)
• Medium – Verkehrsmedium (organisch, cpc, referral, etc.)
• Campaign – Marketingkampagnenname
• Channel – Verkehrskanal-Gruppierung
• URL – spezifische Seiten-URLs

Beispielaufforderung: „Exportiere Clarity-Daten der letzten 24 Stunden, aufgeschlüsselt nach Gerät und Land/Region.“

---

2. Geräteleistungsanalyse

Analysieren Sie, wie sich das Nutzerverhalten je nach Gerätetyp unterscheidet, um das responsive Design zu optimieren.

Werkzeug: MICROSOFT_CLARITY_DATA_EXPORT

Konfiguration: numOfDays: 3, dimension1: "Device", dimension2: "Browser"

Beispielaufforderung: „Zeige mir Clarity-Metriken der letzten 3 Tage nach Gerät und Browser.“

---

3. Verkehrsquellen-Aufschlüsselung

Verstehen Sie, welche Verkehrsquellen die engagiertesten Nutzer liefern.

Werkzeug: MICROSOFT_CLARITY_DATA_EXPORT

Konfiguration: numOfDays: 2, dimension1: "Source", dimension2: "Medium"

Beispielaufforderung: „Exportiere Clarity-Daten der letzten 48 Stunden, aufgeschlüsselt nach Quelle und Medium.“

---

4. Geografisches Nutzerverhalten

Analysieren Sie Nutzerengagement-Muster über verschiedene Länder und Regionen hinweg.

Werkzeug: MICROSOFT_CLARITY_DATA_EXPORT

Konfiguration: numOfDays: 3, dimension1: "Country/Region", dimension2: "Device"

Beispielaufforderung: „Hole Clarity-Daten der letzten 72 Stunden, segmentiert nach Land/Region und Gerätetyp.“

---

5. Seitenleistung auf URL-Ebene

Untersuchen Sie, welche spezifischen URLs die höchsten oder niedrigsten Engagement-Metriken aufweisen.

Werkzeug: MICROSOFT_CLARITY_DATA_EXPORT

Konfiguration: numOfDays: 1, dimension1: "URL", dimension2: "Device"

Beispielaufforderung: „Exportiere die gestrigen Clarity-Daten, aufgeschlüsselt nach URL und Gerät.“

---

6. Kampagnenattributionsanalyse

Bewerten Sie die Effektivität von Marketingkampagnen anhand von Nutzerverhaltensmetriken.

Werkzeug: MICROSOFT_CLARITY_DATA_EXPORT

Konfiguration: numOfDays: 3, dimension1: "Campaign", dimension2: "Channel", dimension3: "Device"

Beispielaufforderung: „Zeige Clarity-Engagement-Daten der letzten 3 Tage nach Kampagne, Kanal und Gerät.“

---

Bekannte Fallstricke

• Begrenztes Zeitfenster: Der Datenexport ist auf die letzten 1, 2 oder 3 Tage beschränkt. Der Parameter numOfDays akzeptiert nur die Werte 1, 2 oder 3. Für längere historische Analysen müssen Sie Exporte regelmäßig durchführen und extern aggregieren.
• Exakte Schreibweise der Dimensionen: Dimensionswerte müssen exakt wie aufgelistet eingegeben werden (z.B. Country/Region, nicht country oder region). Groß-/Kleinschreibung und Schrägstriche sind wichtig.
• Maximal drei Dimensionen: Pro Export können Sie nach maximal drei Dimensionen segmentieren. Für komplexere Analysen führen Sie mehrere Exporte mit unterschiedlichen Dimensionskombinationen durch.
• Datenverfügbarkeitsverzögerung: Clarity-Daten können eine kurze Verarbeitungsverzögerung aufweisen. Sehr aktuelle Sitzungen (letzte Minuten) werden möglicherweise nicht in Exporten angezeigt.
• Eingeschränktes Werkzeug: Die Clarity-Integration bietet derzeit nur das Datenexport-Werkzeug. Für Heatmap-Visualisierungen und Sitzungsaufzeichnungen nutzen Sie direkt das Clarity-Web-Dashboard.
• Antwortgröße: Exporte mit vielen Ausprägungen bei Dimensionen wie URL in Kombination mit anderen Dimensionen können große Antwort-Payloads erzeugen. Ziehen Sie in Betracht, das Zeitfenster zu verkleinern oder weniger Dimensionen zu verwenden.

---

Kurzreferenz

Werkzeug-Slug	Beschreibung
MICROSOFT_CLARITY_DATA_EXPORT	Exportiert Analysedaten mit bis zu 3 Dimensionsaufschlüsselungen

Verfügbare Dimensionen:

Dimension	Beschreibung
Browser	Webbrowser (Chrome, Firefox, Safari, etc.)
Device	Gerätetyp (Desktop, Mobil, Tablet)
Country/Region	Geografischer Standort
OS	Betriebssystem
Source	Verkehrsquelle
Medium	Verkehrsmedium
Campaign	Marketingkampagne
Channel	Verkehrskanal-Gruppierung
URL	Spezifische Seiten-URL

---

Powered by Composio