MCP-сервер Яндекс Метрики, read-only форк
yandex-metrika-mcp
Read-only MCP-сервер Stat API Яндекс Метрики, форк atomkraft с npx-установкой и исправленными датами в отчетах
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Сервер устроен так, что операций записи в нем нет вообще, только чтение отчетов
Установка
Ручная установка
claude mcp add yandex-metrika --env YANDEX_API_KEY=ВАШ_ТОКЕН -- npx -y github:nikolaymokh-dev/yandex-metrika-mcpКоманда из README, устанавливает и подключает сервер сразу.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает 26 инструментов поверх Stat API Метрики: визиты, источники трафика, контент-аналитика, демография, устройства, география, глубина просмотра, конверсии по целям, e-commerce и другие отчеты. Все инструменты только читают данные, операций записи в проекте нет вовсе, поэтому специального флага для их отключения не предусмотрено. Проект форкнут от atomkraft/yandex-metrika-mcp и добавляет установку через npx прямо из git, исправляет игнорирование date_from и date_to в get_visits и возвращает ошибки как MCP-результат с isError вместо обычного текста.
Для кого. Для аналитиков и маркетологов, которым нужен безопасный read-only доступ к широкому набору отчетов Метрики из агента.
Подходит, если
- Нужен широкий набор готовых отчетов Метрики: контент-аналитика, устройства, гео, e-commerce
- Важно, чтобы сервер не мог ничего изменить в аккаунте по определению
- Удобна установка одной командой claude mcp add с npx из github
Не подходит, если
- Нужен доступ к Logs API или управлению счетчиками и целями: их тут нет
- Нужна работа с Direct или Webmaster в том же сервере
Пример запроса к агенту
Сравни мобильный и десктоп трафик за неделю и покажи конверсии по целямОграничения
Пакет не опубликован в npm registry, установка идет через npx -y github:owner/repo прямо из репозитория. Нет доступа к Logs API, импорту и управлению. Нужен OAuth-токен со scope metrika:read.
Как отключить. Удалите сервер командой claude mcp remove yandex-metrika или уберите его из .mcp.json.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_API_KEY обязательная, секрет | OAuth-токен Яндекса со scope metrika:read |
Проверка безопасности
- Сервер устроен так, что операций записи в нем нет вообще, только чтение отчетов
Коротко о README
README на русском объясняет, почему сервер read-only по конструкции, а не по флагу, как получить OAuth-токен со scope только metrika:read, и дает три способа установки: claude mcp add, конфиг .mcp.json и сборку из исходников. Инструменты сгруппированы по темам: аккаунт, источники, контент, аудитория, гео, поведение, поиск, e-commerce. Подробности на английском вынесены в README_en.md, изменения относительно оригинала перечислены в NOTICE.
Частые вопросы
Может ли сервер что-то изменить в Метрике?
Нет, в проекте вообще не реализованы операции записи, только 26 отчетных инструментов.
Чем отличается от оригинала atomkraft?
Добавлена npx-установка, исправлен баг с игнорированием дат в get_visits и изменена обработка ошибок.
Похожие
Скиллы 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-поиск силами параллельных агентов