Описание
yandex-metrica-skill — лёгкий скилл для Claude Code, работающий с Метрикой через bash и curl: отчёты с пресетами — типовые срезы в одну команду, цели и счётчики — управление настройками, выгрузки данных — в файл для дальнейшей обработки, ноль зависимостей — только стандартные утилиты системы. Для аналитиков, которым нужна Метрика из терминала и агента без установки SDK.
Что умеет:
— строить отчёты с пресетами;
— управлять целями и счётчиками;
— выгружать данные в файл;
— работать без зависимостей.
Полная документация ниже — автоматически из репозитория elsvv/yandex-metrica-skill (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.
Yandex Metrica Skill for Claude Code
A Claude Code skill for working with the Yandex Metrica API — web analytics: counters, reports, goals, raw log exports.
Installation
claude skill install elsvv/yandex-metrica-skill
Or add manually to ~/.claude/skills/:
git clone https://github.com/elsvv/yandex-metrica-skill.git ~/.claude/skills/yandex-metrica
Setup
-
Register an app at oauth.yandex.ru/client/new with
metrika:readandmetrika:writepermissions. -
Run the token setup:
bash ~/.claude/skills/yandex-metrica/scripts/get_token.sh --client-id YOUR_CLIENT_ID
- Verify connection:
bash ~/.claude/skills/yandex-metrica/scripts/check_connection.sh
What’s Included
Scripts
| Script | Purpose |
|---|---|
check_connection.sh |
Verify API token and list counters |
counters.sh |
List, get, and inspect counters |
stats.sh |
Pull reports with presets or custom metrics/dimensions |
goals.sh |
List and inspect goals |
logs.sh |
Raw data export via Logs API (evaluate, create, download, clean) |
Presets
bash scripts/stats.sh --counter 12345678 --preset traffic
bash scripts/stats.sh --counter 12345678 --preset sources
bash scripts/stats.sh --counter 12345678 --preset geo
bash scripts/stats.sh --counter 12345678 --preset content
bash scripts/stats.sh --counter 12345678 --preset technology
Custom Reports
bash scripts/stats.sh --counter 12345678 \
--metrics "ym:s:visits,ym:s:users,ym:s:bounceRate" \
--dimensions "ym:s:lastTrafficSource" \
--date1 2025-01-01 --date2 2025-01-31
Raw Log Export
bash scripts/logs.sh --action create --counter 12345678 \
--source visits --date1 2025-01-01 --date2 2025-01-31
API Coverage
- Management API: Counters, goals, filters, operations, grants, labels, segments, user params
- Reporting API: Table, time-series, drilldown, comparison reports; all metrics/dimensions; filter syntax; CSV export
- Logs API: Full workflow — evaluate, create, poll, download (multi-part), clean
See references/api-reference.md for the complete API reference.
Requirements
curlandjq(for formatted output)python3(for URL encoding in filters)- Yandex OAuth token with
metrika:readpermission
Triggers
This skill activates on: metrica, метрика, аналитика, счётчик, визиты, конверсии, отчёт по трафику, источники трафика, Logs API, экспорт логов.
License
MIT