Инструменты MCP
Обновлено
Права на инструменты
В приложении MCP права плагина собраны в блок «Яндекс.Метрика». У каждого инструмента отдельное право с тем же техническим именем, что и у инструмента.
| Группа | Идентификатор | Состав |
|---|---|---|
| Отчёты | metrika.read |
17 инструментов чтения статистики и справочников |
| Продажи | metrika.ecommerce |
Четыре отчёта электронной коммерции |
| Произвольный отчёт | metrika.raw |
metrika_query для собственных срезов |
| Управление | metrika.manage |
Четыре операции записи с подтверждением |
Группы объединяют права для выбора в MCP. Дополнительно API проверяет доступ OAuth-токена Яндекса.
В блоке прав показаны отчёты о продажах, произвольный отчёт и отдельные инструменты управления.
Отчёты
| Имя инструмента | Право в интерфейсе | Назначение |
|---|---|---|
metrika_get_counters |
Список счётчиков | Счётчики, доступные владельцу токена: номер, название, сайт и состояние. |
metrika_get_counter_info |
Информация о счётчике | Паспорт счётчика: сайт, часовой пояс, состояние, включена ли электронная коммерция. |
metrika_get_counter_setup |
Настройка счётчика | Фильтры визитов, операции над адресами, цели и выданные доступы — то, чем проверяют, можно ли верить цифрам счётчика. |
metrika_get_goals |
Цели счётчика | Список целей с их номерами и типами — по ним считаются конверсии. |
metrika_get_segments |
Сегменты счётчика | Сохранённые сегменты и их выражения для подстановки в фильтр отчёта. |
metrika_get_visits_summary |
Сводка посещаемости | Визиты, посетители, просмотры, отказы, глубина и время на сайте за период со сравнением с предыдущим. |
metrika_get_visits_by_time |
Динамика посещаемости | Ряды визитов, посетителей и просмотров по дням, неделям или месяцам. |
metrika_get_traffic_sources |
Источники трафика | Откуда приходят посетители: поиск, реклама, соцсети, прямые заходы. |
metrika_get_search_phrases |
Поисковые фразы | Фразы, по которым посетители приходили из поисковых систем. |
metrika_get_referrers |
Сайты-источники | Домены, с которых приходили по ссылкам. |
metrika_get_ad_campaigns |
Рекламные кампании | Переходы с UTM-метками в разрезе кампании, источника, канала или ключевого слова. |
metrika_get_popular_pages |
Популярные страницы | Самые просматриваемые адреса сайта за период. |
metrika_get_landing_pages |
Страницы входа | С каких страниц начинались визиты и какая у них доля отказов. |
metrika_get_geo |
География | Страны, области или города посетителей. |
metrika_get_devices |
Устройства и браузеры | Чем смотрят сайт: тип устройства, браузер, операционная система, формат экрана. |
metrika_get_demographics |
Пол и возраст | Демография аудитории — определяется Метрикой не для всех посетителей. |
metrika_get_goal_conversions |
Конверсии по целям | Достижения целей и процент конверсии за период, при желании в разрезе источников. |
Продажи
| Имя инструмента | Право в интерфейсе | Назначение |
|---|---|---|
metrika_get_ecommerce_summary |
Сводка продаж | Покупки, выручка, средний чек и конверсия в покупку за период. Отдельное право: это данные о деньгах. |
metrika_get_top_products |
Что покупают | Товары, категории или бренды с количеством и выручкой. |
metrika_get_revenue_by_source |
Выручка по источникам | Какой канал приносит деньги, а не только визиты. |
metrika_get_cart_abandonment |
Брошенные корзины | Что кладут в корзину, но не покупают, и какая доля остаётся не купленной. |
Произвольный отчёт
| Имя инструмента | Право в интерфейсе | Назначение |
|---|---|---|
metrika_query |
Произвольный отчёт | Любые метрики и измерения Метрики по справочнику API. Выдавайте, когда ассистенту нужны срезы за пределами готовых отчётов. |
Управление
| Имя инструмента | Право в интерфейсе | Назначение |
|---|---|---|
metrika_create_counter |
Создать счётчик | Завести новый счётчик для сайта. Требует подтверждения в вызове и права metrika:write у токена Яндекса. |
metrika_create_goal |
Создать цель | Завести цель счётчика: посещение страницы или JavaScript-событие, при желании с ценностью достижения. Требует подтверждения в вызове. |
metrika_delete_goal |
Удалить цель | Удалить цель счётчика. Необратимо — статистика по цели пропадает из отчётов за всё время. Требует подтверждения и точного названия цели. |
metrika_create_filter |
Создать фильтр | Создать фильтр визитов счётчика: не учитывать (или учитывать только) визиты по заголовку страницы, адресу или IP. Требует подтверждения в вызове. |
Примеры просьб к агенту
Сравни посещаемость за сентябрь 2026 года с августом.
Покажи источники трафика за сентябрь с атрибуцией «Последний значимый переход».
Найди страницы входа с большим числом визитов и высокой долей отказов.
Покажи визиты по городам и отдельно по типам устройств за сентябрь.
Покажи цели и конверсии. Если часть целей не поместилась, запроси их отдельно.
Сравни выручку по источникам и по UTM-кампаниям за сентябрь в рублях.
Проверь фильтры, операции над адресами и доступы к счётчику.Это примеры задач, а не фиксированные команды интерфейса. Агент выбирает инструменты и параметры из доступных ему схем. Для конкретного периода указывайте даты явно.
Агент выводит таблицу целей с типами, числом достижений и конверсией за 30 дней.
Дополнительные срезы
| Инструмент | Аргумент и варианты |
|---|---|
metrika_get_visits_by_time |
group: day (по умолчанию), week, month |
metrika_get_ad_campaigns |
breakdown: campaign (по умолчанию), source, medium, term, content — соответствующие UTM-метки |
metrika_get_geo |
breakdown: city (по умолчанию), country, region |
metrika_get_devices |
breakdown: device (по умолчанию), browser, os, resolution |
metrika_get_demographics |
breakdown: age (по умолчанию), gender |
metrika_get_top_products |
breakdown: product (по умолчанию), category — первый уровень категории, brand |
metrika_get_revenue_by_source |
breakdown: source (по умолчанию), campaign |
metrika_get_goal_conversions |
goal_id — конкретная цель; breakdown: none (по умолчанию), source — вместе с goal_id |
Без goal_id конверсии рассчитываются максимум по девяти целям. Остальные перечисляются в skipped_goals; их нужно запросить по одной с goal_id.
Операции записи подробно описаны в статье об управлении, периоды и произвольные запросы — в статье об отчётах.
Справочные материалы для агента
Плагин регистрирует два навыка MCP в группе «Яндекс.Метрика»:
metrika-basics— «Метрика: сценарии и подводные камни»;metrika-benchmarks— «Метрика: нормы и что считать проблемой».
Их получение и использование зависит от MCP-клиента. Первый материал описывает отчёты и особенности API, второй — ориентиры для интерпретации показателей. Эти материалы не добавляют новые инструменты и не изменяют настройки сайта.