MCP-сервер Яндекс Метрики только для чтения
yandex-metrika-mcp
Минималистичный MCP на Python: 12 инструментов только для чтения по правильному заголовку OAuth и парный скилл с методикой сравнения периодов
- 4 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает локальный сервер, который по OAuth-токену читает счетчики и отчеты Метрики
- Инструментов записи и изменения настроек нет
Установка
- Работает в
- Сервисы
Ручная установка
python3 -m venv .venv && . .venv/bin/activate && pip install -e .Установка из локального чекаута репозитория.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает локальный сервер, который по OAuth-токену читает счетчики и отчеты Метрики
- Инструментов записи и изменения настроек нет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает API Яндекс Метрики в 12 инструментов только для чтения: обнаружение структуры аккаунта (счетчики, цели, сегменты, фильтры, права доступа, метки), произвольные табличные отчеты с метриками, измерениями, фильтрами и сортировкой, разбивку по времени и по значению одного измерения, сравнение двух периодов равной длины. Сервер намеренно не оборачивает весь API построчно, чтобы не раздувать промпт модели, и использует правильный заголовок Authorization OAuth, а не Bearer, на котором спотыкаются другие реализации. В комплекте лежит парный SKILL.md для Hermes Agent, который задает методику анализа: сначала список счетчиков, потом сравнимые по длительности периоды, разложение изменения по источнику, странице, устройству, проверка качества трафика и метка уверенности в выводе.
Для кого. Для маркетинговых аналитиков, которым нужны точные отчеты Метрики без риска, что агент случайно что-то изменит в счетчике.
Подходит, если
- Нужен строго read-only доступ к Метрике без инструментов записи
- Нужно сравнение периодов с разложением изменения по источникам, страницам или устройствам
- Нужен компактный набор инструментов без раздувания контекста модели
Не подходит, если
- Нужно менять настройки счетчика, цели или сегменты: инструментов записи нет
- Нужна интеграция именно с Hermes Agent без ручной настройки обертки для токена в других клиентах
Пример запроса к агенту
Сравни трафик за этот и прошлый месяц и разложи изменение по источникамMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YANDEX_METRIKA_TOKENобязательная, секрет- OAuth-токен Яндекс Метрики
Ограничения
Нужен OAuth-токен Метрики в переменной окружения YANDEX_METRIKA_TOKEN, сервер сам собирает заголовок Authorization OAuth. Готового пакета в PyPI нет, установка только из исходников через pip install -e . или uv tool install. Сопроводительный скилл написан под формат Hermes Agent, для других агентов методику анализа придется переносить вручную.
Как отключить. Удалите блок yandex-metrika-mcp из конфигурации MCP клиента или переменную YANDEX_METRIKA_TOKEN из окружения.
Частые вопросы
Есть ли инструменты записи?
Нет, сервер полностью read-only, все 12 инструментов только читают данные.
Почему не просто использовать заголовок Bearer?
Яндекс Метрика отклоняет Bearer с ошибкой 401, нужен именно заголовок Authorization OAuth, который сервер формирует сам.
Обсуждение
Вопросов и отзывов пока нет.
Yandex Metrica MCP
yandex-metrica-mcp
MCP-сервер для Яндекс Метрики только на чтение: отчеты, сравнение периодов, цели и выгрузка сырых логов с входом через браузер
MCP для полного API Яндекс Метрики
mcp-server-yandex-metrika
MCP-сервер, CLI и Pydantic-модели для API Яндекс Метрики: отчеты, счетчики, цели, фильтры, сегменты, логи и загрузка офлайн-конверсий
MCP Яндекс Метрики с управлением счетчиками
@theyahia/yandex-metrika-mcp
MCP-сервер Яндекс Метрики на 15 инструментов: отчеты и трафик плюс создание, изменение и удаление счетчиков и целей
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
MCP-сервер только для чтения: отчеты Яндекс Метрики с точными датами, часовым поясом и признаком семплирования.
Яндекс Метрика MCP: отчеты и цели в Claude, Cursor, Codex
mcp-yandex-metrica
MCP-сервер Метрики на npx с входом через Яндекс OAuth прямо в чате: счетчики, цели, отчеты по визитам и конверсиям, обычные запросы только на чтение
Коротко о README
README на английском и русском объясняет два слоя: MCP-сервер как слой данных и скилл Hermes Agent как слой методики анализа, оба нужны вместе для полноценной работы. Перечислены инструменты обнаружения структуры и отчетов, объяснена причина минимального набора вместо полного покрытия API, показаны установка через pip или uv, переменная токена и обертка для Hermes, которая прячет токен из редактируемого конфига. Указана лицензия MIT.