MCP Fathom Analytics

Ein inoffizieller Model Context Protocol ( MCP )-Server für den Zugriff auf Fathom Analytics- Daten über einen KI-Assistenten. Diese Implementierung nutzt das inoffizielle SDK @mackenly/fathom-api zur Interaktion mit der Fathom Analytics API. Es besteht keine Verbindung zu Fathom Analytics und wird von diesem weder empfohlen noch unterstützt. Veröffentlichung auf npm als npx-Skript .

Merkmale

Der MCP-Server bietet die folgenden Fathom Analytics-Tools:

Kontoinformationen

• get-account : Rufen Sie Details zu Ihrem Fathom Analytics-Konto ab

Standortverwaltung

• list-sites : Listen Sie alle Ihre Fathom Analytics-Sites auf

Veranstaltungen

• list-events : Listet Ereignisse für eine bestimmte Site auf

Analyse

• get-aggregation : Generieren Sie aggregierte Analyseberichte mit flexiblen Filter- und Gruppierungsoptionen

Besucherverfolgung

• get-current-visitors : Erhalten Sie Echtzeitdaten über aktuelle Site-Besucher

Related MCP server: MCP Server

Verwendung

Wenn Sie Claude Desktop verwenden, können Sie den MCP-Server mithilfe der JSON-Konfiguration hinzufügen ( weitere Informationen ). Hier ist ein Beispiel:

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

Weitere Informationen zu anderen MCP-Clients finden Sie hier: Model Context Protocol Beispiel-Clients

API-Struktur

Der MCP-Server verwendet das SDK @mackenly/fathom-api zur Schnittstelle mit den Fathom Analytics API-Endpunkten:

1. Konto-API : https://api.usefathom.com/v1/account

2. Sites-API : https://api.usefathom.com/v1/sites

3. Ereignis-API : https://api.usefathom.com/v1/sites/SITE_ID/events

4. Aggregations-API : https://api.usefathom.com/v1/aggregations

5. Aktuelle Besucher-API : https://api.usefathom.com/v1/current_visitors

Aggregationsbeispiele

Das Aggregationstool ist äußerst flexibel. Hier sind einige Anwendungsbeispiele:

1. Tägliche Seitenaufrufstatistiken der letzten 30 Tage :

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

2. Leistung einzelner Seiten :

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

3. Verkehr aus bestimmten Ländern :

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

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.