yandex-metrica-mcp

yandex-metrica-mcp — MCP-сервер сообщества (автор — BoxLab-Ltd). Запросы к Яндекс Метрике: отчёты, тренды, метаданные и выгрузка сырых логов. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
BoxLab-Ltd
Лицензия
MIT
Транспорт
stdio, streamable_http
Авторизация
oauth
ОС
Не указана
Языки
typescript

Уровень риска: high

Читает все доступные аккаунту счётчики; при `YANDEX_METRIKA_ENABLE_WRITE=1` меняет примечания и загружает расходы, каждое изменение подтверждается вами.

Настройка клиентов

claude-code
{
    "code": "/plugin marketplace add BoxLab-Ltd/yandex-metrica-mcp\n/plugin install yandex-metrica-mcp@boxlab",
    "lang": "bash",
    "notes": "Команды плагина внутри Claude Code, дословно из README",
    "verified": "docs"
}

Что умеет

yandex-metrica-mcp — MCP-сервер для Яндекс Метрики. Он позволяет ИИ-агенту на обычном языке запрашивать данные веб-аналитики: трафик, источники, страницы входа, конверсии, географию, устройства и динамику. По умолчанию сервер работает только на чтение, а инструменты записи включаются отдельно и подтверждаются по одному изменению. Это не официальный сервер Яндекса.

  • Отчёты: run_report — гибкая обёртка над Reporting API, run_comparison — сравнение двух периодов с абсолютной и процентной разницей, run_drilldown — разбивка по дереву группировок, run_timeseries — метрики во временном ряду для трендов.
  • Справочник: get_metadata показывает счётчики аккаунта и каталог группировок и метрик, describe_counter — настройки счётчика: цели, сегменты, фильтры, доступы и примечания на графиках.
  • Logs API: выгрузка сырых несемплированных визитов и хитов (logs_request, logs_status, logs_download, logs_clean). Полная выгрузка пишется в файл, а не в контекст модели.
  • Вход из клиента: инструменты login и submit_code позволяют авторизоваться без терминала.
  • Контроль контекста: выбор полей включён по умолчанию, низкие лимиты строк, сведения о семплировании и квотах возвращаются модели. Сервер также передаёт клиенту правила анализа: исключать роботов, сравнивать полные периоды, не суммировать пользователей.

С флагом YANDEX_METRIKA_ENABLE_WRITE=1 добавляются manage_annotation (примечания на графиках) и upload_expenses (загрузка расходов на рекламу из CSV, с режимом проверки dryRun).

Кому подойдёт

  • Маркетологам и SEO-специалистам: источники трафика, конверсии по целям, сравнение периодов без ручной работы с отчётами.
  • Продуктовым аналитикам: тренды, устройства, география и сырые данные через Logs API.
  • Интернет-магазинам: анализ воронки и загрузка расходов для расчёта ROI.

Похожие серверы — в категории маркетинг и соцсети.

Установка

Нужен Node.js 18 или новее и доступ вашего аккаунта Яндекса к нужным счётчикам. Вход выполняется один раз:

npx yandex-metrica-mcp auth

Откроется страница согласия Яндекса в браузере, код вернётся автоматически через локальный адрес. Используется авторизация с PKCE через встроенный публичный OAuth-клиент, поэтому секрет приложения не хранится. Токен кешируется в ~/.config/yandex-metrica-mcp/token.json с правами 0600 и действует около года. Для CI можно передать статический токен в YANDEX_METRIKA_TOKEN.

Есть режим Streamable HTTP (npx yandex-metrica-mcp --http), сервер слушает только 127.0.0.1. Для Claude Desktop также доступно расширение .mcpb из релизов.

Подключение к клиентам

Конфиг и команды приведены дословно из README. Вместо 12345678 укажите номер своего счётчика. Общий порядок — в инструкции как подключить MCP.

claude_desktop_config.json
{
    "mcpServers": {
        "yandex-metrica": {
            "command": "npx",
            "args": ["-y", "yandex-metrica-mcp"],
            "env": { "YANDEX_METRIKA_COUNTER_ID": "12345678" }
        }
    }
}

В Claude Code это команды плагина внутри сессии. После установки войдите через инструмент login или командой npx yandex-metrica-mcp auth.

Проверка

Спросите агента: «Какие источники трафика были за последние 7 дней?» Он вызовет run_report. Если сервер сообщает, что вход не выполнен, попросите агента запустить инструмент login.

Примеры задач

Сравни трафик из поиска за этот и прошлый месяц и покажи, какие страницы входа выросли сильнее всего.
Какая конверсия в цель «Заказ» по устройствам за последние 30 дней?

Риски

В режиме по умолчанию сервер только читает статистику, но видит все счётчики, к которым есть доступ у аккаунта, включая настройки целей и выданные доступы. При включённой записи агент может создавать и удалять примечания и загружать расходы, что влияет на отчёты по ROI.

Что встроено: каждое изменение подтверждается вами перед отправкой — через запрос подтверждения в клиенте или одноразовый токен. Сервер проверяет, что у аккаунта есть права на редактирование счётчика, и обращается только к Яндексу. Не включайте YANDEX_METRIKA_ENABLE_WRITE, если запись не нужна. Лицензия — MIT.

Частые вопросы

Нужно ли регистрировать своё приложение в Яндексе?

Нет. Сервер использует встроенный публичный OAuth-клиент с PKCE. Своё приложение можно подключить через YANDEX_OAUTH_CLIENT_ID.

Может ли агент что-то изменить в Метрике?

По умолчанию нет. Запись включается флагом YANDEX_METRIKA_ENABLE_WRITE=1, и каждое изменение требует вашего подтверждения.

Это официальный сервер Яндекса?

Нет, это открытый проект сообщества.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • run_report
  • run_comparison
  • run_drilldown
  • run_timeseries
  • get_metadata
  • describe_counter
  • logs_download
  • manage_annotation
  • upload_expenses

Похожие MCP-серверы

Scrapling MCP Server

Веб-скрапинг Scrapling: скрытные HTTP-запросы, настоящие браузеры и CSS-селекторы.

Риск: medium Лицензия: BSD-3-Clause ★ 104 215

World Monitor

Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.

Риск: medium Лицензия: AGPL-3.0 ★ 90 905

mcp

Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Netdata

Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Источники