ComposioHQ/Microsoft-Clarity-Automation

Automação do Microsoft Clarity

Exporte análises de comportamento do usuário do Microsoft Clarity diretamente do Claude Code. Obtenha dados de mapa de calor, métricas de sessão e insights de engajamento segmentados por múltiplas dimensões sem sair do seu terminal.

Documentação do toolkit: composio.dev/toolkits/microsoft_clarity

---

Configuração

1. Adicione o servidor MCP da Composio à sua configuração:

   https://rube.app/mcp
   

2. Conecte sua conta do Microsoft Clarity quando solicitado. O agente fornecerá um link de autenticação.
3. Certifique-se de que seu projeto Clarity tenha coleta de dados suficiente habilitada para as dimensões que você deseja analisar.

---

Fluxos de Trabalho Principais

1. Exportar Dados Analíticos Recentes

Exporte dados analíticos do Clarity dos últimos 1 a 3 dias, segmentados por até três dimensões simultaneamente.

Ferramenta: MICROSOFT_CLARITY_DATA_EXPORT

Parâmetros principais:

• numOfDays (obrigatório) — número de dias a exportar: 1 (últimas 24h), 2 (últimas 48h) ou 3 (últimas 72h)
• dimension1 — primeira dimensão de detalhamento
• dimension2 — segunda dimensão de detalhamento (opcional)
• dimension3 — terceira dimensão de detalhamento (opcional)

Dimensões disponíveis:

• Browser — Chrome, Firefox, Safari, Edge, etc.
• Device — Desktop, Mobile, Tablet
• Country/Region — localização geográfica dos usuários
• OS — Windows, macOS, iOS, Android, etc.
• Source — origem do tráfego (ex.: google, direct, referral)
• Medium — meio de tráfego (organic, cpc, referral, etc.)
• Campaign — nome da campanha de marketing
• Channel — agrupamento de canal de tráfego
• URL — URLs específicas de página

Exemplo de prompt: "Exporte dados do Clarity das últimas 24 horas detalhados por Dispositivo e País/Região"

---

2. Análise de Desempenho por Dispositivo

Analise como o comportamento do usuário difere entre tipos de dispositivo para otimizar o design responsivo.

Ferramenta: MICROSOFT_CLARITY_DATA_EXPORT

Configuração: numOfDays: 3, dimension1: "Device", dimension2: "Browser"

Exemplo de prompt: "Mostre-me métricas do Clarity dos últimos 3 dias por Dispositivo e Navegador"

---

3. Detalhamento por Origem de Tráfego

Entenda quais origens de tráfego geram os usuários mais engajados.

Ferramenta: MICROSOFT_CLARITY_DATA_EXPORT

Configuração: numOfDays: 2, dimension1: "Source", dimension2: "Medium"

Exemplo de prompt: "Exporte dados do Clarity das últimas 48 horas detalhados por Origem e Meio"

---

4. Comportamento Geográfico do Usuário

Analise padrões de engajamento dos usuários em diferentes países e regiões.

Ferramenta: MICROSOFT_CLARITY_DATA_EXPORT

Configuração: numOfDays: 3, dimension1: "Country/Region", dimension2: "Device"

Exemplo de prompt: "Obtenha dados do Clarity das últimas 72 horas segmentados por País/Região e tipo de Dispositivo"

---

5. Desempenho no Nível da Página

Examine quais URLs específicas têm as métricas de engajamento mais altas ou mais baixas.

Ferramenta: MICROSOFT_CLARITY_DATA_EXPORT

Configuração: numOfDays: 1, dimension1: "URL", dimension2: "Device"

Exemplo de prompt: "Exporte os dados do Clarity de ontem detalhados por URL e Dispositivo"

---

6. Análise de Atribuição de Campanha

Avalie a eficácia das campanhas de marketing por meio de métricas de comportamento do usuário.

Ferramenta: MICROSOFT_CLARITY_DATA_EXPORT

Configuração: numOfDays: 3, dimension1: "Campaign", dimension2: "Channel", dimension3: "Device"

Exemplo de prompt: "Mostre dados de engajamento do Clarity dos últimos 3 dias por Campanha, Canal e Dispositivo"

---

Armadilhas Conhecidas

• Janela de tempo limitada: A exportação de dados está limitada apenas aos últimos 1, 2 ou 3 dias. O parâmetro numOfDays aceita apenas os valores 1, 2 ou 3. Para análises históricas mais longas, você precisa executar exportações periodicamente e agregá-las externamente.
• Correspondência exata do nome da dimensão: Os valores das dimensões devem corresponder exatamente conforme listados (ex.: Country/Region e não country ou region). Maiúsculas/minúsculas e barras são importantes.
• Máximo de três dimensões: Você pode segmentar por até três dimensões por exportação. Para análises mais complexas, execute múltiplas exportações com diferentes combinações de dimensões.
• Atraso na disponibilidade dos dados: Os dados do Clarity podem ter um pequeno atraso de processamento. Sessões muito recentes (últimos minutos) podem não aparecer nas exportações.
• Limitação de ferramenta única: A integração do Clarity atualmente oferece apenas a ferramenta de exportação de dados. Para visualizações de mapa de calor e gravações de sessão, use o painel web do Clarity diretamente.
• Tamanho da resposta: Exportações com dimensões de alta cardinalidade, como URL, combinadas com outras dimensões, podem gerar grandes tamanhos de resposta. Considere reduzir sua janela de tempo ou usar menos dimensões.

---

Referência Rápida

Slug da Ferramenta	Descrição
MICROSOFT_CLARITY_DATA_EXPORT	Exporta dados analíticos com até 3 detalhamentos dimensionais

Dimensões Disponíveis:

Dimensão	Descrição
Browser	Navegador web (Chrome, Firefox, Safari, etc.)
Device	Tipo de dispositivo (Desktop, Mobile, Tablet)
Country/Region	Localização geográfica
OS	Sistema operacional
Source	Origem do tráfego
Medium	Meio de tráfego
Campaign	Campanha de marketing
Channel	Agrupamento de canal de tráfego
URL	URL específica da página

---

Desenvolvido pela Composio