MCP Fathom Analytics

一个非官方的 Model Context Protocol (MCP) 服务器，用于通过 AI 助手访问 Fathom Analytics 数据。此实现使用 @mackenly/fathom-api 非官方 SDK 与 Fathom Analytics API 交互。与 Fathom Analytics 无关联，未经其认可或支持。已作为 npx 脚本发布到 npm。

<a href="https://glama.ai/mcp/servers/56cxbakbc4"> <img width="380" height="200" src="https://glama.ai/mcp/servers/56cxbakbc4/badge" alt="Fathom Analytics MCP server" /> </a>

功能

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 Example Clients

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 文件。