mcpField
M
MCP Fathom Analytics

MCP Fathom Analytics

本地服务
npmjs.com数据与分析471 周前更新
代码仓库访问官网

关于 MCP Fathom Analytics

MCP Fathom Analytics 是非官方服务，可让 AI 助手访问 Fathom Analytics 的账户和网站数据。它提供事件、聚合分析及当前访客数据工具。

主要功能

  1. 01获取账户详情
  2. 02列出分析网站
  3. 03列出网站事件
  4. 04生成可筛选的聚合分析
  5. 05查看当前访客

适用场景

  1. 01实时查看网站访客数量
  2. 02按日期分析页面浏览量和访问量
  3. 03比较页面表现或国家流量

MCP 相关

该服务向 MCP 客户端提供 Fathom Analytics 的账户、网站、事件、聚合分析和当前访客数据工具。

#mcp#fathom-analytics#mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "fathom-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-fathom-analytics"
      ],
      "env": {
        "FATHOM_API_KEY": "<FATHOM_API_KEY>"
      }
    }
  }
}
启动命令npx -y mcp-fathom-analytics
需要配置的环境变量
FATHOM_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmcp-fathom-analytics

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP Fathom Analytics

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

smithery badge

Fathom Analytics MCP 服务 MseeP.ai 安全评估徽章

功能

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 示例客户端

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

贡献

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

许可证

本项目采用 MIT License 许可——详情请参阅 LICENSE 文件。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。