Яндекс.Метрика в руках ИИ-агента: трафик, цели, продажи
Плагин к приложению MCP открывает данные Яндекс.Метрики для ИИ-агентов по протоколу Model Context Protocol. Claude, Cursor или свой скрипт подключаются к сайту и разбирают статистику сами: откуда пришли люди, что они смотрели, где отвалились и сколько денег принёс каждый канал. Двадцать семь инструментов: двадцать два только читают, пять пишут — заводят счётчики, цели и фильтры, включают Вебвизор, удаляют цели, — и каждый из них просит подтверждения.
Посещаемость
Визиты, посетители, просмотры, отказы, глубина и время на сайте за период — сразу со сравнением с предыдущим таким же периодом. Плюс динамика по дням, неделям или месяцам.
Источники и страницы
Типы переходов, поисковые фразы, сайты-источники и рекламные кампании по UTM. Самые просматриваемые страницы и страницы входа — с долей отказов по каждой.
Цели и аудитория
Конверсии сразу по всем целям счётчика одним вызовом, при желании в разрезе источников. География, устройства, браузеры, пол и возраст посетителей. А ещё настройка самого счётчика — фильтры визитов, операции над адресами, цели и выданные доступы: можно ли вообще верить его цифрам.
Продажи
Покупки, выручка, средний чек и конверсия в покупку. Что покупают — по товарам, категориям и брендам. Какой канал приносит деньги, а не только визиты. Брошенные корзины.
Менять плагин умеет немного — и только с подтверждением
В API Метрики есть создание и правка счётчиков, целей, сегментов и фильтров. В плагин из этого вошли пять операций, которые действительно нужны при заведении сайта: создать счётчик, включить Вебвизор, создать цель, удалить цель и создать фильтр визитов. Другой правки существующих счётчиков, целей и фильтров нет, сегменты плагин не трогает.
- Счётчик — новый, с названием и доменом сайта, при желании сразу с Вебвизором. Код счётчика на сайт ставится отдельно, руками.
- Вебвизор — включить или выключить у уже работающего счётчика. Записи пойдут, когда и код на сайте вызывается с Вебвизором.
- Цель — посещение страницы или JavaScript-событие, при желании с ценностью. Составные цели, звонки и формы остаются за интерфейсом Метрики.
- Фильтр — не учитывать или учитывать только визиты по заголовку страницы, адресу или IP. Типичная задача — отсечь свои визиты.
Цель или фильтр, заведённые по неудачно понятой фразе, тихо испортят статистику, и заметят это не сразу. Поэтому все пять инструментов лежат в отдельной группе прав, и каждый требует подтверждения прямо в вызове: без него агент получает отказ с объяснением, что произойдёт, и в Метрику ничего не уходит.
Удаление цели защищено вдвойне: кроме подтверждения агент должен назвать цель точно. Плагин сверяет название с тем, что лежит в счётчике под этим номером, и при расхождении ничего не удаляет — перепутанный номер не унесёт статистику чужой цели.
Вы решаете, что агенту можно
У каждого инструмента своё право, права собраны в четыре группы. Выдавая токен в приложении 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















