Скилл для Claude: аудит трафика через Яндекс.Метрику

Сегодня пришёл новый проект на рекламу, нужно было оценить историю: какие каналы работали, где конверсии, что с органикой. Открыл Метрику и поймал себя на мысли, что делаю одно и то же в сотый раз: счётчики, цели, источники, помесячная разбивка. Упаковал рутину в скилл.

🔍 Что умеет

8 скриптов, которые покрывают базовый аудит: список счётчиков, метаданные, цели, трафик по источникам, конверсии по целям, UTM-разбивка, поисковые системы. Плюс произвольные отчёты через любые метрики из API (пока не проверял).

Claude получает промпт вида «оцени статистику яндекс метрики — что работает, что нет», сам подключается к Метрике собирает данные и выдаёт анализ.

🧩 Минутка извращений: кеш для экономии контекстного окна

Главная проблема скиллов, где скрипты + внешнее API — они засоряют контекстное окно. Каждый ответ API может занять тысячи токенов. Поэтому:

🔸 Счётчики, цели и метаданные кешируются в TSV/JSON и переиспользуются между запросами
🔸 Отчёты кешируются по хешу параметров (counter + даты + фильтры). Повторный запрос за тот же период не тратит ни токенов, ни квоту API
🔸 Вывод ограничен 30 строками — полные данные уходят в CSV, а Claude видит только шапку
🔸 Если date2 = сегодня, кеш пропускается — данные ещё копятся

💡 Принцип: скилл должен экономить контекстное окно так же, как код экономит память. Чем меньше мусора в контексте — тем точнее анализ.

⚙️ Детали реализации

🔸 По умолчанию без сэмплирования
🔸 Фильтр isRobot='No' по дефолту, хотя может быть в эру агентной коммерции, пора отключать
🔸 Автоматический ретрай при 429 с Retry-After + случайный jitter
🔸 Скилл работает в любом окружении, включая контейнеры Claude
🔸 Схема работы: счётчики → выбор проекта → цели → выбор конверсионных → сохранение конфига → отчёты

📊 Пример из первого аудита

На новом проекте Claude за 3 минуты собрал картину, которую вручную я ковырял бы минут 30: реклама в Директе приносила трафик, но почти без конверсий — 95% шло на главную без посадочных. Зато органика выросла в 11 раз за полгода с конверсией 3-8%. Прямой трафик оказался эффективнее рекламного в десятки раз.

Один промпт и сразу отчет.

🔗 Как подключить

Нужен OAuth-токен Яндекса с правом metrika:read. Настройка проще, чем у скилла Вордстата — инструкция в README.

Код: GitHub

API Метрики большая — пока реализованы базовые отчёты. Кто хочет добавить экспертизы — приходите в личку или в PR. Хочется сделать функцональный скилл.

----

Поляков считает — AI, код и кейсы