Análisis de Fathom de MCP

Un servidor no oficial del Protocolo de Contexto de Modelo ( MCP ) para acceder a los datos de Fathom Analytics mediante 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 : enumera todos tus sitios de Fathom Analytics

Eventos

• list-events : enumera los eventos de un sitio específico

Analítica

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

Seguimiento de visitantes

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

Related MCP server: MCP Server

Uso

Si usa Claude Desktop, puede agregar el servidor MCP mediante la configuración JSON ( más información ). Aquí tiene un ejemplo:

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

Puede encontrar más información sobre otros clientes MCP aquí: Modelo Contexto Protocolo Clientes de ejemplo

Estructura de la API

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

1. API de cuenta : 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 muy flexible. A continuación, se muestran algunos ejemplos de uso:

1. Estadísticas diarias de visitas a la página de 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"
}

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.