convez.ai
MCP ServerDados & AnalyticsIntermediário
mackenly

MCP Fathom Analytics

mackenly/mcp-fathom-analytics

Integre dados do Fathom Analytics em assistentes IA via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP não-oficial que integra Fathom Analytics com assistentes IA, permitindo acessar dados de analytics, sites, eventos e visitantes em tempo real. Utiliza a SDK @mackenly/fathom-api para conectar com a plataforma Fathom.

Instalação

$npx convez-ai mackenly/mcp-fathom-analytics

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
6
Acompanhando
1
Saúde
57%
Último commit
há 1 ano
Versão
—
Issues abertas
0
Contribuidores
4

Casos de uso

  • Analisar dados de pageviews e visitantes únicos em IA
  • Gerar relatórios agregados de tráfego por país/página
  • Monitorar visitantes ativos em tempo real via IA
  • Consultar eventos e comportamento de usuários

Veredito

Integração funcional e bem documentada para extrair dados do Fathom Analytics em contextos de IA. Ideal para quem precisa consultar analytics programaticamente, com ressalva de ser um projeto não-oficial não suportado pelo Fathom.

README

A tradução para o português deste README ainda está na fila.

MCP Fathom Analytics

An unofficial Model Context Protocol (MCP) server for accessing Fathom Analytics data through an AI assistant. This implementation uses the @mackenly/fathom-api unofficial SDK to interact with the Fathom Analytics API. Not affiliated, endorsed, or supported by Fathom Analytics. Published to npm as an npx script.

smithery badge

Features

The MCP server provides the following Fathom Analytics tools:

Account Information

  • get-account: Retrieve details about your Fathom Analytics account

Sites Management

  • list-sites: List all your Fathom Analytics sites

Events

  • list-events: List events for a specific site

Analytics

  • get-aggregation: Generate aggregated analytics reports with flexible filtering and grouping options

Visitor Tracking

  • get-current-visitors: Get real-time data about current site visitors

Usage

If you're using Claude Desktop, you can add the MCP server using the json config (more info). Here's an example:

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

You can find more information about other MCP Clients here: Model Context Protocol Example Clients

API Structure

The MCP server uses the @mackenly/fathom-api SDK to interface with the Fathom Analytics API endpoints:

  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

Aggregation Examples

The aggregation tool is highly flexible. Here are some example use cases:

  1. Daily pageview statistics for the last 30 days:
{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,visits",
  "date_grouping": "day",
  "date_from": "2023-08-01 00:00:00"
}
  1. Performance of individual pages:
{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,avg_duration",
  "field_grouping": "pathname",
  "sort_by": "pageviews:desc",
  "limit": 10
}
  1. Traffic from specific countries:
{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "visits",
  "field_grouping": "country_code",
  "sort_by": "visits:desc"
}

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Ver o original no GitHub

Bom para

Relacionados