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

Yandex Metrica Skill for Claude Code

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

Скилл

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

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

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

elsvv/yandex-metrica-skill

Установка

В терминале, через 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.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 433d255.

Текст для агента

Установи скилл командой 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

СкиллСредний риск12Звезды репозитория
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний риск2Звезды репозитория
Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,7 тыс.Звезды репозитория

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.Звезды репозитория

Коротко о 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
Foxx AIСкилл Яндекс Метрики на bash-скриптах

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.