SkillFoxx
Telegram

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

Yandex Metrika Assistant

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

  • 16 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

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

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

horosheff/yandex-metrika-assistantАвтор:Horosheff

Установка

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

npx skillfoxx add skills/yandex-metrika-assistant

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

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

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

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

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

Что делает

Репозиторий сделан как навык для 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, в остальных агентах удалите папку скилла из директории скиллов.

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

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

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

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

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

Обсуждение

Вопросов и отзывов пока нет.

Яндекс Метрика — все инструменты
Российский стек

Скилл Claude Code для Яндекс Метрики на bash-скриптах поверх curl: отчеты с пресетами, цели, счетчики и выгрузка сырых логов

СкиллРасширенный доступ1
Российский стек

Скилл, который выгружает из Яндекс Метрики реальные поисковые фразы с визитами, отказами и временем на сайте в CSV и Markdown

СкиллМинимальный доступ1
Российский стек

Плагин Claude Code с навыком Яндекс Метрики: трафик, конверсии, UTM, поисковики и расходы Директа с кешированием

ПлагинРасширенный доступ
Российский стек

Минималистичный MCP на Python: 12 инструментов только для чтения по правильному заголовку OAuth и парный скилл с методикой сравнения периодов

MCP-серверРасширенный доступ4

Альтернативы

Инструменты других авторов для тех же задач.

Коротко о README

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

Бейдж для README

Исходный 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 коротких вариантов с чего начать.

Сообщить о проблеме