MCP Яндекс Метрики с исправлениями отчетов
Yandex Metrika MCP Server (Node.js)
Read-only MCP Яндекс Метрики на 25 инструментов, форк неподдерживаемого проекта с исправлением неверных параметров отчетов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает данные о трафике, конверсиях и продажах, включая коммерчески чувствительную статистику
Установка
Ручная установка
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-проекте
- Нужна контент-аналитика по авторам и темам статей вместе с обычным трафиком
Не подходит, если
- Нужно создавать счетчики, цели или загружать офлайн-данные: сервер целиком на чтение, пишущих инструментов нет
- Нужна активная поддержка апстрима: оригинальный проект не поддерживается, этот форк держится силами одного мейнтейнера
Пример запроса к агенту
Сравни трафик с мобильных и десктопных устройств за последний месяцОграничения
Нет пакета в npm, установка через клонирование и сборку из исходников. Поддерживается на best-effort основе одним человеком, issue и PR нужно заводить в этом форке, а не в оригинале. Набор отчетов фиксированный, добавить свой инструмент можно только правкой кода.
Как отключить. Удалите сервер из конфигурации MCP клиента и отзовите OAuth-токен на oauth.yandex.ru.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_API_KEY обязательная, секрет | OAuth-токен Яндекса, для чтения достаточно права metrika:read |
Проверка безопасности
- Читает данные о трафике, конверсиях и продажах, включая коммерчески чувствительную статистику
Коротко о README
README на английском с русской версией отдельным файлом честно указывает происхождение: форк atomkraft/yandex-metrika-mcp с серией исправлений отчетов, поддерживается отдельно от апстрима. Дан список возможностей по областям аналитики, требования Node.js 18+, шаги установки сборкой из исходников, подробная инструкция получения OAuth-токена с описанием всех пяти прав доступа Метрики и пояснением, что для чтения достаточно metrika:read. Полный список из 25 инструментов сгруппирован по разделам: аккаунт, источники, контент, поведение и демография, география, эффективность и конверсия, e-commerce, браузеры, продвинутая аналитика. Лицензия MIT.
Частые вопросы
Чем этот сервер отличается от atomkraft/yandex-metrika-mcp?
Это форк с серией исправлений: несколько отчетов отправляли неверные атрибуты API или игнорировали диапазон дат, автор это чинит и поддерживает репозиторий, тогда как оригинал не обновляется с августа 2025 года.
Есть ли пишущие инструменты?
Нет, все 25 инструментов только читают данные аналитики, для работы достаточно права metrika:read.
Похожие
Скиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов