Яндекс.Метрика для приложения «MCP»

Яндекс.Метрика в руках ИИ-агента: трафик, цели, продажи

Плагин к приложению MCP открывает данные Яндекс.Метрики для ИИ-агентов по протоколу Model Context Protocol. Claude, Cursor или свой скрипт подключаются к сайту и разбирают статистику сами: откуда пришли люди, что они смотрели, где отвалились и сколько денег принёс каждый канал. Двадцать два инструмента: двадцать один только читает, двадцать второй заводит счётчик.

Посещаемость

Визиты, посетители, просмотры, отказы, глубина и время на сайте за период — сразу со сравнением с предыдущим таким же периодом. Плюс динамика по дням, неделям или месяцам.

Источники и страницы

Типы переходов, поисковые фразы, сайты-источники и рекламные кампании по UTM. Самые просматриваемые страницы и страницы входа — с долей отказов по каждой.

Цели и аудитория

Конверсии сразу по всем целям счётчика одним вызовом, при желании в разрезе источников. География, устройства, браузеры, пол и возраст посетителей.

Продажи

Покупки, выручка, средний чек и конверсия в покупку. Что покупают — по товарам, категориям и брендам. Какой канал приносит деньги, а не только визиты. Брошенные корзины.

Менять плагин почти ничего не умеет — и это осознанно

В API Метрики есть создание и правка счётчиков, целей, сегментов и фильтров. Из всего этого в плагине только одно — завести новый счётчик. Остальное осталось за бортом намеренно.

Цель или фильтр, заведённые ассистентом по неудачно понятой фразе, тихо испортят статистику на месяцы вперёд, и заметят это не сразу. А новый счётчик — операция, которая ничего не портит: он просто появляется в аккаунте, и данные по нему пойдут, только когда код поставят на сайт.

Создание счётчика лежит в отдельной группе прав и требует подтверждения прямо в вызове: без него агент получает отказ. Для чтения токену Яндекса хватает права metrika:read, право на запись нужно только этому одному инструменту.

Вы решаете, что агенту можно

У каждого инструмента своё право, права собраны в четыре группы. Выдавая токен в приложении MCP, вы отмечаете нужные — и агент физически не видит остальных инструментов.

• Отчёты — шестнадцать инструментов: посещаемость, источники, страницы, аудитория, цели
• Продажи — четыре инструмента электронной коммерции: их выдают отдельно, это данные о деньгах
• Произвольный отчёт — один инструмент для любых метрик и измерений, тоже отдельным правом
• Управление — создание счётчика, единственная операция, которая что-то заводит в Метрике

Ассистенту не нужно знать язык Метрики

В API Метрики почти всё — один ресурс, которому передают метрики и измерения вида ym:s:visits и ym:s:lastsignTrafficSource. Модель, которой приходится собирать такой запрос с нуля, ошибается в именах, путает пространства имён и молча получает пустой ответ.

Поэтому частые отчёты собраны готовыми инструментами: «источники трафика», «страницы входа», «что покупают». Счётчик берётся из настроек, период по умолчанию — последние 30 дней. «Как дела с трафиком» работает вызовом без единого аргумента.

А когда нужен срез, которого в списке нет, остаётся metrika_query: любые метрики и измерения по справочнику API. Потолка у плагина нет.

Агент знает подводные камни Метрики

Вместе с инструментами плагин отдаёт агенту страницу документации — MCP-клиент читает её сам. В ней ровно то, обо что спотыкаются модели:

• визиты, посетители и просмотры — разные величины, и метрики просмотров не смешиваются с метриками визитов
• модель атрибуции меняет отчёт по источникам до неузнаваемости — и объясняет расхождения с чужими цифрами
• средний чек и брошенная корзина в API отсутствуют, их надо считать — плагин считает сам
• границы «вчера» — по часовому поясу счётчика, а не сервера

Отказы плагин тоже переводит на человеческий: «токен отозван», «нет доступа к счётчику», «превышен лимит запросов, сократите период» — вместо кода ошибки, по которому агент начинает гадать.

Что нужно для работы

• приложение MCP версии 1.3.0 или новее — оно держит сервер и токены
• OAuth-токен Яндекса с правом metrika:read; для создания счётчиков — ещё и metrika:write
• исходящий HTTPS к api-metrika.yandex.net — ни Node, ни cron, ни своих таблиц в базе плагин не требует
• MCP-клиент: Claude Desktop, Cursor, любой другой или собственный скрипт

Как получить токен Яндекса

1. Завести приложение на oauth.yandex.ru.
2. В разделе «Яндекс.Метрика» отметить право metrika:read. Право на запись нужно только тем, кто собирается заводить счётчики через агента, — тогда добавьте и metrika:write.
3. Получить токен по ссылке вида oauth.yandex.ru/authorize?response_type=token&client_id=… и вставить его в настройки плагина.

После сохранения токена в настройках появится список ваших счётчиков — выберите тот, с которым агент работает по умолчанию, и модель атрибуции.

Мы в социальных сетях

Узнавайте первыми о наших новых решениях и акциях.

• Вконтакте — https://vk.com/easyweb_su
• Телеграм — https://t.me/easyweb_su