MCP Fathom Analytics

MCP Fathom Analytics

AI アシスタントを通じて Fathom Analytics のデータにアクセスするための、非公式な Model Context Protocol（MCP）サーバーです。この実装では、Fathom Analytics API と連携するために、非公式 SDK の @mackenly/fathom-api を使用します。Fathom Analytics との提携、承認、サポートは受けていません。npm で npx スクリプトとして公開されています。

機能

MCP サーバーでは、次の Fathom Analytics ツールを利用できます。

アカウント情報

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

サイト管理

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

イベント

• list-events：指定したサイトのイベントを一覧表示します

アナリティクス

• get-aggregation：柔軟なフィルタリングとグループ化オプションを使って、集計アナリティクスレポートを生成します

訪問者の追跡

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

使用方法

Claude Desktop を使用している場合は、json 設定を使って MCP サーバーを追加できます（詳細情報）。例を示します。

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

その他の MCP クライアントについては、こちらをご覧ください：Model Context Protocol のクライアント例

API 構成

MCP サーバーは、Fathom Analytics API エンドポイントとの連携に @mackenly/fathom-api SDK を使用します。

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 ファイルをご覧ください。