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.txtpython3 -m venv .venv
.venv/bin/pip install -r requirements.txtКлюч
Нужен OAuth-токен Яндекса с правом metrika:read:
- Создайте приложение на oauth.yandex.ru/client/new: платформа «Веб-сервисы», Redirect URI
https://oauth.yandex.ru/verification_code, право Яндекс Метрика → metrika:read. Если поставите и сервер Вебмастера, отметьте сразу иwebmaster:hostinfo— токен будет один на оба. - Откройте
https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID, нажмите «Разрешить» и скопируйте токенy0_…. - В папке сервера переименуйте
.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.
Claude Desktop: Settings → Developer → Edit Config. Cursor: Settings → MCP или файл ~/.cursor/mcp.json. Слеши — прямые.
{
"mcpServers": {
"yandex-metrika": {
"command": "C:/mcp/yandex-metrika-mcp/.venv/Scripts/python.exe",
"args": ["C:/mcp/yandex-metrika-mcp/server.py"]
}
}
}Если в файле уже есть другие серверы, добавьте этот внутрь блока "mcpServers". Claude Desktop перезапустите полностью — через значок в трее.
claude mcp add yandex-metrika --scope user -- ~/mcp/yandex-metrika-mcp/.venv/bin/python ~/mcp/yandex-metrika-mcp/server.pyВ JSON для Claude Desktop и Cursor — те же пути с .venv/bin/python.
Названия пунктов меню у клиентов меняются — сверяйтесь с их документацией.
Проверка
Спросите агента: «Покажи мои счётчики Метрики и визиты по каждому за прошлую неделю». Если агент ответил данными — всё работает. Если пишет, что инструмента нет, — проверьте путь: команда .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, там же общий архив и настройка сразу для всех.