Yandex Metrica MCP

Yandex Metrica MCP

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

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

_{Настоящая MCP-сессия: реальный сервер, хендшейк и tools/call по stdio через официальный SDK; ответы Яндекс Метрики — записанные фикстуры (docs/demo), поэтому демо воспроизводится без токена и сети — vhs docs/demo.tape.}

Что умеет

• Счётчики и цели — 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 с бэкоффом и таймаут запроса.

Установка

Токен не нужен: сервер подключается к Метрике в диалоге после установки. Требуется Node.js 20+ — он запускается через npx, отдельно ставить ничего не надо.

claude mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latest

/plugin marketplace add askads/claude-plugins
/plugin install yandex-metrica@askads

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

codex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latest

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

code --add-mcp '{"name":"yandex-metrica","command":"npx","args":["-y","mcp-yandex-metrica@latest"]}'

{
  "servers": {
    "yandex-metrica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

Совсем без установки: Метрика входит в удалённый сервер Яндекс Директа — добавьте https://mcp.askads.ru/mcp по URL (инструкция), инструменты Метрики видны с префиксом metrika_.

Подключение

Скажите ассистенту:

Подключи Яндекс Метрику

Он даст ссылку — откройте её под аккаунтом с доступом к нужным счётчикам, подтвердите доступ и пришлите в чат показанный код. Всё, можно спрашивать про аналитику: перезапускать клиент не нужно, конфигурацию править тоже.

Сервер просит единственное право — чтение статистики и параметров счётчиков. Ничего изменить в Метрике он не может.

Дальше подключение живёт само: доступ продлевается автоматически и не отваливается через год. Проверить состояние — попросите «покажи статус подключения», отключить — «отключи Метрику». Выданный доступ отзывается в Яндекс ID.

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

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

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

Настройка

Настраивать нечего: всё нужное сервер спрашивает в диалоге. Переменные окружения пригодятся только для CI и нестандартных случаев.

Полный список инструментов — в docs/TOOLS.md.

Требования

• Node.js 20+ (запускается через npx, отдельная установка не нужна).
• Аккаунт Яндекса с доступом к нужным счётчикам.

Ограничения

• Только чтение (MVP) — изменяющих операций нет; запись доступна только через raw_request с явным confirmWrite=true.
• Reporting API может семплировать данные на больших периодах — смотрите sampled/sample_share в ответе и при необходимости передавайте accuracy: "full".
• У Метрики нет песочницы — все вызовы идут к боевому API (но MVP только читает).

Документация

• Все инструменты
• Разработка

Поддержка

Вопросы, идеи и доработки — пишите в Telegram: @gistrec.

Лицензия

MIT — см. LICENSE.