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：獲取有關當前網站訪客的即時數據。

📦 安裝指南

此項目已作為 npm 上的 npx 腳本 發佈，可直接使用。

💻 使用示例

基礎用法

如果您使用的是 Claude Desktop，可以在其中添加該 MCP 服務器，方式為使用 json 配置（更多信息請參見 快速入門指南）。以下是一個示例：

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

您可以在 Model Context Protocol 示例客戶端 找到更多其他 MCP 客戶端的信息。

高級用法

聚合示例

聚合工具非常靈活，以下是幾個示例用法：

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": 5
}

3. 來自特定國家的流量：

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

📚 詳細文檔

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

🤝 貢獻

歡迎為該項目做出貢獻！請參考 CONTRIBUTING.md 瞭解如何參與。

📄 許可證

此項目遵循 MIT 許可證。更多信息請參見 LICENSE。

📞 聯繫方式

如有任何問題或反饋，請聯繫 聯繫方式。