Плагин «Яндекс.Метрика» для MCP

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

Отчёты и продажи Яндекс.Метрики для ИИ-агента

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

Плагин к приложению 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