Automação do Microsoft Clarity

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

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

Configuração

1. Adicione o servidor MCP do 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 de Análise Recentes

Exporte dados de análise 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 para 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 -- fonte de tráfego (por exemplo, google, direct, referral)
• Medium -- meio de tráfego (organic, cpc, referral, etc.)
• Campaign -- nome da campanha de marketing
• Channel -- agrupamento de canais de tráfego
• URL -- URLs de páginas específicas

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 os 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 métricas do Clarity dos últimos 3 dias por Dispositivo e Navegador"

3. Detalhamento da Fonte de Tráfego

Entenda quais fontes 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 Fonte e Meio"

4. Comportamento do Usuário Geográfico

Analise os padrões de engajamento do usuário 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 por 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 é 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 aos listados (por exemplo, Country/Region e não country ou region). A capitalização e as barras importam.
• 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 várias exportações com diferentes combinações de dimensões.
• Atraso na disponibilidade de dados: Os dados do Clarity podem ter um pequeno atraso no 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 mapas de calor e gravações de sessão, use o painel web do Clarity diretamente.

…