MCP Fathom Analytics

🚀 MCP Fathom Analytics サーバー

このサーバーは、非公式の Model Context Protocol（MCP）サーバー実装です。AI アシスタントを通じて Fathom Analytics のデータにアクセスするために使用されます。この実装では、@mackenly/fathom-api という非公式 SDK を使用して、Fathom Analytics 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 サンプルクライアント で確認できます。

💻 使用例

基本的な使用法

Claude Desktop での 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 サーバーは、@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

集計の例

集計ツールは非常に柔軟です。以下にいくつかの使用例を示します。

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

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

特定ページのパフォーマンス

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

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

{
  "entity": "event",
  "entity_id": "SITE_ID",
  "aggregates": "count",
  "field_grouping": "geo.country_code",
  "filter": {
    "properties": {
      "event_type": "page_view"
    }
  }
}

🤝 貢献

このプロジェクトへの貢献を歓迎します！貢献の方法については、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。詳細については、LICENSE を参照してください。

📞 連絡先

質問やフィードバックがある場合は、連絡先 までお問い合わせください。