Fathom Analytics

MCP Fathom Analytics

Un servidor no oficial de Model Context Protocol (MCP) para acceder a los datos de Fathom Analytics a través de un asistente de IA. Esta implementación utiliza el SDK no oficial @mackenly/fathom-api para interactuar con la API de Fathom Analytics. No está afiliado, respaldado ni soportado por Fathom Analytics. Publicado en npm como un script npx.

Características

El servidor MCP proporciona las siguientes herramientas de Fathom Analytics:

Información de la cuenta

• get-account: Recupera detalles sobre tu cuenta de Fathom Analytics

Gestión de sitios

• list-sites: Lista todos tus sitios de Fathom Analytics

Eventos

• list-events: Lista eventos para un sitio específico

Analítica

• get-aggregation: Genera informes analíticos agregados con opciones flexibles de filtrado y agrupación

Seguimiento de visitantes

• get-current-visitors: Obtén datos en tiempo real sobre los visitantes actuales del sitio

Uso

Si estás usando Claude Desktop, puedes agregar el servidor MCP usando la configuración json (más información). Aquí tienes un ejemplo:

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

Puedes encontrar más información sobre otros clientes MCP aquí: Model Context Protocol Example Clients

Estructura de la API

El servidor MCP utiliza el SDK @mackenly/fathom-api para interactuar con los endpoints de la API de Fathom Analytics:

1. API de cuentas: https://api.usefathom.com/v1/account
2. API de sitios: https://api.usefathom.com/v1/sites
3. API de eventos: https://api.usefathom.com/v1/sites/SITE_ID/events
4. API de agregación: https://api.usefathom.com/v1/aggregations
5. API de visitantes actuales: https://api.usefathom.com/v1/current_visitors

Ejemplos de agregación

La herramienta de agregación es altamente flexible. Aquí tienes algunos ejemplos de casos de uso:

1. Estadísticas diarias de páginas vistas para los últimos 30 días:

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

2. Rendimiento de páginas individuales:

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

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

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

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.