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 : 現在のサイト訪問者に関するリアルタイムデータを取得する

使用法

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

他の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 日間の毎日のページビュー統計:

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

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

貢献

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

ライセンス

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