yandex-metrika-assistant

KO | EN

gitlite — search

#javascript #python #ai #golang #go #machine-learning #linux #nodejs #macos #java #windows #mcp #openai #open-source

yandex-metrika-assistant

(★ 14)

OpenClaw skill: Yandex Metrica API (stat, Logs, OAuth). RU docs, AI agents. Telegram: @maya_pro

yandex-metrika-assistant Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Yandex Metrika × OpenClaw Skill — обложка репозитория](https://raw.githubusercontent.com/Horosheff/yandex-metrika-assistant/main/OpenClaw-Yandex-Metrika.png)](./OpenClaw-Yandex-Metrika.png)

# Yandex Metrika Assistant

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

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/Horosheff/yandex-metrika-assistant/main/LICENSE)
[![API Docs](https://img.shields.io/badge/API-Яндекс.Метрика-red)](https://yandex.ru/dev/metrika)
[![Telegram](https://img.shields.io/badge/Telegram-@maya_pro-26A5E4?logo=telegram)](https://t.me/maya_pro)

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

</div>

---

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

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

### [docs/INSTALL-FOR-HUMANS-RU.md](./docs/INSTALL-FOR-HUMANS-RU.md)

**Поддержка:** [Telegram @maya_pro](https://t.me/maya_pro) — вопросы по установке, OpenClaw, автоматизации и нейросетям.

---

## Содержание

- [Установка для человека](#установка-для-человека--начните-здесь)
- [Зачем этот репозиторий](#зачем-этот-репозиторий)
- [Кому подойдёт](#кому-подойдёт)
- [Что умеет навык](#что-умеет-навык)
- [Соответствие OpenClaw](#соответствие-openclaw)
- [Быстрый старт](#быстрый-старт)
- [Примеры применения](#примеры-применения)
- [Примеры HTTP и PowerShell](#примеры-http-и-powershell)
- [Структура проекта](#структура-проекта)
- [Конфигурация плагина](#конфигурация-плагина)
- [Безопасность](#безопасность)
- [Ссылки](#ссылки)

---

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

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

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

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

---

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

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

---

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

<details>
<summary><strong>Отчёты (Reporting API)</strong></summary>

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

</details>

<details>
<summary><strong>Управление и Logs</strong></summary>

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

</details>

<details>
<summary><strong>Импорт и токены</strong></summary>

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

</details>

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

---

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

Проверено по официальным разделам [**Skills**](https://docs.openclaw.ai/tools/skills#skills) и [**Plugin manifest**](https://docs.openclaw.ai/plugins/manifest):

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

**Где класть файлы** (приоритет из [доки](https://docs.openclaw.ai/tools/skills#skills)):

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

Альтернатива: `openclaw skills install …` — установка в активный workspace `skills/` ([ClawHub / CLI](https://docs.openclaw.ai/tools/clawhub)).

---

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

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

1. **Клонируйте** репозиторий (или скопируйте папку в каталог навыков OpenClaw):

```bash
   git clone https://github.com/Horosheff/yandex-metrika-assistant.git
   ```

2. Установите плагин, например: `openclaw plugins install ./yandex-metrika-assistant` (или путь к клону), включите **`yandex-metrika-assistant`** в `plugins.entries`. В манифесте объявлено **`skills": ["."]`**, чтобы OpenClaw подгрузил этот же каталог как навык.

3. В конфиге плагина задайте **`oauthToken`**. Опционально: **`defaultCounterId`**, **`oauthClientId`**.

4. Перезапустите gateway при необходимости (`openclaw gateway restart`). Новая сессия агента подхватит навык из снимка skills.

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

Токен для людей: [`docs/INSTRUCTION-GET-TOKEN-RU.md`](./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`](./docs/INSTRUCTION-GET-TOKEN-RU.md). |

Больше формулировок («UTM», «Директ», «цели», география…) — в [**матрице намерений**](./docs/10-user-intents-matrix.md).

---

## Примеры HTTP и PowerShell

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

**[docs/EXAMPLES.md](./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`](./openclaw.plugin.json).

---

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

- Не коммитьте токены, не вставляйте их в issue и публичные чаты.
- При утечке — отзовите токен в [Яндекс OAuth](https://oauth.yandex.ru/) и выпустите новый.
- В репозитории учтён [`.gitignore`](./.gitignore) для типичных файлов с секретами.

---

## Ссылки

| Ресурс | URL |
|--------|-----|
| Установка для человека | [INSTALL-FOR-HUMANS-RU.md](./docs/INSTALL-FOR-HUMANS-RU.md) |
| Поддержка (Telegram) | [**https://t.me/maya_pro**](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**](https://t.me/maya_pro) |

---

## Лицензия

Проект распространяется под лицензией **MIT** — см. файл [LICENSE](./LICENSE).

---

Если репозиторий полезен — можно поставить звезду на GitHub и заглянуть в [**@maya_pro**](https://t.me/maya_pro).

</div>

yandex-metrika-assistant

yandex-metrika-assistant Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

yandex-metrika-assistant

yandex-metrika-assistant Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README