Sobre o projeto

GA4 Dashboard & MCP é um painel auto-hospedado em tempo real do Google Analytics 4 e um servidor opcional Model Context Protocol (MCP) para assistentes de IA. ## Recursos do Painel - **Análise em tempo real**: Monitoramento ao vivo de usuários ativos, comparação de propriedades, receitas de tráfego e rastreamento de cota da API. - **Globo interativo 3D**: Visualiza atividade do site em tempo real por países usando Three.js, acessível em `/globe`. - **Detecção de picos de tráfego**: Detecta automaticamente surtos súbitos e classifica fontes como referral, direto ou campanha. - **Insights de visitantes**: Cartões de persona para novos vs. visitantes recorrentes, análise por dispositivo e geografia principal. - **Escudo de privacidade**: Redige parâmetros completos de URL e strings de consulta para evitar vazamento de dados nos painéis. - **Cache inteligente**: Camadas de cache em disco e memória com atualização automática em segundo plano dos metadados das propriedades, preservando a cota da API GA4. - **Página de configuração inicial**: Se nenhuma credencial for encontrada, o usuário é redirecionado para um fluxo de configuração no navegador. ## Servidor MCP Um pacote autônomo `mcp-server/` expõe ferramentas da API Admin e Data do GA4 para clientes compatíveis com MCP, como Claude Desktop, Antigravity e Cursor. Opera independentemente do painel e possui suas próprias dependências e credenciais. ## Pré-requisitos - Node.js v18.0.0+ - Gerenciador de pacotes pnpm - Conta Google Cloud Platform com uma Conta de Serviço autorizada ao Google Analytics Data API e Admin API ## Visão Geral da Configuração 1. Clone o repositório e execute `pnpm install`. 2. Crie uma conta de serviço do Google Cloud, habilite as APIs necessárias e gere um arquivo chave JSON. 3. Conceda à conta de serviço acesso Viewer à propriedade GA4 e coloque o arquivo chave JSON na raiz do projeto (ou defina `GA4_CREDENTIALS_PATH` no `.env`). 4. Inicie o aplicativo com `pnpm dev` (desenvolvimento) ou `pnpm start` (produção). 5. Opcional: configure o servidor MCP copiando `.env.example`, apontando `GOOGLE_APPLICATION_CREDENTIALS` para um arquivo chave e adicionando o servidor à configuração do cliente MCP. ## URLs - Painel principal: `http://localhost:3000` - Globo 3D: `http://localhost:3000/globe` - Visão analítica: `http://localhost:3000/analytics` ## Testes e Compilação Execute `pnpm test` para a suíte de testes unitários Mocha e `pnpm build` para verificações de compilação TypeScript. Licenciado sob a Licença MIT.