AI导哈

分析数据访问服务

一个通过AI助手访问Fathom Analytics数据的非官方MCP服务器实现，提供账户信息、站点管理、事件列表、聚合分析和实时访客追踪功能。

  • by mackenly
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 mackenly/mcp-fathom-analytics

使用说明

MCP Fathom分析

一种非官方的模型上下文协议(主控程序)用于访问的服务器 父亲分析 通过AI助手获取数据。此实现使用 @麦肯利/理解api 与Fathom Analytics API交互的非官方SDK。不隶属于、不认可或不支持Fathom Analytics。发布到 npm作为npx脚本.

特性

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许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP