Community Скиллы Российские сервисы

Ассистент Яндекс Метрики

Универсальное

Установка

git clone (см. README)

Описание

yandex-metrika-assistant — скилл со сжатой документацией API Яндекс Метрики для агента: запросы отчётов — стандартные и сводные, Logs API — сырые хиты без семплирования, управление счётчиками и целями, OAuth-авторизация и токены, компактный формат — агент быстро находит нужный метод вместо чтения полного справочника. Для аналитиков и разработчиков, выгружающих данные Метрики через ИИ-агентов.

Что умеет:
— строить отчёты и работать с Logs API;
— управлять счётчиками и целями;
— настраивать OAuth-доступ;
— сокращать путь к нужному методу.

Полная документация ниже — автоматически из репозитория horosheff/yandex-metrika-assistant (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.

Yandex Metrika Assistant

Навык OpenClaw + документация для API Яндекс.Метрики

Отчёты · Logs · Счётчики и цели · OAuth · Сценарии для нейросети

Установка для человека — начните здесь

Полная пошаговая инструкция (OpenClaw → приложение OAuth → галочки Метрике → токен → что спросить агенту после ключа):

docs/INSTALL-FOR-HUMANS-RU.md

Поддержка: Telegram @maya_pro — вопросы по установке, OpenClaw, автоматизации и нейросетям.

Зачем этот репозиторий

Репозиторий объединяет:

Компонент	Назначение
`SKILL.md`	Как нейросети (OpenClaw) выбирать endpoint, не путать `ym:s:` / `ym:pv:`, работать с секретами и квотами
`docs/`	Сжатая справка по официальному API: OAuth, квоты, stat, logs, импорт, management
`openclaw.plugin.json`	Контракт плагина: токен и опции в одном месте

Официальный источник правды по API: yandex.ru/dev/metrika.

Кому подойдёт

Владельцам сайтов и маркетологам, которые хотят спрашивать Метрику у AI в осмысленной форме.
Разработчикам автоматизации (Make.com, сценарии, cron) — готовые паттерны запросов.
Интеграторам OpenClaw / агентов с доступом к shell и секретам.

Что умеет навык

Отчёты (Reporting API)

Таблицы GET /stat/v1/data, динамика bytime, сравнение сегментов, drilldown.
Пресеты (preset=) как в веб-интерфейсе Метрики.
Сегментация через filters, лимиты метрик/группировок из доки.

Управление и Logs

Список счётчиков, цели, типовые management-операции.
Сценарий Logs API: создание выгрузки → статус → скачивание → clean.

Импорт и токены

Направления импорта (расходы, CRM, офлайн и т.д.) со ссылками на методы.
Инструкция получения OAuth-токена на русском + скрипт обмена code → token.

Матрица «как спросили человеком → какой API»: docs/10-user-intents-matrix.md.

Соответствие OpenClaw

Проверено по официальным разделам Skills и Plugin manifest:

Требование документации	Как сделано в репозитории
Навык = каталог с `SKILL.md` и YAML frontmatter	Корень репозитория (или `skills/yandex-metrika-assistant/` в workspace)
Frontmatter: `name`, `description`; парсер — однострочные значения	`description` — одна строка; без многострочного `>-`
Пути к файлам навыка	В тексте `SKILL.md` используется `{baseDir}/docs/...` и `{baseDir}/scripts/...` (как в доке)
Плагин подгружает навыки	В `openclaw.plugin.json` указано `"skills": ["."]` (корень плагина = корень навыка)
`configSchema` у плагина	Задан JSON Schema для `oauthToken`, `defaultCounterId`, `oauthClientId`
Подсказки UI для секретов	`uiHints` для полей конфига (`sensitive` для токена)

Где класть файлы (приоритет из доки):

Workspace агента: /skills/<имя>/ — высший приоритет для своих навыков.
Или: ~/.openclaw/skills — общие навыки на машине.
Плагин: после openclaw plugins install ./yandex-metrika-assistant навык подхватывается из манифеста, если плагин включён в plugins.entries.

Альтернатива: openclaw skills install … — установка в активный workspace skills/ (ClawHub / CLI).

Быстрый старт

flowchart LR
  A[Клонировать репозиторий] --> B[Подключить плагин OpenClaw]
  B --> C[Задать oauthToken]
  C --> D[Подключить SKILL к агенту]
  D --> E[Спрашивать Метрику в чате]

Клонируйте репозиторий (или скопируйте папку в каталог навыков OpenClaw):
```
git clone https://github.com/Horosheff/yandex-metrika-assistant.git
```
Установите плагин, например: openclaw plugins install ./yandex-metrika-assistant (или путь к клону), включите yandex-metrika-assistant в plugins.entries. В манифесте объявлено skills": ["."], чтобы OpenClaw подгрузил этот же каталог как навык.
В конфиге плагина задайте oauthToken. Опционально: defaultCounterId, oauthClientId.
Перезапустите gateway при необходимости (openclaw gateway restart). Новая сессия агента подхватит навык из снимка skills.

Альтернатива: переменная окружения YANDEX_METRIKA_OAUTH_TOKEN (если ваш хост OpenClaw так устроен).

Токен для людей: docs/INSTRUCTION-GET-TOKEN-RU.md.

Примеры применения

Ниже — не код, а сценарии: что пишет пользователь и как должен вести себя агент с подключённым навыком.

#	Вы спрашиваете	Что делает агент
1	«Покажи визиты по дням за последний месяц по сайту X»	Находит счётчик (`search_string` или `defaultCounterId`), дергает `stat/v1/data` с `dimensions=ym:s:date`, выводит таблицу по дням.
2	«На какие страницы больше всего заходят?»	Запрос с префиксом `ym:pv:`: URL + просмотры, сортировка по убыванию, топ N.
3	«Откуда трафик, сводка по источникам»	`preset=sources_summary` или явные dimensions по источникам из справочника.
4	«Сравни мобильный и десктоп за неделю»	Метод сравнения сегментов `/stat/v1/data/comparison` (см. официальные примеры).
5	«Выгрузи отчёт в Excel»	Подсказывает запрос к `.../stat/v1/data.csv?...` с нужными параметрами.
6	«Нужны сырые логи визитов»	Объясняет цикл Logs API (create → poll → download → clean), ссылка на `docs/06-logs-api.md`.
7	«Как получить API-ключ?»	Объясняет, что нужен OAuth access_token, даёт `INSTRUCTION-GET-TOKEN-RU.md`.

Больше формулировок («UTM», «Директ», «цели», география…) — в матрице намерений.

Примеры HTTP и PowerShell

Готовые команды curl и настройка $env: — в отдельном файле:

docs/EXAMPLES.md — счётчики, визиты по дням, топ URL, preset, CSV.

Структура проекта

yandex-metrika-assistant/
├── SKILL.md                 # Поведение агента OpenClaw
├── openclaw.plugin.json     # id, name, configSchema
├── README.md                # Вы здесь
├── LICENSE
├── .gitignore
├── scripts/
│   └── exchange-yandex-oauth-code.ps1
└── docs/
    ├── INSTALL-FOR-HUMANS-RU.md  # Порядок установки + OAuth + TG + «с чего начать»
    ├── OPENCLAW-AGENT.md    # Для агента: HOOK.md не нужен; кавычки PowerShell
    ├── EXAMPLES.md          # Примеры curl / PowerShell
    ├── INSTRUCTION-GET-TOKEN-RU.md
    ├── 10-user-intents-matrix.md
    └── 01 … 09 …            # Разделы API (ссылки и выжимки)

Конфигурация плагина

Поле	Тип	Зачем
`oauthToken`	string	Access token Яндекса (`metrika:read` / `metrika:write`)
`defaultCounterId`	integer	Подставлять `ids`, если пользователь не назвал счётчик
`oauthClientId`	string	Собрать ссылку авторизации, если токена ещё нет

Схема в JSON: openclaw.plugin.json.

Безопасность

Не коммитьте токены, не вставляйте их в issue и публичные чаты.
При утечке — отзовите токен в Яндекс OAuth и выпустите новый.
В репозитории учтён .gitignore для типичных файлов с секретами.

Ссылки

Ресурс	URL
Установка для человека	INSTALL-FOR-HUMANS-RU.md
Поддержка (Telegram)	https://t.me/maya_pro
Документация API Метрики	https://yandex.ru/dev/metrika
Примеры отчётов	https://yandex.ru/dev/metrika/ru/stat/examples
Шаблоны отчётов (preset)	https://yandex.ru/dev/metrika/ru/stat/presets
Telegram: автоматизация и нейросети	https://t.me/maya_pro

Лицензия

Проект распространяется под лицензией MIT — см. файл LICENSE.

Если репозиторий полезен — можно поставить звезду на GitHub и заглянуть в @maya_pro.