Скилл Яндекс Метрики на bash-скриптах

Yandex Metrica Skill for Claude Code

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

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

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

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

  • Читает данные о трафике и конверсиях, включая коммерчески чувствительную статистику
  • Токен запрашивается с правом metrika:write, хотя README описывает только отчетные сценарии
Все причины и проверки
Российский стек

elsvv/yandex-metrica-skill

Установка

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

npx skillfoxx add skills/yandex-metrica-skill-for-claude-code

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

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

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

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

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

  • Читает данные о трафике и конверсиях, включая коммерчески чувствительную статистику
  • Токен запрашивается с правом metrika:write, хотя README описывает только отчетные сценарии

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

Что делает

Скилл дает Claude Code набор bash-скриптов поверх curl для API Яндекс Метрики. check_connection.sh проверяет токен и выводит список счетчиков, counters.sh работает со счетчиками, stats.sh строит отчеты либо по готовым пресетам traffic, sources, geo, content, technology, либо по произвольным метрикам, измерениям и датам, goals.sh читает цели, а logs.sh проводит полный цикл Logs API: оценка объема, создание запроса, скачивание многочастевого файла и очистка обработанных логов. Покрытие описано и для Management API: счетчики, цели, фильтры, операции, права, метки, сегменты, пользовательские параметры. Скрипты рассчитаны на запуск строго через bash с абсолютными путями, а не через source из zsh.

Для кого. Для тех, кто хочет получать отчеты Яндекс Метрики прямо в Claude Code без отдельного MCP-сервера, через простые bash-скрипты.

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

  • Нужны быстрые пресеты отчетов по трафику, источникам, географии, контенту или технологиям
  • Нужна выгрузка сырых логов визитов через Logs API
  • Предпочитаете легкий скилл на bash и curl вместо запуска отдельного MCP-сервера

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

  • Нужна работа на Windows без bash: скрипты рассчитаны на unix-окружение
  • Нет curl, jq и python3 в системе: они нужны для запросов, форматированного вывода и кодирования URL в фильтрах

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

Покажи отчет по источникам трафика для счетчика 12345678 за январь

Ограничения

Лицензия в метаданных репозитория не указана явно, хотя README упоминает MIT. Требуются curl, jq и python3 в системе. Токен запрашивается с правами metrika:read и metrika:write, хотя сами скрипты в README описаны как отчетные и не показывают явных изменяющих вызовов. Скрипты нужно запускать строго через bash с абсолютными путями.

Как отключить. Удалите папку скилла из ~/.claude/skills/yandex-metrica и отзовите OAuth-токен на oauth.yandex.ru.

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

Есть ли готовые пресеты отчетов?

Да, stats.sh поддерживает пресеты traffic, sources, geo, content и technology, а также произвольные метрики и измерения.

Можно ли выгрузить сырые данные визитов?

Да, logs.sh проводит полный цикл Logs API: оценку объема, создание запроса, скачивание многочастевого файла и очистку обработанных логов.

Обсуждение

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

Российский стек

Пять cache-first скиллов на shell для Direct, Метрики, Вебмастера, Wordstat и Search API: Claude сам решает, какой запустить

СкиллШирокий доступ17Звезды репозитория
Российский стек

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

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

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

СкиллРасширенный доступ16Звезды репозитория
Российский стек

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

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

Скилл Claude Code для технического SEO-аудита под требования Яндекса: canonical, JSON-LD, robots.txt, favicon и диагностика через Вебмастер

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

Коротко о README

README на английском описывает скилл как набор скриптов для API Яндекс Метрики: счетчики, отчеты, цели, выгрузка сырых логов. Дана таблица из пяти скриптов с назначением, примеры вызова пресетов и произвольного отчета с метриками и измерениями, пример создания запроса Logs API. Отдельно перечислено покрытие Management, Reporting и Logs API со ссылкой на полный references/api-reference.md. Указаны системные требования curl, jq, python3, список триггеров активации скилла и лицензия MIT.

Бейдж для README

Исходный SKILL.md

---
name: yandex-metrica
description: |
  Работа с Yandex Metrica API: аналитика, отчеты, цели, логи.
  Use when the user needs web analytics data from Yandex Metrica,
  traffic stats, conversion reports, goal management, raw log exports,
  counter management, segments, filters, or grants.
  Triggers: метрика, metrica, аналитика, счетчик, визиты, конверсии,
  отчет по трафику, источники трафика, Logs API, экспорт логов.
---

# yandex-metrica

Yandex Metrica API, web analytics: counters, reports, goals, logs export.

## Config

Requires YANDEX_METRICA_TOKEN in config/.env.
See config/README.md for token setup (OAuth, permissions: metrika:read, metrika:write).

## Quick Start

IMPORTANT: Always run scripts with bash prefix and absolute paths from the skill
directory. Scripts use bash-specific features and will not work if sourced from
zsh. Do NOT source scripts/common.sh directly, use the wrapper scripts below.

```bash
# 1. Setup token
bash scripts/get_token.sh --client-id YOUR_CLIENT_ID

# 2. Check connection
bash scripts/check_connection.sh

# 3. List counters
bash scripts/counters.sh --action list

# 4. Get traffic stats
bash scripts/stats.sh --counter 12345678 --preset traffic

# 5. Export raw logs
bash scripts/logs.sh --action create --counter 12345678 --date1 2025-01-01 --date2 2025-01-31
```

## API Overview

Base URL: https://api-metrika.yandex.net

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