Что агент делает в Метрике: задачи и серверы
Серверов для Метрики много, и почти все они от сообщества. Ниже они разложены по задачам, к каждой один-два подходящих варианта.
- Ответить, откуда трафик и что с конверсией. Yandex Metrica MCP сравнивает периоды с разницей в процентах, спускается по дереву измерений и входит в аккаунт через браузер по протоколу PKCE, без регистрации своего приложения.
- Получить готовые отчеты без знания API. Yandex Metrika MCP и сервер на 31 инструмент отдают поисковые фразы, демографию, устройства, регионы, цели и e-commerce именованными вызовами.
- Разобрать падение по методике. MCP только для чтения на Python держит 12 инструментов и парный скилл: сначала счетчики, потом периоды равной длины, затем разложение по источнику, странице и устройству.
- Посчитать когорты по сырым визитам. Метрика MCP с DuckDB складывает выгрузку Logs API в parquet, а агент пишет к ней SQL только на чтение.
- Настроить счетчики и цели. MCP со всеми 108 методами API сначала открывает 10 инструментов профиля core, пишущие открывает переменная
METRIKA_ALLOW_WRITES=1. MCP для полного API вдобавок грузит офлайн-конверсии, звонки и расходы и работает как CLI.
Метрика вместе с Директом, Вебмастером и Wordstat
Маркетологу чаще нужна связка сервисов. yandex-direct-metrica-mcp сводит расходы Директа с визитами по меткам UTM и yclid, а итог выводит в HTML-дашборд. Его публичная сборка только читает. MCP для Метрики, Вебмастера, Директа и Wordstat обходится без сторонних библиотек и хранит токен в Keychain. Маркетплейс polyakov-claude-skills ставит скиллы Директа, Метрики, Вебмастера и Wordstat по одному.
Наборы шире рекламы тоже есть. YaAll публикует в npm десять серверов отдельными пакетами, например @theyahia/yandex-direct-mcp и @theyahia/appmetrica-mcp, а в целом от Директа и Метрики до Карт и SpeechKit. Marketplace плагинов Яндекса один раз проводит вход и раздает токен плагинам Метрики, Вебмастера, Wordstat, Диска и Календаря, а Яндекс Формы (Yandex Forms) в нем работают не полностью.
Для владельца магазина MCP-комбайн аналитики разворачивается воркером Cloudflare и сводит Метрику, Search Console, Wildberries и Ozon. Tilda MCP Server встраивает счетчик Метрики в собранный лендинг, но лицензия BSL запрещает коммерческое использование без согласия автора.
Как получить OAuth-токен Метрики
Приложение создают на oauth.yandex.ru с вариантом «Для доступа к API или отладки». Право metrika:read дает статистику и чтение настроек. С metrika:write агент создает счетчики и меняет их. Права на загрузку расходов, параметров посетителей и офлайн-данных отмечают отдельно, при metrika:write они уже не нужны. Для логина организации добавляют passport:business.
Токен выдает страница oauth.yandex.ru/authorize с response_type=token и ClientID, идентификатором приложения. API ждет заголовок Authorization: OAuth и токен. Автор сервера на Python отдельно пишет, что на префиксе Bearer спотыкаются другие реализации.
Регистрировать приложение не обязательно. Yandex Metrica MCP входит по PKCE и хранит токен около года, сервер со входом по коду обходится без адреса возврата.
npx skillfoxx add mcp/yandex-metrica-mcp
Уровень доступа и квоты API
Минимальный доступ у серверов, где пишущих вызовов нет в коде: Python-сервер на 12 инструментов, DuckDB и обертка скилла Полякова. Серверы только для чтения с готовыми отчетами получают расширенный уровень, потому что токен можно выпустить и с правом на изменения. Широкий доступ у серверов, которые удаляют счетчики. У MCP с управлением счетчиками удаление необратимо, а режима только для чтения нет. VPN этим серверам не нужен.
По документации с одного IP проходит 30 запросов в секунду, к Logs API 10. На пользователя приходится 3 параллельных запроса, 5000 в сутки и 200 запросов к отчетам за 5 минут. Сверх квоты API отвечает ошибкой 429. Суточный счетчик сбрасывается в 00:00 по Гринвичу.
Logs API выгружает сырые визиты посетителей, поэтому файлы выгрузки храните по своей политике приватности. Отчеты Метрики бывают семплированы, и Yandex Metrica MCP сообщает об этом модели.