Telegram Обсудить проект
MCP · бесплатно · только чтение

MCP-сервер Яндекс Метрики

Подключает Яндекс Метрику к Claude, Cursor и другим ИИ-агентам: агент сам строит отчёты по источникам, страницам входа, устройствам, целям и UTM и отвечает обычными словами.

Версия 1.0.0 · Python 3.10+ · лицензия MIT

Коротко

MCP-сервер Яндекс Метрики — программа на Python, через которую ИИ-агент строит любые отчёты Метрики по вашему OAuth-токену: источники трафика, страницы входа, устройства, регионы, цели, UTM-метки, с фильтрами и сравнением периодов. Работает на вашем компьютере, только чтение, бесплатно.

Что умеет

ИнструментЧто даётПример вопроса
metrika_list_countersсчётчики аккаунта: номер, сайт, уровень доступа«Какие счётчики Метрики мне доступны?»
metrika_reportлюбой отчёт Reporting API: метрики, группировки, фильтры, период, точность«Сколько визитов из поиска Яндекса и Google было за октябрь по неделям и какие страницы входа с отказами выше 40 %?»

Агент сам выбирает инструмент и параметры — достаточно спросить обычными словами.

Установка

1. Python 3.10 или новее — python.org/downloads. На Windows отметьте при установке Add python.exe to PATH.

2. Архив. Скачайте yandex-metrika-mcp.zip и распакуйте, например, в C:\mcp. Откройте папку yandex-metrika-mcp, в адресной строке Проводника наберите powershell и нажмите Enter.

3. Зависимости:

python -m venv .venv
.venv\Scripts\pip install -r requirements.txt

Ключ

Нужен OAuth-токен Яндекса с правом metrika:read:

  1. Создайте приложение на oauth.yandex.ru/client/new: платформа «Веб-сервисы», Redirect URI https://oauth.yandex.ru/verification_code, право Яндекс Метрика → metrika:read. Если поставите и сервер Вебмастера, отметьте сразу и webmaster:hostinfo — токен будет один на оба.
  2. Откройте https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID, нажмите «Разрешить» и скопируйте токен y0_….
  3. В папке сервера переименуйте .env.example в .env, откройте блокнотом и впишите:
YANDEX_OAUTH_TOKEN=y0_ваш_токен

Как устроено приложение и токен Яндекса, подробно и с ошибками, — в статье «API Яндекс Вебмастера»: для Метрики шаги те же, меняется только право. Когда агент начнёт получать ошибку 401, получите токен заново.

Подключение к агенту

Пути замените на свои.

claude mcp add yandex-metrika --scope user -- "C:\mcp\yandex-metrika-mcp\.venv\Scripts\python.exe" "C:\mcp\yandex-metrika-mcp\server.py"

Проверка: claude mcp list — статус Connected.

Названия пунктов меню у клиентов меняются — сверяйтесь с их документацией.

Проверка

Спросите агента: «Покажи мои счётчики Метрики и визиты по каждому за прошлую неделю». Если агент ответил данными — всё работает. Если пишет, что инструмента нет, — проверьте путь: команда .venv\Scripts\python server.py в папке сервера должна молча «зависнуть» (это норма, выход Ctrl+C).

Необязательные настройки

Все — в файле .env, по одной на строку.

НастройкаЗачем
METRIKA_DEFAULT_COUNTERсчётчик по умолчанию — тогда в вопросах можно не называть сайт
METRIKA_ALLOWED_COUNTERSограничить агента этими счётчиками через запятую
METRIKA_ACCURACYточность отчётов: full (по умолчанию, без сэмплирования), medium или low — быстрее на больших счётчиках
HTTP_TIMEOUTтаймаут, по умолчанию 60 секунд — отчёты без сэмплирования бывают долгими
HTTPS_PROXYпрокси, если API Яндекса недоступен напрямую

Частые ошибки

Что видитеЧто делать
YANDEX_OAUTH_TOKEN не заданнет файла .env (а не .env.example) или токен не вставлен
401токен истёк или скопирован не полностью — получите новый
403у приложения нет права metrika:read или нет доступа к счётчику
Отчёт долго строитсябольшой счётчик и точность full — поставьте METRIKA_ACCURACY=medium

Не пересылайте никому файлы .env, credentials.json и gsc_token.json — это доступ к данным ваших сайтов. Вопросы и ошибки — в Telegram-канал @seo_drift.

Чего не умеет

  • Только чтение: цели и настройки счётчика сервер не меняет.
  • Отчёты — через Reporting API; сырые визиты (Logs API) сервер не выгружает.
  • Данные только по счётчикам, к которым у аккаунта есть доступ.

Какие данные собирает

Сервер работает у вас на компьютере. Ключ лежит в папке сервера и уходит только в официальный API. SEO Drift не видит ни ключа, ни данных ваших сайтов.

Вопросы и ответы

Это бесплатно?

Да. Сервер бесплатный, с открытым кодом под лицензией MIT, API тоже бесплатный.

С какими агентами работает?

С любым клиентом MCP, который запускает локальные серверы: Claude Code, Claude Desktop, Cursor и другие.

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

Нет, все инструменты только читают данные.

Где остальные серверы?

Все три сервера — Вебмастер, Метрика и Search Console — на странице MCP-серверы для SEO, там же общий архив и настройка сразу для всех.

Читать дальше по теме

Источники

  1. Яндекс — API Метрики: Reporting API
  2. Яндекс — API Метрики: авторизация

Другие инструменты

Все инструменты →