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

Yandex Metrika Assistant

Скилл и сжатая документация по API Яндекс Метрики для агента: отчеты, Logs API, управление счетчиками, OAuth без утечки токена в чат

Скилл

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

Почему такой уровень

  • OAuth-токен может давать доступ на изменение счетчиков и целей, а не только чтение
  • Logs API выгружает сырые данные о посетителях сайта
Все причины и проверки
Российский стек

horosheff/yandex-metrika-assistant

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/yandex-metrika-assistant

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале в папке проекта

npx skills add horosheff/yandex-metrika-assistant --skill yandex-metrika-assistant -a claude-code -y

Утилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.

Выполните в терминале в папке проекта

npx skills add horosheff/yandex-metrika-assistant --skill yandex-metrika-assistant -a cursor -y

Утилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.

Выполните в терминале в папке проекта

npx skills add horosheff/yandex-metrika-assistant --skill yandex-metrika-assistant -a github-copilot -y

Утилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.

Выполните в терминале в папке проекта

npx skills add horosheff/yandex-metrika-assistant --skill yandex-metrika-assistant -a codex -y

Утилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.

Выполните в терминале в папке проекта

npx skills add horosheff/yandex-metrika-assistant --skill yandex-metrika-assistant -a gemini-cli -y

Утилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.

Выполните в терминале в папке проекта

npx skills add horosheff/yandex-metrika-assistant --skill yandex-metrika-assistant -a cline -y

Утилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.

Выполните в терминале в папке проекта

npx skills add horosheff/yandex-metrika-assistant --skill yandex-metrika-assistant -a roo -y

Утилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.

Форк Roo Code, папки .roo те же.

Выполните в терминале в папке проекта

npx skills add horosheff/yandex-metrika-assistant --skill yandex-metrika-assistant -a opencode -y

Утилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит c8f1667.

Текст для агента

Склонируй Horosheff/yandex-metrika-assistant, следуй docs/INSTALL-FOR-HUMANS-RU.md для получения OAuth-токена Метрики, сохрани его в переменную окружения YANDEX_METRIKA_OAUTH_TOKEN или в конфиг плагина OpenClaw и попроси агента показать список счетчиков.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий сделан как навык для OpenClaw, но внутри это SKILL.md с картой решений: какой endpoint API Метрики вызвать под конкретный запрос пользователя, как не перепутать счетчики визитов ym:s: и просмотров ym:pv:, где взять OAuth-токен и как не спросить его повторно, если он уже сохранен. Документация в docs/ сжато пересказывает официальный API: базовый URL и структура запросов, OAuth, квоты, Reporting API (stat), Logs API со сценарием создания и скачивания выгрузки, импорт данных и быстрый старт по управлению счетчиками. Матрица user-intents сопоставляет типовые формулировки пользователя («откуда трафик», «цели», «сравни периоды») с конкретными методами API.

Для кого. Для владельцев сайтов и маркетологов, которые хотят получать отчеты Метрики словами в чате, и для интеграторов OpenClaw.

Подходит, если

  • Нужны отчеты по трафику, целям и источникам без похода в интерфейс Метрики
  • Нужен сценарий выгрузки сырых данных через Logs API
  • Работаете в OpenClaw и хотите готовый плагин с конфигом токена

Не подходит, если

  • Нужна визуализация отчетов, а не текстовые ответы агента
  • Работаете не в OpenClaw: конфигурация токена через openclaw.plugin.json потребует адаптации

Пример запроса к агенту

Покажи визиты по дням за последние 7 дней и сводку по источникам трафика

Ограничения

Скилл спроектирован и протестирован под платформу OpenClaw с ее форматом плагина openclaw.plugin.json, для других агентов токен придется передавать через переменную окружения YANDEX_METRIKA_OAUTH_TOKEN вручную. Нужен OAuth-токен Яндекса с галочками доступа к Метрике: статистика, счетчики, при необходимости расходы и офлайн-данные. Автор явно просит не пересылать токен в Telegram.

Как отключить. В OpenClaw отключите плагин yandex-metrika-assistant, в остальных агентах удалите папку скилла из директории скиллов.

Проверка безопасности

  • OAuth-токен может давать доступ на изменение счетчиков и целей, а не только чтение
  • Logs API выгружает сырые данные о посетителях сайта

Коротко о README

README объясняет назначение репозитория: SKILL.md для выбора endpoint, сжатая справка по API в docs/ и манифест плагина OpenClaw с токеном и опциями. Описана аудитория (владельцы сайтов, разработчики автоматизации, интеграторы OpenClaw), возможности по отчетам, управлению и импорту, соответствие официальным требованиям OpenClaw к формату скиллов, примеры HTTP и PowerShell запросов и структура проекта. Указан канал поддержки в Telegram и просьба не пересылать токен туда.

SKILL.md

---
name: yandex-metrika-assistant
description: OpenClaw + Яндекс.Метрика API — stat/Logs/management, OAuth, presets, UTM, цели, CSV, квоты; плагин yandex-metrika-assistant.
homepage: https://github.com/Horosheff/yandex-metrika-assistant
---

# Яндекс.Метрика API — заточка под OpenClaw

Плагин: yandex-metrika-assistant (openclaw.plugin.json в этой папке).
Цель: ноль сюрпризов — сначала конфиг и секреты, потом правильный endpoint, без выдуманных метрик и без утечки токена.

## Онбординг человека (порядок ответов агента)

Если токена еще нет: дай ссылку на docs/INSTALL-FOR-HUMANS-RU.md, перечисли нужные галочки в приложении Яндекс OAuth, укажи канал поддержки и не проси токен в открытую.

После того как ключ добавлен: не проси продиктовать токен повторно, предложи 3-5 коротких вариантов с чего начать.

Частые вопросы

Работает не только в OpenClaw?

SKILL.md и документация универсальны, но конфигурация токена через плагин рассчитана на OpenClaw, для других агентов нужна переменная окружения.

Как агент отличает визиты от просмотров?

SKILL.md прямо указывает не путать счетчики ym:s: (визиты) и ym:pv: (просмотры) при выборе метрик.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12Звезды репозитория
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2Звезды репозитория
Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.Звезды репозитория

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.Звезды репозитория
Foxx AIАссистент Яндекс Метрики

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.