SkillFoxx

Начните вводить название, задачу или сервис

MCP для полного API Яндекс Метрики

mcp-server-yandex-metrika

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

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

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

  • Может удалить счетчики, цели, фильтры, сегменты и права доступа
  • Токен с правами metrika:write дает полный контроль над счетчиками аккаунта
  • Может загружать офлайн-конверсии и расходы, влияя на данные атрибуции
Все причины и проверки
Российский стек

dontsovcmc/mcp-server-yandex-metrikaАвтор:dontsovcmc

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mcp-server-yandex-metrika

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'YANDEX_METRIKA_TOKEN=<ваш YANDEX_METRIKA_TOKEN>' yandex-metrika -- uvx mcp-server-yandex-metrika==0.2.4

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"yandex-metrika","type":"stdio","command":"uvx","args":["mcp-server-yandex-metrika==0.2.4"],"env":{"YANDEX_METRIKA_TOKEN":"<ваш YANDEX_METRIKA_TOKEN>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "yandex-metrika": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add yandex-metrika --env 'YANDEX_METRIKA_TOKEN=<ваш YANDEX_METRIKA_TOKEN>' -- uvx mcp-server-yandex-metrika==0.2.4

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.yandex-metrika]
command = "uvx"
args = ["mcp-server-yandex-metrika==0.2.4"]
env = { YANDEX_METRIKA_TOKEN = "<ваш YANDEX_METRIKA_TOKEN>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'YANDEX_METRIKA_TOKEN=<ваш YANDEX_METRIKA_TOKEN>' yandex-metrika uvx mcp-server-yandex-metrika==0.2.4

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "yandex-metrika": {
      "type": "local",
      "command": [
        "uvx",
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "environment": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-metrika==0.2.4"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_METRIKA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит cd20e21.

Текст для агента

Зарегистрируй приложение на oauth.yandex.com с правами metrika:read и metrika:write, получи токен, затем добавь сервер командой claude mcp add yandex-metrika -e YANDEX_METRIKA_TOKEN=токен -- uvx mcp-server-yandex-metrika.

Другие способы из описания автора
claude mcp add yandex-metrika \
  -e YANDEX_METRIKA_TOKEN=ваш_токен \
  -- uvx mcp-server-yandex-metrika

Способ через uvx, не требует установки пакета.

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

Что делает

Проект дает MCP-сервер, CLI-утилиту и библиотеку типизированных Pydantic-моделей поверх API Яндекс Метрики. Покрытие широкое: табличные, временные, drill down и сравнительные отчеты Reporting API, полное управление счетчиками, целями, фильтрами, сегментами, метками, операциями и правами доступа с созданием, изменением и удалением, работа с аккаунтами и представителями, примечания на графике, Logs API для выгрузки визитов и хитов, а также загрузка офлайн-конверсий, звонков, расходов и пользовательских параметров. У каждого MCP-инструмента есть парный CLI-эквивалент, а без аргументов пакет запускает MCP-сервер, с командой работает как обычный CLI. Все запросы идут напрямую в API с локального компьютера, токен никуда, кроме Яндекс Метрики, не передается.

Для кого. Для аналитиков и маркетологов, которым нужен полный контроль над Яндекс Метрикой, включая создание целей и фильтров, а не только чтение отчетов.

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

  • Нужно создать или изменить цели, фильтры или сегменты счетчика прямо из диалога с агентом
  • Нужна выгрузка сырых логов визитов или загрузка офлайн-конверсий и звонков
  • Нужны те же данные и в CLI для скриптов, и в MCP для агента без второго инструмента

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

  • Нужен только просмотр без риска случайно удалить цель, фильтр или счетчик: здесь доступны и удаляющие инструменты
  • Не нужна такая широта: только отчеты, без управления целями и правами, тогда подойдет более узкий сервер

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

Создай цель Покупка типа url с условием contain /thank-you для счетчика 12345678

Ограничения

Лицензия в метаданных репозитория не заявлена явно, хотя README указывает MIT. Нужен OAuth-токен с правами metrika:read и metrika:write. Лимиты API: 30 запросов в секунду на IP, 5000 в день на пользователя, 3 параллельных запроса, отдельный лимит 200 запросов за 5 минут для основного отчета, превышение возвращает HTTP 420.

Как отключить. Удалите сервер командой claude mcp remove yandex-metrika и отзовите OAuth-токен на oauth.yandex.com.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
YANDEX_METRIKA_TOKEN
обязательная, секрет		OAuth-токен Яндекс Метрики с правами metrika:read и metrika:write
METRIKA_TIMEOUT
Таймаут HTTP-запросов к API в секундах, по умолчанию 30
METRIKA_FILE_TIMEOUT
Таймаут скачивания файлов логов в секундах, по умолчанию 60

Проверка безопасности

  • Может удалить счетчики, цели, фильтры, сегменты и права доступа
  • Токен с правами metrika:write дает полный контроль над счетчиками аккаунта
  • Может загружать офлайн-конверсии и расходы, влияя на данные атрибуции

Коротко о README

README на русском описывает три формы одного пакета: MCP-сервер, CLI и библиотеку Pydantic-моделей поверх API Яндекс Метрики. Дана подробная таблица инструментов по категориям: отчеты, счетчики, цели, фильтры, доступ, операции, сегменты, метки, аккаунты, примечания, фильтры доступа, Logs API, импорт данных, с парным CLI-именем для каждого. Показаны шаги получения OAuth-токена, установка через uvx и pip, подключение к Claude Code и Claude Desktop, временное подключение через --mcp-config, примеры CLI-команд, использование Pydantic-моделей в своих скриптах, переменные окружения и лимиты API. Лицензия MIT.

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

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

Да, тот же пакет работает как обычная CLI-утилита: без аргументов запускается MCP-сервер, с командой вроде counters или stat-data выполняется нужный запрос и выводится JSON.

Есть ли типизированные модели для своих скриптов?

Да, пакет содержит Pydantic-модели всех объектов API с extra=allow для совместимости с будущими полями, их можно импортировать в свои Python-программы.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2
Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.
Foxx AIMCP для полного API Яндекс Метрики

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.