yandex-metrika

yandex-metrika

dontsovcmc
MCP-сервер для доступа к данным Яндекс Метрики через AI-ассистента. Сервер управляет счётчиками, целями и отчётами напрямую из чата. Токен авторизации хранится локально и не передаётся на сторону. В проект также входят CLI-утилита и библиотека Pydantic-моделей. CLI автоматизирует запросы к Метрике в скриптах, а типизированные модели пригодятся при разработке собственных интеграций на Python.

Установка

uvx mcp-server-yandex-metrika

Характеристики

Общее

  • СтатусСообщество
  • Разработчикdontsovcmc

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Строить детализированные табличные отчёты с произвольным набором метрик и измерений.
  • Группировать данные по временным интервалам: час, день, неделя, месяц.
  • Применять drill down для раскрытия данных по уровням иерархии.
  • Сравнивать несколько сегментов или периодов в одном отчёте.
  • Запрашивать список счётчиков с фильтрацией и поиском.
  • Создавать, изменять, удалять и восстанавливать счётчики.
  • Управлять целями: создавать цели (url, number, step, action), редактировать и удалять их.
  • Использовать все перечисленные функции из командной строки для CI/CD и скриптов.

Как подключить

Установите сервер глобально через uvx:

uvx mcp-server-yandex-metrika

Добавьте конфигурацию в ваш MCP-клиент. Пример для Claude Desktop:

{ "mcpServers": { "yandex-metrika": { "command": "uvx", "args": ["mcp-server-yandex-metrika"], "env": { "YM_OAUTH_TOKEN": "ваш_oauth_токен" } } } }

Перезапустите клиент.

Примеры запросов

  • «Покажи список счётчиков и количество визитов за сегодня».
  • «Найди цель с именем «Заявка» в счётчике 12345».
  • «Сравни конверсию из поискового трафика и из соцсетей за последние 30 дней».
  • «Создай новый счётчик для сайта example.ru и добавь цель типа action».

Технические детали

  • Язык: Python
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимые клиенты: Claude Desktop, Claude Code, Cline, другие MCP-хосты
  • Разработчик: dontsovcmc

Поделиться