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` меняет примечания и загружает расходы, каждое изменение подтверждается вами.
Настройка клиентов
{
"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.
{
"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-селекторы.
World Monitor
Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.
mcp
Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.
Netdata
Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.