Яндекс.Метрика в руках ИИ-агента: трафик, цели, продажи
Плагин к приложению 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, любой другой или собственный скрипт
Как получить токен Яндекса
- Завести приложение на oauth.yandex.ru.
- В разделе «Яндекс.Метрика» отметить право metrika:read. Право на запись нужно только тем, кто собирается заводить счётчики через агента, — тогда добавьте и metrika:write.
- Получить токен по ссылке вида oauth.yandex.ru/authorize?response_type=token&client_id=… и вставить его в настройки плагина.
После сохранения токена в настройках появится список ваших счётчиков — выберите тот, с которым агент работает по умолчанию, и модель атрибуции.
Мы в социальных сетях
Узнавайте первыми о наших новых решениях и акциях.
- Вконтакте — https://vk.com/easyweb_su
- Телеграм — https://t.me/easyweb_su