探查监控
一个非官方服务器，允许AI助手访问Fathom Analytics数据，使用户能够获取账户信息、网站统计数据、事件、聚合报告和实时访客跟踪。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"fathom-analytics": {
"args": [
"-y",
"mcp-fathom-analytics"
],
"command": "npx",
"env": {
"FATHOM_API_KEY": "your_api_key_here"
}
}
}
}该服务需要配置环境变量：FATHOM_API_KEY
可用工具 （5 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
get-account
Get Fathom Analytics account information
该工具无需必填参数，直接调用即可
list-sites 1 个参数
List all Fathom Analytics sites on the account
该工具无需必填参数，直接调用即可
list-events 2 个参数 需填 1 项
List all events for a Fathom Analytics site (automatically handles pagination)
必填参数：site_id
get-aggregation 11 个参数 需填 5 项
Get aggregated analytics data from Fathom
必填参数：entity、entity_id、aggregates、date_from、date_to
get-current-visitors 2 个参数 需填 1 项
Get current visitors for a Fathom Analytics site
必填参数：site_id
服务介绍
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端点进行接口通信：
- 账户API:
https://api.usefathom.com/v1/account - 站点API:
https://api.usefathom.com/v1/sites - 事件API:
https://api.usefathom.com/v1/sites/SITE_ID/events - 聚合API:
https://api.usefathom.com/v1/aggregations - 当前访客API:
https://api.usefathom.com/v1/current_visitors
聚合示例
聚合工具非常灵活。这里有一些示例用法：
- 过去30天的每日页面浏览统计:
{
"entity": "pageview",
"entity_id": "SITE_ID",
"aggregates": "pageviews,uniques,visits",
"date_grouping": "day",
"date_from": "2023-08-01 00:00:00"
}
- 单个页面的表现:
{
"entity": "pageview",
"entity_id": "SITE_ID",
"aggregates": "pageviews,uniques,avg_duration",
"field_grouping": "pathname",
"sort_by": "pageviews:desc",
"limit": 10
}
- 来自特定国家/地区的流量:
{
"entity": "pageview",
"entity_id": "SITE_ID",
"aggregates": "visits",
"field_grouping": "country_code",
"sort_by": "visits:desc"
}
贡献
欢迎贡献！请随时提交Pull Request。
许可证
该项目根据MIT许可证授权 - 详情见LICENSE文件。
