Microsoft Clarity 자동화
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-- 두 번째 세분화 차원 (선택 사항)dimension3-- 세 번째 세분화 차원 (선택 사항)
사용 가능한 차원:
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개 차원: 내보내기당 최대 3개 차원으로만 세분화할 수 있습니다. 더 복잡한 분석을 위해서는 다양한 차원 조합으로 여러 번 내보내기를 실행하세요.
- 데이터 가용성 지연: Clarity 데이터는 약간의 처리 지연이 있을 수 있습니다. 가장 최근 세션(최근 몇 분)은 내보내기에 나타나지 않을 수 있습니다.
- 단일 도구 제한: Clarity 통합은 현재 데이터 내보내기 도구만 제공합니다. 히트맵 시각화 및 세션 녹화는 Clarity 웹 대시보드를 직접 사용하세요.
- 응답 크기:
URL과 같은 고유 카디널리티 차원을 다른 차원과 결합하면 응답 페이로드가 커질 수 있습니다. 시간 범위를 좁히거나 더 적은 차원을 사용하는 것을 고려하세요.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
MICROSOFT_CLARITY_DATA_EXPORT | 최대 3개 차원으로 분석 데이터 내보내기 |
사용 가능한 차원:
| 차원 | 설명 |
|---|---|
Browser | 웹 브라우저 (Chrome, Firefox, Safari 등) |
Device | 기기 유형 (데스크톱, 모바일, 태블릿) |
Country/Region | 지리적 위치 |
OS | 운영 체제 |
Source | 트래픽 소스 |
Medium | 트래픽 매체 |
Campaign | 마케팅 캠페인 |
Channel | 트래픽 채널 그룹 |
URL | 특정 페이지 URL |
Composio 제공