Скилл Яндекс Метрики на bash-скриптах
Yandex Metrica Skill for Claude Code
Скилл Claude Code для Яндекс Метрики на bash-скриптах поверх curl: отчеты с пресетами, цели, счетчики и выгрузка сырых логов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает данные о трафике и конверсиях, включая коммерчески чувствительную статистику
- Токен запрашивается с правом metrika:write, хотя README описывает только отчетные сценарии
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/yandex-metrica-skill-for-claude-codeОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-metrica-skill --skill yandex-metrica -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-metrica-skill --skill yandex-metrica -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-metrica-skill --skill yandex-metrica -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-metrica-skill --skill yandex-metrica -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-metrica-skill --skill yandex-metrica -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-metrica-skill --skill yandex-metrica -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-metrica-skill --skill yandex-metrica -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-metrica-skill --skill yandex-metrica -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Установи скилл командой claude skill install elsvv/yandex-metrica-skill, зарегистрируй приложение на oauth.yandex.ru/client/new с правами metrika:read и metrika:write, затем выполни bash scripts/get_token.sh --client-id твой_id и проверь подключение bash scripts/check_connection.sh.
Другие способы из описания автора
claude skill install elsvv/yandex-metrica-skillУстановка через встроенную команду скиллов 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: оценку объема, создание запроса, скачивание многочастевого файла и очистку обработанных логов.
Похожие
СкиллыСкиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов
Коротко о README
README на английском описывает скилл как набор скриптов для API Яндекс Метрики: счетчики, отчеты, цели, выгрузка сырых логов. Дана таблица из пяти скриптов с назначением, примеры вызова пресетов и произвольного отчета с метриками и измерениями, пример создания запроса Logs API. Отдельно перечислено покрытие Management, Reporting и Logs API со ссылкой на полный references/api-reference.md. Указаны системные требования curl, jq, python3, список триггеров активации скилла и лицензия MIT.
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