From yandex-metrika
Fetches Yandex Metrika reports on traffic sources, conversions, UTM tags, search engines, ecommerce, and Direct ads via Reporting API v1 using bash scripts. Cache-first for context hygiene, accurate non-sampled data.
npx claudepluginhub artwist-polyakov/polyakov-claude-skills --plugin yandex-metrikaThis skill uses the workspace's default tool permissions.
Работа с Yandex Metrika Reporting API v1. Отчёты по трафику, конверсиям, UTM-меткам, поисковым системам.
config/README.mdreferences/API_REFERENCE.mdreferences/CUSTOM_REPORTS.mdreferences/DIRECT_COSTS.mdreferences/PERIOD_COMPARISON.mdreferences/SEARCH_QUERIES.mdscripts/common.shscripts/comparison.shscripts/conversions.shscripts/counter_info.shscripts/counters.shscripts/direct_clients.shscripts/direct_costs.shscripts/ecommerce.shscripts/goals.shscripts/search_engines.shscripts/traffic_summary.shscripts/utm_report.shGuides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
Работа с Yandex Metrika Reporting API v1. Отчёты по трафику, конверсиям, UTM-меткам, поисковым системам.
Требуется YANDEX_METRIKA_TOKEN в config/.env.
Инструкция: config/README.md.
lastsign (последний значимый источник). Спрашиваем пользователя при первом запуске.Получи список счётчиков:
bash scripts/counters.sh
Спроси пользователя (если счётчик не очевиден из контекста):
"О каком счётчике/сайте идёт речь?
Укажите ID, название или домен."
Если пользователь назвал сайт/домен — ищи через --search:
bash scripts/counters.sh --search "metallik"
Это grep по TSV (id + name + site), поэтому находит и по домену.
Получи инфо о счётчике и его цели:
bash scripts/counter_info.sh --counter <ID>
bash scripts/goals.sh --counter <ID>
Спроси про конверсионные цели:
"Какие из этих целей являются конверсионными для вашего бизнеса?
[список целей из goals.sh]
Сохраню выбранные для будущих отчётов."
Сохрани конфигурацию в cache/counter_<id>/config.json:
{
"attribution": "lastsign",
"conversion_goals": [
{"id": 12345, "name": "Заказ оформлен"},
{"id": 67890, "name": "Заявка отправлена"}
]
}
Запускай отчёты по задаче пользователя.
Общий паттерн вызова:
bash scripts/<script>.sh --counter <ID> --date1 YYYY-MM-DD [--date2 ...] [--group month] [--csv path]
| Script | Description | Special params |
|---|---|---|
counters.sh | Список счётчиков | --search "query" |
goals.sh | Цели счётчика | — |
counter_info.sh | Метаданные счётчика | — |
traffic_summary.sh | Трафик по источникам | — |
conversions.sh | Достижение целей | --goals "ID,ID" / --all-goals; по умолчанию из config.json |
utm_report.sh | UTM-разбивка | — |
search_engines.sh | Поисковые системы (organic) | — |
ecommerce.sh | Покупки, выручка, средний чек | --currency RUB|USD|EUR; авто из counter_info |
direct_clients.sh | Логины Директа | — |
direct_costs.sh | Расходы Директа (ym:ad:*) | --direct-client-logins "login"; нет --group/--device/--source |
comparison.sh | Сравнение двух периодов | --date1a/--date2a/--date1b/--date2b; --dimension, --metrics |
Не все скрипты поддерживают все общие параметры — см. Special params.
| Param | Required | Default | Values |
|---|---|---|---|
--counter | yes | - | ID счётчика |
--date1 | yes | - | YYYY-MM-DD |
--date2 | no | today | YYYY-MM-DD |
--group | no | - | day, week, month |
--device | no | all | desktop, mobile, tablet |
--source | no | all | organic, ad, referral, direct, social |
--attribution | no | lastsign | lastsign, last, first |
--limit | no | API default | число строк |
--csv | no | - | путь для экспорта |
--no-cache | no | - | пропустить кеш |
Кеш хранится в cache/:
counters.json + counters.tsv — все счётчикиcounter_<id>/info.json — метаданные (permanent)counter_<id>/goals.json + goals.tsv — целиcounter_<id>/config.json — атрибуция, конверсионные целиcounter_<id>/direct_clients.json — логины Директаcounter_<id>/reports/*.csv — результаты отчётовДля поиска по кешу: grep "text" cache/counters.tsv или rg "text" cache/.