Yandex Metrica MCP

MCP-сервер для Yandex Metrica (Яндекс Метрика): спрашивайте веб-аналитику — посещаемость, источники, поведение и конверсии по целям — из Claude, Cursor, Codex и других AI-клиентов на естественном языке.

Ассистент сам находит счётчики, тянет статистику из Reporting API и сопоставляет цели с конверсиями — то, что в интерфейсе Метрики приходится собирать вручную по отчётам.

Что умеет

• Счётчики и цели — list_counters (счётчики, к которым есть доступ) и list_goals (цели/конверсии счётчика) через Management API.
• Статистика — get_statistics по Reporting API (stat/v1/data): метрики и измерения, период (в т.ч. относительный — 7daysAgo), фильтры, сортировка, авто-пагинация.
• Конверсии — метрики целей ym:s:goal<id>reaches / ym:s:goal<id>conversionRate.
• Честная выборка — ответ несёт totals (итог по всем строкам) и sampled/sample_share, чтобы было видно, когда данные семплированы.
• Универсальный raw_request — прямой вызов любого пути API; GET свободно, запись (POST/DELETE) только по confirmWrite=true.
• Устойчивость — ретраи на 429/5xx с бэкоффом и таймаут запроса.

Примеры запросов

Попросите ассистента на русском — например:

• «Сколько визитов и какой процент отказов за последнюю неделю?»
• «Покажи трафик по источникам за июнь — сгруппируй по ym:s:lastTrafficSource»
• «Какая конверсия по цели "Оформление заказа" за 30 дней?»
• «Найди счётчик по домену shop.example и покажи его цели»

Быстрая установка

claude mcp add yandex-metrica -e YANDEX_METRIKA_TOKEN=ваш_токен -- npx -y mcp-yandex-metrica

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica"],
      "env": { "YANDEX_METRIKA_TOKEN": "ваш_токен" }
    }
  }
}

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica"],
      "env": { "YANDEX_METRIKA_TOKEN": "ваш_токен" }
    }
  }
}

[mcp_servers.yandex-metrica]
command = "npx"
args = ["-y", "mcp-yandex-metrica"]

[mcp_servers.yandex-metrica.env]
YANDEX_METRIKA_TOKEN = "ваш_токен"

{
  "servers": {
    "yandex-metrica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica"],
      "env": { "YANDEX_METRIKA_TOKEN": "ваш_токен" }
    }
  }
}

Получение токена

API Метрики работает по OAuth-токену с правом «Получение статистики, чтение параметров своих и доверенных счётчиков» (scope metrika:read).

1. Зарегистрируйте OAuth-приложение на oauth.yandex.com и включите ему доступ к Яндекс Метрике (чтение).
2. Пройдите OAuth-флоу под аккаунтом с доступом к нужным счётчикам и получите access_token. Подробности — в документации API Метрики.
3. Скопируйте токен в переменную YANDEX_METRIKA_TOKEN.

⚠️ Токен даёт доступ к данным аналитики и хранится открытым текстом в конф

... View full README on GitHub