简介

一个非官方服务器，允许AI助手访问Fathom Analytics数据，使用户能够获取账户信息、网站统计数据、事件、聚合报告和实时访客跟踪。

简介

一个非官方服务器，允许AI助手访问Fathom Analytics数据，使用户能够获取账户信息、网站统计数据、事件、聚合报告和实时访客跟踪。

MCP Fathom Analytics

一个非官方的模型上下文协议（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客户端的更多信息：模型上下文协议示例客户端

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天的每日页面浏览统计:

{
  "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"
}

贡献

欢迎贡献！请随时提交Pull Request。

许可证

该项目根据MIT许可证授权 - 详情见LICENSE文件。

工具列表

• get-account: Get Fathom Analytics account information

• list-sites: List all Fathom Analytics sites on the account

• list-events: List all events for a Fathom Analytics site (automatically handles pagination)

• get-aggregation: Get aggregated analytics data from Fathom

• get-current-visitors: Get current visitors for a Fathom Analytics site

服务配置

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

来源

• 来源：github
• 链接：https://github.com/mackenly/mcp-fathom-analytics