MCP аналитики Яндекс Метрики на 31 инструмент

ya-metrics-mcp

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

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

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

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

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

mrkhachaturov/ya-metrics-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/ya-metrics-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

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

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

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

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

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

Что делает

Сервер дает 31 инструмент по семи направлениям аналитики Яндекс Метрики. Счетчики и аккаунт: список счетчиков и целей, метаданные счетчика. Трафик и источники: визиты, сводка по источникам, поисковые фразы, типы источников, данные по поисковым системам, новые пользователи по источнику. Контент-аналитика для интеграции с Дзен и Турбо: источники, категории, авторы, темы, статьи. Демография и устройства: возраст, пол, устройство, браузер и ОС, глубина просмотра. География: трафик по городам и странам. Производительность и конверсии: отказы и длительность по странице входа, конверсия по целям, SEO-эффективность, конверсия по источнику и посадочной странице. Продвинутые и drill-down отчеты: e-commerce покупки, временные ряды, A/B эксперименты Директа, browser-отчет, иерархический drill-down и сравнение сегментов. Все инструменты read-only и требуют только права metrika:read, многие принимают параметр limit, чтобы не переполнять контекст агента большими выгрузками.

Для кого. Для маркетологов и аналитиков, которым нужна широкая read-only аналитика Яндекс Метрики без риска что-то изменить в счетчике.

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

  • Нужно сравнить источники трафика, устройства или сегменты пользователей за период
  • Нужна конверсия по целям и посадочным страницам без захода в интерфейс Метрики
  • Есть интеграция с Дзен или Турбо и нужна контент-аналитика статей и авторов

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

  • Нужно создавать или менять цели, фильтры, сегменты или счетчики: сервер только читает данные
  • Контент-аналитика не нужна, а важна интеграция Дзен и Турбо: без нее часть инструментов вернет пустой результат

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

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

MCP

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

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

YANDEX_API_KEY обязательная, секрет
OAuth-токен Яндекса с правом metrika:read
YANDEX_TIMEOUT
Таймаут запроса в секундах, по умолчанию 30
YANDEX_RETRIES
Число повторов при ошибках 5xx, по умолчанию 3

Ограничения

Нужен OAuth-токен только с правом metrika:read, но управление счетчиком через сервер недоступно вообще. Контент-аналитика работает только при интеграции Яндекс Дзен или Турбо на счетчике, e-commerce отчет требует включенного отслеживания покупок. Пакет распространяется через uvx или запуск из исходников, отдельного релиза для pip README не упоминает.

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

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

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

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

Почему контент-аналитика не возвращает данные?

Эти инструменты требуют интеграции Яндекс Дзен или Турбо на счетчике, без нее источники, категории и авторы статей недоступны.

Обсуждение

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

Yandex Metrica MCP

yandex-metrica-mcp

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

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

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

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

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

Yandex Metrika MCP

Yandex Metrika MCP Server

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

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

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

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

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

Минималистичный MCP на Python: 12 инструментов только для чтения по правильному заголовку OAuth и парный скилл с методикой сравнения периодов

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

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

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

Коротко о README

README на английском с версией на русском в отдельном файле описывает сервер как экспонирующий 31 инструмент по семи доменам аналитики. Даны шаги получения OAuth-токена с единственным правом metrika:read, конфигурация для Claude Desktop и Cursor через uvx или запуск из исходников через uv run. Инструменты сгруппированы по таблицам: аккаунт и счетчики, трафик и источники, контент-аналитика с пометкой о требовании интеграции Дзен и Турбо, демография и устройства, география, производительность и конверсия, продвинутые и drill-down отчеты. Отдельно описан параметр limit для контроля размера ответа и таблица переменных окружения для таймаутов и повторов запросов.

Бейдж для README

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