⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

yandex-metrika-assistant

@russkih75-ctrl⭐ 0 stars

OpenClaw + Яндекс.Метрика API — stat/Logs/management, OAuth, presets, UTM, цели, CSV, квоты; плагин yandex-metrika-assistant. Автор: Андрей Русских (wordprais.ru).

—/10

// RATINGS

⭐GitHub Stars

⭐ 0GitHub ↗

New / niche

🟢ProSkills Score

—

📍

Not yet listed on ClawHub or SkillsMP

// README

Yandex Metrika Assistant

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

Автор: Андрей Русских — WordPress, SEO/GEO · wordprais.ru · @wordprais · Instagram

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

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

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

docs/INSTALL-FOR-HUMANS-RU.md

Поддержка: Telegram @wordprais · Instagram @wordprais — вопросы по установке, 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 и секретам.

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

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

Список счётчиков, цели, типовые 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/russkih75-ctrl/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

// HOW IT'S BUILT

KEY FILES

SKILL.mdREADME.md

// REPO STATS

0 stars

// SHARE

Share on X Share on LinkedIn

// SOURCE

View on GitHub

// ACTIONS

Rate this skill

// SCORE

Pending review

// DETAILS

Categoryother

Author@russkih75-ctrl

Versionversion unknown

PriceFree