SkillFoxx
Telegram

Яндекс Метрика MCP с device flow и Logs API

yandex-metrika-mcp

MCP-сервер Яндекс Метрики для Claude Desktop с OAuth device flow без браузерного редиректа и полным циклом Logs API

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

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

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

  • Читает подробную статистику и сырые визиты посетителей через Logs API
  • OAuth-приложение запрашивает права metrika:write и metrika:expenses сверх чтения
  • Токены хранятся в незашифрованном файле token.json на диске
Все причины и проверки
Российский стек

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

Установка

Ручная установка

git clone https://github.com/perfilev/yandex-metrika-mcp.git
cd yandex-metrika-mcp
npm install
npm run build

Сборка сервера перед логином и подключением.

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

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

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

  • Читает подробную статистику и сырые визиты посетителей через Logs API
  • OAuth-приложение запрашивает права metrika:write и metrika:expenses сверх чтения
  • Токены хранятся в незашифрованном файле token.json на диске

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

Что делает

Сервер дает модели доступ к Reporting, Management, Logs API и реал-тайм отчетам Метрики. Универсальный инструмент get_report принимает любые dimensions, metrics, filters и sort, а пресеты закрывают частые сценарии: трафик и UTM, аудиторию по гео и устройствам, контент и конверсии с воронками. Есть список счетчиков, целей и сегментов, real-time bytime и drilldown и полный цикл Logs API от постановки задачи до скачивания и очистки лога. Авторизация идет через npm run login: скрипт открывает device flow Яндекс OAuth без redirect URI и сохраняет токены в token.json, обновляя их автоматически.

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

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

  • Нужен произвольный отчет с любой комбинацией измерений и метрик через get_report
  • Нужны сырые визиты из Logs API с конкретными полями вроде ClientID или целей
  • Не хочется настраивать redirect URI для OAuth: авторизация идет через device flow в терминале

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

  • Достаточно нескольких готовых отчетов без гибкой настройки: проще взять сервер с именованными инструментами
  • Нет Node.js окружения для сборки перед первым запуском

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

Сделай воронку по цели id=123 за апрель и покажи топ-20 страниц входа с худшим отказом

MCP

Транспорт
stdio
Авторизация
OAuth

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

YANDEX_CLIENT_ID обязательная
Client ID OAuth-приложения Яндекс ID
YANDEX_CLIENT_SECRET обязательная, секрет
Client secret OAuth-приложения
TOKEN_PATH обязательная
Путь к файлу token.json с сохраненными токенами

Ограничения

Нужно OAuth-приложение Яндекс ID с правами metrika:read, metrika:write, metrika:user_params, metrika:expenses. Токены хранятся в локальном файле token.json рядом с сервером. Лицензии в репозитории нет.

Как отключить. Удалите блок yandex-metrika из claude_desktop_config.json и файл token.json с сохраненными токенами.

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

Нужно ли настраивать redirect URI для OAuth?

Нет, npm run login использует device flow: запрашивает device code у Яндекса, показывает код подтверждения и сам сохраняет токены.

Что происходит, когда токен истекает?

Сервер автоматически обновляет access_token по сохраненному refresh_token без повторного входа.

Обсуждение

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

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

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

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

Yandex Metrica MCP

yandex-metrica-mcp

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

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

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

Yandex Metrika MCP

Yandex Metrika MCP Server

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

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

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

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

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

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

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

MCP-сервер Метрики для Claude Code с Stat, Logs, Management и Compare API и локальным SQL-анализом сырых логов через DuckDB

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

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
Яндекс Метрика MCP с device flow и Logs API (эта карточка)нетOAuth0
Яндекс Метрика MCP: компактный сервер отчетовнетOAuth0компактный сервер отчетов
Яндекс Метрика MCP: 25 инструментов аналитикинетOAuth025 готовых отчетов

Коротко о README

README описывает возможности по блокам: универсальный get_report, пресеты, счетчики, real-time, Logs API, дает установку через клонирование и сборку, шаги создания OAuth-приложения и получения токена через npm run login, конфигурацию для Claude Desktop и примеры вопросов на русском.

Бейдж для README

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