⏳ 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).

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

Adopt or update this skill from https://proskills.md/skills/other/russkih75-ctrl-yandex-metrika-assistant. First identify the installation path supported by this platform, detect whether it is already installed, compare the installed version with the latest stable release, show me what will change, and only then install or update it. If no native installer is available, use the complete package or source fallback described on the page.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars

⭐ 0 on GitHubGitHub ↗

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