MCP ファゾムアナリティクス

AIアシスタントを介してFathom Analyticsデータにアクセスするための非公式モデルコンテキストプロトコル（ MCP ）サーバーです。この実装では、@mackenly/fathom-api非公式SDKを使用してFathom Analytics APIと連携します。Fathom Analyticsと提携、承認、またはサポート関係にはありません。npxスクリプトとしてnpmに公開されています。

特徴

MCP サーバーは、次の Fathom Analytics ツールを提供します。

アカウント情報

• get-account : Fathom Analytics アカウントの詳細を取得します

サイト管理

• list-sites : Fathom Analytics のすべてのサイトを一覧表示します

イベント

• list-events : 特定のサイトのイベントを一覧表示する

分析

• get-aggregation : 柔軟なフィルタリングとグループ化のオプションを使用して集計分析レポートを生成します

訪問者追跡

• get-current-visitors : 現在のサイト訪問者に関するリアルタイムデータを取得する

Related MCP server: MCP Server

使用法

Claude Desktop をお使いの場合は、json 設定を使って MCP サーバーを追加できます（詳細はこちら）。以下に例を示します。

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

他のMCPクライアントの詳細については、こちらをご覧ください:モデルコンテキストプロトコルのサンプルクライアント

API構造

MCP サーバーは、@mackenly/fathom-api SDK を使用して Fathom Analytics API エンドポイントとインターフェースします。

1. アカウント API : https://api.usefathom.com/v1/account

2. サイト API : https://api.usefathom.com/v1/sites

3. イベント API : https://api.usefathom.com/v1/sites/SITE_ID/events

4. 集計 API : https://api.usefathom.com/v1/aggregations

5. 現在の訪問者 API : https://api.usefathom.com/v1/current_visitors

集計の例

集計ツールは非常に柔軟性が高いです。以下に使用例をいくつかご紹介します。

1. 過去 30 日間の毎日のページビュー統計:

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

2. 個々のページのパフォーマンス:

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

3. 特定の国からのトラフィック:

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

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。