SkillFoxx
Telegram

MCP Яндекс Метрики со всеми 108 методами API

Yandex Metrika MCP Server

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

  • 2 ★ репозитория
  • Последний коммит
MCP-серверВыбор редакции

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

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

  • С METRIKA_ALLOW_WRITES=1 открываются 57 пишущих инструментов, меняющих счетчики, цели и сегменты
  • Читает коммерчески чувствительную статистику трафика и конверсий
  • По умолчанию пишущие инструменты скрыты, риск возникает только после осознанного включения
Все причины и проверки
Российский стек

artgas1/yandex-metrika-mcpАвтор:artgas1

Установка

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

npx skillfoxx add mcp/artgas1-yandex-metrika-mcp

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

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

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

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

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

  • С METRIKA_ALLOW_WRITES=1 открываются 57 пишущих инструментов, меняющих счетчики, цели и сегменты
  • Читает коммерчески чувствительную статистику трафика и конверсий
  • По умолчанию пишущие инструменты скрыты, риск возникает только после осознанного включения

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

Что делает

Сервер покрывает все 108 методов API Яндекс Метрики: 95 методов Management API в 21 ресурсе, 7 методов Logs API и 6 методов Stat API. Инструменты не пишутся руками, а порождаются из спеки, которую сервер сам собирает построчным сканером CSS-классов со страниц официальной документации на движке Diplodoc, потому что публичного openapi.json у Метрики нет. По умолчанию объявляется только 10 инструментов профиля core, остальное открывается переменной METRIKA_PROFILE со значениями read (51 читающий метод) или all (все 108), а пишущие инструменты дополнительно требуют METRIKA_ALLOW_WRITES=1, без чего они вообще не попадают в список tools/list. У каждого ответа есть блок _meta с applied_by_server, notes, retries, rows_total, truncated и truncated_by_server: сервер честно показывает, что добавил от себя, например фильтр роботов ym:s:isRobot=='no', и что обрезал по лимиту длины. Есть отдельный инструмент metrika_catalog_list, который без токена и сети показывает, что скрыто и как это включить.

Для кого. Для тех, кому кроме полного охвата API Метрики важна прозрачность: точно знать, что сервер добавил от себя в запрос и ответ.

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

  • Нужен полный доступ ко всем 108 методам API Метрики, включая редкие ресурсы Management API
  • Важно точно знать, какие фильтры и допущения сервер применил без явного запроса
  • Нужен контролируемый рост поверхности инструментов: от 10 базовых до всех 108 по явной переменной

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

  • Нужны пишущие инструменты сразу из коробки: они скрыты по умолчанию и требуют METRIKA_ALLOW_WRITES=1
  • Не хочется разбираться в профилях core, read и all: сервер сознательно ограничивает набор ради экономии контекста модели, а не отдает все сразу

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

Откуда приходили люди за неделю и сколько дошло до цели?

MCP

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

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

YANDEX_API_KEY обязательная, секрет
OAuth-токен Яндекса с доступом к Метрике, без него сервер не стартует
METRIKA_PROFILE
Какая часть каталога объявляется: core (10 инструментов), read (51), all (все 108)
METRIKA_ALLOW_WRITES
1 объявляет 57 пишущих инструментов, без этой переменной их нет в tools/list
METRIKA_TRAFFIC_FILTER
Условие сегментации для отчетов Stat, по умолчанию исключает роботов
METRIKA_MAX_OUTPUT_CHARS
Потолок длины ответа одного вызова, по умолчанию 120000 символов

Ограничения

Лицензия в метаданных GitHub определена как NOASSERTION, хотя README и файл LICENSE указывают MIT. Разбор спеки привязан к конкретной версии движка документации Яндекса Diplodoc, расхождение версии останавливает сборку спеки при обновлении. Полный профиль all с включенными записями заметно увеличивает объем описаний инструментов в контексте модели, около 73 тысяч токенов по замеру автора. Logs API может не поместиться в лимит длины одного ответа, тогда результат обрезается с пометкой в метаданных.

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

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

Как узнать, какие инструменты скрыты, не читая README?

Вызвать metrika_catalog_list: он объявлен в любом профиле, работает без токена и сети и прямо показывает, сколько методов скрыто и как расширить профиль.

Можно ли включить запись без включения всех 108 методов?

Нет, пишущие инструменты появляются только вместе с профилем all и переменной METRIKA_ALLOW_WRITES=1, частичного включения только записи не предусмотрено.

Обсуждение

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

Яндекс Метрика — все инструменты
Российский стек

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

MCP-серверШирокий доступ1
Российский стек

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

MCP-серверШирокий доступ2

Yandex Metrica MCP

yandex-metrica-mcp

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

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

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

Yandex Metrika MCP

Yandex Metrika MCP Server

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

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

MCP-серверРасширенный доступ24
Российский стек

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

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

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

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

Коротко о README

README на русском с английской версией отдельным файлом подробно описывает контракт сервера: никакой молчаливой подмены запроса, все добавленное сервером видно в _meta, отказ остается отказом с телом ошибки API, обрезание выдачи объявляется, секреты редактируются в показанных URL. Объясняется устройство сборки спеки построчным сканером по CSS-классам документации и тест на дрейф API. Дана таблица переменных окружения для профиля, включения записи, ручного отбора инструментов, фильтра трафика и лимита длины ответа, а также замер размера манифеста tools/list по профилям в байтах и токенах. Отдельно описан фильтр роботов по умолчанию и особенность сравнения периодов без дат, где Метрика молча сравнивает период сам с собой. Лицензия MIT.

Бейдж для README

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