MCP Яндекс Метрики с исправлениями отчетов

Yandex Metrika MCP Server (Node.js)

Read-only MCP Яндекс Метрики на 25 инструментов, форк неподдерживаемого проекта с исправлением неверных параметров отчетов

  • 1 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Читает данные о трафике, конверсиях и продажах, включая коммерчески чувствительную статистику
Все причины и проверки
Российский стек

ilyavorozhbit/yandex-metrika-mcp

Похожий инструмент с большим сообществом: Yandex Metrika MCP, 24 ★ репозитория

Установка

Ручная установка

git clone https://github.com/IlyaVorozhbit/yandex-metrika-mcp.git
cd yandex-metrika-mcp
npm install
npm run build

Установка и сборка из исходников, требует Node.js 18 и новее.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Читает данные о трафике, конверсиях и продажах, включая коммерчески чувствительную статистику

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает 25 инструментов только на чтение для аналитики Яндекс Метрики: базовая информация об аккаунте и визиты, сводка и типы источников трафика с поисковыми фразами, эффективность привлечения новых пользователей, контент-аналитика по источникам, категориям, авторам, темам и статьям, демография и устройства, сравнение мобильного и десктопного трафика, глубина просмотра, регионы и география органического трафика, эффективность страниц и целей, органический поиск, e-commerce по категориям и регионам, отчет по браузерам, данные по времени с группировкой и A/B эксперименты Директа. Проект основан на atomkraft/yandex-metrika-mcp, который не поддерживается с августа 2025 года, и несет на себе серию исправлений: несколько отчетов отправляли неверные атрибуты Reporting API или молча игнорировали параметры диапазона дат, что автор чинит и документирует в истории коммитов.

Для кого. Для тех, кто уже смотрел на оригинальный atomkraft/yandex-metrika-mcp и хочет тот же набор отчетов, но с исправленными датами и параметрами.

Подходит, если

  • Нужен широкий набор read-only отчетов Метрики без риска случайной записи
  • Уже сталкивались с тем, что отчет игнорировал диапазон дат в оригинальном atomkraft-проекте
  • Нужна контент-аналитика по авторам и темам статей вместе с обычным трафиком

Не подходит, если

  • Нужно создавать счетчики, цели или загружать офлайн-данные: сервер целиком на чтение, пишущих инструментов нет
  • Нужна активная поддержка апстрима: оригинальный проект не поддерживается, этот форк держится силами одного мейнтейнера

Пример запроса к агенту

Сравни трафик с мобильных и десктопных устройств за последний месяц

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

YANDEX_API_KEY обязательная, секрет
OAuth-токен Яндекса, для чтения достаточно права metrika:read

Ограничения

Нет пакета в npm, установка через клонирование и сборку из исходников. Поддерживается на best-effort основе одним человеком, issue и PR нужно заводить в этом форке, а не в оригинале. Набор отчетов фиксированный, добавить свой инструмент можно только правкой кода.

Как отключить. Удалите сервер из конфигурации MCP клиента и отзовите OAuth-токен на oauth.yandex.ru.

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

Чем этот сервер отличается от atomkraft/yandex-metrika-mcp?

Это форк с серией исправлений: несколько отчетов отправляли неверные атрибуты API или игнорировали диапазон дат, автор это чинит и поддерживает репозиторий, тогда как оригинал не обновляется с августа 2025 года.

Есть ли пишущие инструменты?

Нет, все 25 инструментов только читают данные аналитики, для работы достаточно права metrika:read.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер Яндекс Метрики на 15 инструментов: отчеты и трафик плюс создание, изменение и удаление счетчиков и целей

MCP-серверШирокий доступ1Звезды репозитория

Yandex Metrika MCP

Yandex Metrika MCP Server

Российский стек

MCP-сервер для отчетов Яндекс Метрики: трафик, источники, поисковые фразы, цели, география, устройства и контент-аналитика

MCP-серверРасширенный доступ24Звезды репозитория
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверРасширенный доступ2Звезды репозитория

Yandex Metrica MCP

yandex-metrica-mcp

Российский стек

MCP-сервер для Яндекс Метрики только на чтение: отчеты, сравнение периодов, цели и выгрузка сырых логов с входом через браузер

MCP-серверРасширенный доступ15Звезды репозитория
Российский стек

Read-only MCP-сервер Яндекс Метрики: 31 инструмент по трафику, контенту, демографии, географии, конверсиям и e-commerce, только с правом metrika:read

MCP-серверРасширенный доступ2Звезды репозитория
Российский стек

MCP-сервер только для чтения: отчеты Яндекс Метрики с точными датами, часовым поясом и признаком семплирования.

MCP-серверРасширенный доступ130Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
MCP Яндекс Метрики с исправлениями отчетов (эта карточка)нетAPI-ключ1
MCP Яндекс Метрики с управлением счетчикаминетAPI-ключ1управление счетчиками и целями
MCP-сервер Яндекс Метрики (ymetrika-mcp)нетAPI-ключ0на FastMCP, с трейсингом OpenTelemetry
Яндекс Метрика MCP с DuckDBнетAPI-ключ0считает сырые логи Метрики локально в DuckDB

Коротко о README

README на английском с русской версией отдельным файлом честно указывает происхождение: форк atomkraft/yandex-metrika-mcp с серией исправлений отчетов, поддерживается отдельно от апстрима. Дан список возможностей по областям аналитики, требования Node.js 18+, шаги установки сборкой из исходников, подробная инструкция получения OAuth-токена с описанием всех пяти прав доступа Метрики и пояснением, что для чтения достаточно metrika:read. Полный список из 25 инструментов сгруппирован по разделам: аккаунт, источники, контент, поведение и демография, география, эффективность и конверсия, e-commerce, браузеры, продвинутая аналитика. Лицензия MIT.

Бейдж для README

Сообщить о проблеме