Скилл для 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, код и кейсы
Сегодня пришёл новый проект на рекламу, нужно было оценить историю: какие каналы работали, где конверсии, что с органикой. Открыл Метрику и поймал себя на мысли, что делаю одно и то же в сотый раз: счётчики, цели, источники, помесячная разбивка. Упаковал рутину в скилл.
🔍 Что умеет
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, код и кейсы