Аналитика MCP Fathom

Неофициальный сервер Model Context Protocol ( MCP ) для доступа к данным Fathom Analytics через помощника на основе искусственного интеллекта. Эта реализация использует неофициальный SDK @mackenly/fathom-api для взаимодействия с API Fathom Analytics. Не аффилирован, не одобрен и не поддерживается Fathom Analytics. Опубликовано в npm как скрипт npx .

Функции

Сервер MCP предоставляет следующие инструменты Fathom Analytics:

Информация об учетной записи

• get-account : получение сведений о вашей учетной записи Fathom Analytics

Управление сайтами

• list-sites : Перечислите все свои сайты Fathom Analytics

События

• list-events : Список событий для определенного сайта

Аналитика

• get-aggregation : создание агрегированных аналитических отчетов с гибкими возможностями фильтрации и группировки

Отслеживание посетителей

• get-current-visitors : Получайте данные в реальном времени о текущих посетителях сайта

Related MCP server: MCP Server

Использование

Если вы используете Claude Desktop, вы можете добавить сервер MCP с помощью конфигурации json ( подробнее ). Вот пример:

{
    "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 для взаимодействия с конечными точками API Fathom Analytics:

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

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.