MCP Fathom Analytics

MCP Fathom分析

](https://smithery.ai/server/@mackenly/mcp-fathom-analytics)

特性

MCP服务器提供以下Fathom分析工具：

账户信息

• 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客户端的更多信息： 模型上下文协议示例客户端

API结构

MCP服务器使用 @麦肯利/理解api 与Fathom Analytics 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"
}

1. 单个页面的性能:

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

1. 来自特定国家的流量:

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

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。