Microsoft Clarity Automation
Microsoft Clarity のユーザー行動分析データを Claude Code から直接エクスポートします。ターミナルを離れずに、ヒートマップデータ、セッションメトリクス、エンゲージメントインサイトを複数のディメンションでセグメント化して取得できます。
ツールキットドキュメント： composio.dev/toolkits/microsoft_clarity
セットアップ
- Composio MCP サーバーを設定に追加します：
https://rube.app/mcp - プロンプトに従って Microsoft Clarity アカウントを接続します。エージェントが認証リンクを提供します。
- 分析したいディメンションに対して、Clarity プロジェクトで十分なデータ収集が有効になっていることを確認します。
コアワークフロー
1. 最近の分析データをエクスポート
過去1〜3日間の Clarity 分析データを、最大3つのディメンションで同時にセグメント化してエクスポートします。
ツール： MICROSOFT_CLARITY_DATA_EXPORT
主なパラメータ：
numOfDays（必須）-- エクスポートする日数：1（過去24時間）、2（過去48時間）、3（過去72時間）dimension1-- 最初の分割ディメンションdimension2-- 2番目の分割ディメンション（オプション）dimension3-- 3番目の分割ディメンション（オプション）
利用可能なディメンション：
Browser-- Chrome、Firefox、Safari、Edge などDevice-- デスクトップ、モバイル、タブレットCountry/Region-- ユーザーの地理的位置OS-- Windows、macOS、iOS、Android などSource-- トラフィックソース（例：google、direct、referral）Medium-- トラフィックメディア（organic、cpc、referral など）Campaign-- マーケティングキャンペーン名Channel-- トラフィックチャネルグループURL-- 特定のページURL
プロンプト例：「デバイスと国/地域で分割した過去24時間の Clarity データをエクスポートして」
2. デバイスパフォーマンス分析
デバイスタイプ間でのユーザー行動の違いを分析し、レスポンシブデザインを最適化します。
ツール： MICROSOFT_CLARITY_DATA_EXPORT
設定：numOfDays: 3、dimension1: "Device"、dimension2: "Browser"
プロンプト例：「過去3日間のClarityメトリクスをデバイスとブラウザ別に表示して」
3. トラフィックソースの内訳
どのトラフィックソースが最もエンゲージメントの高いユーザーを呼び込んでいるかを理解します。
ツール： MICROSOFT_CLARITY_DATA_EXPORT
設定：numOfDays: 2、dimension1: "Source"、dimension2: "Medium"
プロンプト例：「過去48時間のClarityデータをソースとメディアで分割してエクスポートして」
4. 地理的なユーザー行動
さまざまな国や地域におけるユーザーエンゲージメントパターンを分析します。
ツール： MICROSOFT_CLARITY_DATA_EXPORT
設定：numOfDays: 3、dimension1: "Country/Region"、dimension2: "Device"
プロンプト例：「過去72時間のClarityデータを国/地域とデバイスタイプでセグメント化して取得して」
5. ページレベルのパフォーマンス
特定のURLが最も高い、または最も低いエンゲージメントメトリクスを持っているかを調べます。
ツール： MICROSOFT_CLARITY_DATA_EXPORT
設定：numOfDays: 1、dimension1: "URL"、dimension2: "Device"
プロンプト例：「昨日のClarityデータをURLとデバイスで分割してエクスポートして」
6. キャンペーンアトリビューション分析
ユーザー行動メトリクスを通じてマーケティングキャンペーンの効果を評価します。
ツール： MICROSOFT_CLARITY_DATA_EXPORT
設定：numOfDays: 3、dimension1: "Campaign"、dimension2: "Channel"、dimension3: "Device"
プロンプト例：「過去3日間のClarityエンゲージメントデータをキャンペーン、チャネル、デバイス別に表示して」
既知の問題点
- 時間枠の制限： データエクスポートは過去1、2、3日間に限定されます。
numOfDaysパラメータは1、2、3の値のみを受け付けます。より長期間の分析を行うには、定期的にエクスポートを実行し、外部で集計する必要があります。 - ディメンション名の完全一致： ディメンション値はリストされた通りに正確に一致させる必要があります（例：
Country/Regionであってcountryやregionではない）。大文字小文字とスラッシュも重要です。 - 最大3つのディメンション： 1回のエクスポートでセグメント化できるのは最大3つのディメンションまでです。より複雑な分析には、異なるディメンションの組み合わせで複数のエクスポートを実行してください。
- データ可用性の遅延： Clarity データには短い処理遅延が発生する場合があります。ごく最近のセッション（過去数分）はエクスポートに表示されないことがあります。
- 単一ツールの制限： Clarity 連携は現在、データエクスポートツールのみを提供しています。ヒートマップの視覚化やセッション録画については、Clarity のWebダッシュボードを直接使用してください。
- レスポンスサイズ：
URLのような高カーディナリティのディメンションを他のディメンションと組み合わせると、大きなペイロードが返される可能性があります。時間枠を狭めるか、使用するディメンションを減らすことを検討してください。
クイックリファレンス
| ツールスラッグ | 説明 |
|---|---|
MICROSOFT_CLARITY_DATA_EXPORT | 最大3つのディメンションで分析データをエクスポート |
利用可能なディメンション：
| ディメンション | 説明 |
|---|---|
Browser | Webブラウザ（Chrome、Firefox、Safariなど） |
Device | デバイスタイプ（デスクトップ、モバイル、タブレット） |
Country/Region | 地理的位置 |
OS | オペレーティングシステム |
Source | トラフィックソース |
Medium | トラフィックメディア |
Campaign | マーケティングキャンペーン |
Channel | トラフィックチャネルグループ |
URL | 特定のページURL |
Powered by Composio