Fathom Analytics

MCP Fathom Analytics

Um servidor não oficial de Model Context Protocol (MCP) para acessar dados do Fathom Analytics por meio de um assistente de IA. Esta implementação usa o SDK não oficial @mackenly/fathom-api para interagir com a API do Fathom Analytics. Não é afiliado, endossado ou suportado pelo Fathom Analytics. Publicado no npm como um script npx.

Recursos

O servidor MCP fornece as seguintes ferramentas do Fathom Analytics:

Informações da Conta

• get-account: Recupera detalhes sobre sua conta do Fathom Analytics

Gerenciamento de Sites

• list-sites: Lista todos os seus sites do Fathom Analytics

Eventos

• list-events: Lista eventos para um site específico

Analytics

• get-aggregation: Gera relatórios analíticos agregados com opções flexíveis de filtragem e agrupamento

Rastreamento de Visitantes

• get-current-visitors: Obtém dados em tempo real sobre os visitantes atuais do site

Uso

Se você estiver usando o Claude Desktop, pode adicionar o servidor MCP usando a configuração json (mais informações). Aqui está um exemplo:

{
    "mcpServers": {
        "fathom-analytics": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-fathom-analytics"
            ],
            "env": {
                "FATHOM_API_KEY": "your_api_key_here"
            }
        }
    }
}

Você pode encontrar mais informações sobre outros clientes MCP aqui: Model Context Protocol Example Clients

Estrutura da API

O servidor MCP usa o SDK @mackenly/fathom-api para interagir com os endpoints da API do Fathom Analytics:

1. Account API: https://api.usefathom.com/v1/account
2. Sites API: https://api.usefathom.com/v1/sites
3. Events API: https://api.usefathom.com/v1/sites/SITE_ID/events
4. Aggregation API: https://api.usefathom.com/v1/aggregations
5. Current Visitors API: https://api.usefathom.com/v1/current_visitors

Exemplos de Agregação

A ferramenta de agregação é altamente flexível. Aqui estão alguns exemplos de casos de uso:

1. Estatísticas diárias de visualizações de página nos últimos 30 dias:

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,visits",
  "date_grouping": "day",
  "date_from": "2023-08-01 00:00:00"
}

2. Desempenho de páginas individuais:

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,avg_duration",
  "field_grouping": "pathname",
  "sort_by": "pageviews:desc",
  "limit": 10
}

3. Tráfego de países específicos:

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "visits",
  "field_grouping": "country_code",
  "sort_by": "visits:desc"
}

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.