О чём этот гайд? Короткий ответ
Короткий ответ: AI-скилл для анализа Яндекс.Метрики из Cursor и OpenClaw: API, OAuth, отчёты и логи без ручных выгрузок.
Yandex Metrika Assistant: AI-скилл для Cursor и OpenClaw
Прямая связь AI-агента с API Яндекс.Метрики: отчёты, логи и OAuth — по смыслу материала mayai.ru и открытого репозитория на GitHub.
Yandex Metrika Assistant — это skill (набор инструкций для агента), который подключает Cursor AI, OpenClaw и совместимые среды к API Яндекс.Метрики: Reporting API, Logs API и управление счётчиками через естественный язык. После установки навыка и OAuth-токена агент может запрашивать статистику, сегменты и сырые логи без ручных выгрузок. Смежная тема — вайбкодинг и агенты в Cursor.
Как агент работает с Яндекс.Метрикой?
Короткий ответ: Метрика даёт агенту фактические данные о трафике и поведении; навык переводит ваш запрос на русском в вызовы яндекс метрика api (отчёты, логи, цели).
В типовом сценарии агент смотрит, какие страницы и темы приносят визиты, сопоставляет это с задачами SEO/GEO и может предложить план контента — в том числе опираясь на смежные запросы из Wordstat, если подключены другие навыки.
Метрика — «глаза» агента: без доступа к API он гадает; с OAuth и skill он читает те же отчёты, что и вы в интерфейсе, но по запросу в диалоге.
Навык в связке OpenClaw и Метрики
Короткий ответ: визуально и по смыслу это связка агентской среды (например, OpenClaw) с API Метрики через один skill — агент получает те же данные, что доступны по ключу OAuth.
Ниже — иллюстрация из материала-источника: связка экосистемы OpenClaw с аналитикой Яндекса (промо-изображение страницы).
Что умеет навык: Reporting API и Logs API
Прямой ответ: навык закрывает отчёты (таблицы, динамика bytime, сегменты, drilldown), управление и логи (счётчики, цели, асинхронная выгрузка сырых логов), а также OAuth — инструкции по получению токена для scope Метрики.
| Область | Смысл для агента |
|---|---|
| Reporting API | Сводки, измерения, пресеты Метрики, фильтры и сравнение периодов. |
| Logs API | Создание выгрузки, ожидание, скачивание, очистка — полный цикл сырых данных. |
| Импорт / расходы | Направления импорта (расходы, CRM, офлайн) при наличии прав в приложении OAuth. |
Как установить скилл Яндекс Метрики в Cursor?
Короткий ответ: добавьте skill в Cursor (или совместимую среду) из GitHub/ClawHub, создайте OAuth-приложение на oauth.yandex.ru и передайте агенту токен с нужными scope — дальше запросы к API идут из диалога.
Установка сводится к подключению навыка из репозитория или каталога и выдаче агенту OAuth-токена с нужными правами для Метрики.
Подключить навык
Дайте агенту ссылку и попросите установить skill: репозиторий на GitHub или ClawHub.
Создать приложение OAuth
На oauth.yandex.ru создайте приложение типа «Для доступа к API», в блоке Метрики отметьте нужные scope (read/write, расходы, user_params, offline_data и т.д.), Redirect URI: https://oauth.yandex.ru/verification_code. Сохраните Client ID.
Получить токен и передать агенту
Подставьте Client ID в шаблон авторизации (см. блок ниже), откройте ссылку в браузере, скопируйте access_token и передайте агенту для работы с API.
Шаблон ссылки (подставьте свой Client ID вместо плейсхолдера):
https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID&redirect_uri=https%3A%2F%2Foauth.yandex.ru%2Fverification_code&scope=metrika%3Aread%20metrika%3Awrite%20metrika%3Aexpenses%20metrika%3Auser_params%20metrika%3Aoffline_data
Зачем AI-агенту доступ к Метрике?
Короткий ответ: чтобы агент опирался на реальные метрики сайта — визиты, страницы, цели и логи — а не на абстрактные советы без цифр.
Примеры сценариев из описания навыка: мониторинг страниц, реакция на просадку трафика, связка с Wordstat для «горячих» тем, анализ логов через Logs API, утренние сводки в мессенджер.
Данные в реальном времени
Видеть, что происходит с визитами и страницами, и предлагать правки контента под выдачу и AI Overviews.
Темы из Wordstat
Когда статья «стрельнула», агент может подобрать смежные запросы и план новых материалов.
Поведение и логи
Глубина, отказы, цели — основа для гипотез по страницам и воронкам.
Навыки агентов в редакторе — см. субагенты в Cursor; контекст по поиску — энциклопедия Яндекса.
Частые вопросы: что нужно знать?
Короткие ответы для сниппетов; детали — в открытом README на GitHub.
Безопасно ли передавать токен агенту?
Токен хранится у вас; права задаются при создании приложения. При компрометации токен можно отозвать в настройках OAuth Яндекса и выпустить новый.
Нужно ли уметь программировать?
Нет: вы формулируете задачу на русском, агент строит запросы к API Метрики сам — это в духе vibe coding и агентов.
С какими системами совместим навык?
Установка рассчитана на OpenClaw, Cursor AI и ряд других агентских сред; под капотом могут использоваться модели вроде GPT-4o или Claude — в зависимости от вашей среды.
Умеет ли агент выгружать сырые логи?
Да: в skill заложен цикл Logs API — create, poll, download, clean, чтобы не забивать квоты.
Создатель смыслового материала и канал: Telegram @maya_pro. Оригинальный проект кода: yandex-metrika-assistant (Horosheff). Материал на khar-ag.ru — адаптация по смыслу mayai.ru/metrika-skill/.