yandex-metrica-mcp — MCP-сервер для Claude Code: Яндекс Метрика в чате
MCP-сервер, через который агент читает данные Яндекс Метрики: отчёты, сравнение периодов, тренды и выгрузки логов. Пригодится, когда не хочется открывать дашборд ради пары цифр.
claude mcp add --env YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> --env YANDEX_METRIKA_COUNTER_ID=<YANDEX_METRIKA_COUNTER_ID> --env YANDEX_METRIKA_LOGS_DIR=<YANDEX_METRIKA_LOGS_DIR> --transport stdio yandex-metrica-mcp -- npx -y yandex-metrica-mcpЧто делает yandex-metrica-mcp
Сервер даёт агенту набор инструментов над Reporting API. run_report строит отчёт по срезу, run_comparison считает разницу между двумя периодами в абсолюте и процентах, run_timeseries раскладывает метрики по времени, run_drilldown проходит вглубь по дереву измерений. get_metadata отдаёт список счётчиков и каталог реальных имён измерений и метрик, чтобы модель не сочиняла поля. Через Logs API выгружаются сырые строки визитов и хитов по схеме «запрос → опрос → скачивание → очистка».
Всё работает только на чтение. Авторизация — интерактивный вход: сервер сам поднимает браузер и забирает код через локальный редирект, токен кэшируется и живёт около года. Для CI или работы без терминала есть статический YANDEX_METRIKA_TOKEN. Нужен Node.js 18 или новее, а у владельца учётки должен быть доступ к счётчикам, которые вы запрашиваете, с областью metrika:read.
Порт 53682 для редиректа может оказаться занят: тогда вход переключается на ручной ввод кода, а порт меняется переменной YANDEX_OAUTH_LOOPBACK_PORT. Кэшированный логин важнее переменной YANDEX_METRIKA_TOKEN, так что протухший токен из файла придётся переавторизовать, иначе статический токен не подхватится.
Какие задачи решает
- посмотреть источники трафика за неделю без похода в интерфейс Метрики
- сравнить два периода и увидеть, где просели конверсии
- выгрузить сырые строки визитов для собственного разбора
- найти id целей счётчика перед запросом конверсионных метрик
- построить тренд по метрике во времени прямо в чате
Примеры запросов агенту
- Покажи источники трафика по счётчику за последние 7 дней
- Сравни визиты и конверсии за эту и прошлую неделю
- Какие цели настроены у счётчика? Выведи их id
Как установить yandex-metrica-mcp
Командой платформы
claude mcp add --env YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> --env YANDEX_METRIKA_COUNTER_ID=<YANDEX_METRIKA_COUNTER_ID> --env YANDEX_METRIKA_LOGS_DIR=<YANDEX_METRIKA_LOGS_DIR> --transport stdio yandex-metrica-mcp -- npx -y yandex-metrica-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add yandex-metrica-mcp --env YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> --env YANDEX_METRIKA_COUNTER_ID=<YANDEX_METRIKA_COUNTER_ID> --env YANDEX_METRIKA_LOGS_DIR=<YANDEX_METRIKA_LOGS_DIR> -- npx -y yandex-metrica-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"yandex-metrica-mcp": {
"command": "npx",
"args": [
"-y",
"yandex-metrica-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>",
"YANDEX_METRIKA_COUNTER_ID": "<YANDEX_METRIKA_COUNTER_ID>",
"YANDEX_METRIKA_LOGS_DIR": "<YANDEX_METRIKA_LOGS_DIR>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"yandex-metrica-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"yandex-metrica-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>",
"YANDEX_METRIKA_COUNTER_ID": "<YANDEX_METRIKA_COUNTER_ID>",
"YANDEX_METRIKA_LOGS_DIR": "<YANDEX_METRIKA_LOGS_DIR>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -e YANDEX_METRIKA_COUNTER_ID=<YANDEX_METRIKA_COUNTER_ID> -e YANDEX_METRIKA_LOGS_DIR=<YANDEX_METRIKA_LOGS_DIR> yandex-metrica-mcp npx -y yandex-metrica-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о yandex-metrica-mcp
Как установить yandex-metrica-mcp в Claude Code?
Добавьте сервер командой claude mcp add yandex-metrica-mcp -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -- npx -y yandex-metrica-mcp, затем один раз выполните npx yandex-metrica-mcp auth и подтвердите доступ в браузере.
Что делает yandex-metrica-mcp?
Отвечает на вопросы о вашей веб-аналитике: строит отчёты по измерениям, сравнивает периоды, считает тренды и выгружает логи сессий. Работает только на чтение и не пишет ничего в счётчик.
Что нужно для работы сервера?
Node.js версии 18 или выше и доступ к нужным счётчикам с областью metrika:read. Без интерактивного входа понадобится статический YANDEX_METRIKA_TOKEN.
