Яндекс Метрика: детализация трафика по источникам и UTM-меткам, отчёты по конверсиям и поисковым системам, API-сегменты и доступы к счётчикам.

MITAuto-check: notesMarketing & SEO

Install Yandex Metrika

skills CLI
$ npx skills add artwist-polyakov/polyakov-claude-skills --skill yandex-metrika -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install artwist-polyakov/polyakov-claude-skills yandex-metrika --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/yandex-metrika/skills/yandex-metrika .claude/skills/yandex-metrika && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
yandex-metrika
GitHub stars
208
Token cost
~2.1k tokens
SKILL.md length
755 words
Files
31 (incl. scripts, references)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Яндекс Метрика: детализация трафика по источникам и UTM-меткам, отчёты по конверсиям и поисковым системам, API-сегменты и доступы к счётчикам.

  • Works in 4 steps: Cache-first — конфигурационные данные… → Context window hygiene — stdout… → Точные данные — accuracy=1 (без… → …
  • Tasks that involve Marketing analytics
  • SKILL.md covers Config, Philosophy, Workflow and Сегменты и доступы, plus 5 more sections
  • Runs Shell scripts from its folder; calls bash and rg; needs YANDEX_METRIKA_TOKEN

What it does

Yandex Metrika is an agent skill from artwist-polyakov/polyakov-claude-skills. Яндекс Метрика: детализация трафика по источникам и UTM-меткам, отчёты по конверсиям и поисковым системам, API-сегменты и доступы к счётчикам. Cache-first подход для гигиены контекстного окна. Triggers: яндекс метрика, yandex metrika, metrika analytics, метрика трафик, метрика конверсии, метрика отчёт, создать сегмент, доступ к счётчику, выдать доступ рекламному кабинету.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 34 other files, including scripts and reference files (for example `config/README.md`, `references/ACCESS.md` and `references/API_REFERENCE.md`).

It sits in Marketing & SEO, covering Marketing analytics. The repository describes itself as: Набор скиллов для Claude. The licence is MIT.

When your agent uses it

  • Tasks that involve Marketing analytics

Example prompts

  • “/yandex-metrika”

Requirements

  • Python 3
  • A Bash shell
  • A credential in YANDEX_METRIKA_TOKEN

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Cache-first — конфигурационные данные (счётчики, цели, инфо) кешируются надолго. Отчёты кешируются по ключу counter+dates+params. Перед…
  2. Context window hygiene — stdout ограничен 30 строками. Полные данные в CSV/файл. Кеш доступен через grep/rg для поиска без загрузки в…
  3. Точные данные — accuracy=1 (без сэмплирования), фильтр isRobot по умолчанию.
  4. Атрибуция — дефолт lastsign (последний значимый источник). Спрашиваем пользователя при первом запуске.

What it can do on your machine

Read from SKILL.md and the folder at commit 8bbeead. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Shell, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • YANDEX_METRIKA_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yandex Metrika loads about 2.1k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 97 tokens; SKILL.md has 755 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:20
    ебуется `YANDEX_METRIKA_TOKEN` в `config/.env`. Для чтения нужен доступ

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from artwist-polyakov/polyakov-claude-skills at commit 8bbeead, republished under its MIT licence (© artwist-polyakov). 755 words, ~2,128 tokens.

Download SKILL.mdSave it as .claude/skills/yandex-metrika/SKILL.md (or your agent's skills folder). This skill also uses 30 other files; get the full folder from GitHub.
name
yandex-metrika
description
Яндекс Метрика: детализация трафика по источникам и UTM-меткам, отчёты по конверсиям и поисковым системам, API-сегменты и доступы к счётчикам. Cache-first подход для гигиены контекстного окна. Triggers: яндекс метрика, yandex metrika, metrika analytics, метрика трафик, метрика конверсии, метрика отчёт, создать сегмент, доступ к счётчику, выдать доступ рекламному кабинету.

yandex-metrika

Работа с API Яндекс Метрики: детализация трафика по источникам и UTM-меткам, отчёты по конверсиям и поисковым системам, API-сегменты и прямые доступы к счётчикам.

Config

Требуется YANDEX_METRIKA_TOKEN в config/.env. Для чтения нужен доступ metrika:read, для создания сегментов и управления доступами — metrika:write. Инструкция: config/README.md.

Philosophy

  1. Cache-first — конфигурационные данные (счётчики, цели, инфо) кешируются надолго. Отчёты кешируются по ключу counter+dates+params. Перед API-запросом всегда проверяем кеш.
  2. Context window hygiene — stdout ограничен 30 строками. Полные данные в CSV/файл. Кеш доступен через grep/rg для поиска без загрузки в контекст.
  3. Точные данные — accuracy=1 (без сэмплирования), фильтр isRobot по умолчанию.
  4. Атрибуция — дефолт lastsign (последний значимый источник). Спрашиваем пользователя при первом запуске.

Workflow

STOP! Перед любым анализом:
  1. Получи список счётчиков:

    bash
    bash scripts/counters.sh
  2. Спроси пользователя (если счётчик не очевиден из контекста):

    "О каком счётчике/сайте идёт речь?
    Укажите ID, название или домен."

    Если пользователь назвал сайт/домен — ищи через --search:

    bash
    bash scripts/counters.sh --search "metallik"

    Это grep по TSV (id + name + site), поэтому находит и по домену.

  3. Получи инфо о счётчике и его цели:

    bash
    bash scripts/counter_info.sh --counter <ID>
    bash scripts/goals.sh --counter <ID>
  4. Спроси про конверсионные цели:

    "Какие из этих целей являются конверсионными для вашего бизнеса?
    [список целей из goals.sh]
    Сохраню выбранные для будущих отчётов."
  5. Сохрани конфигурацию в cache/counter_<id>/config.json:

    json
    {
      "attribution": "lastsign",
      "conversion_goals": [
        {"id": 12345, "name": "Заказ оформлен"},
        {"id": 67890, "name": "Заявка отправлена"}
      ]
    }
  6. Запускай отчёты по задаче пользователя.

Сегменты и доступы

Для API-сегмента сначала зафиксируй понятное название и выражение filters. Создание и удаление без --apply показывают план и ничего не меняют. Перед записью сценарий читает свежую роль на счётчике; сервер API остаётся окончательным источником прав.

bash
bash scripts/segments.sh --counter <ID> --action create \
  --name "Посетители карточек" \
  --expression "EXISTS(ym:pv:URL=@'/catalog/')"
# после проверки плана повторить с --apply

Получи точный логин от вызывающей задачи, затем проверь прямой доступ к счётчику и при необходимости подготовь минимальную роль:

bash
bash scripts/grants.sh --counter <ID> --action get --login <LOGIN>
bash scripts/grants.sh --counter <ID> --action add \
  --login <LOGIN> --permission view
# после проверки плана повторить с --apply

Для использования сегмента обычно достаточно view. Не выдавай edit, если задача не требует менять счётчик. Если пользователь выбрал analyst или edit, передай эту роль через --permission; существующую роль меняй через update. Список /grants содержит прямые разрешения; владелец выводится отдельно, а представители аккаунта в этот список не входят. После записи верни вызывающей задаче номер счётчика, ID сегмента, логин и подтверждённую роль. Подробности: API-сегменты и прямые доступы к счётчику.

Scripts

Общий паттерн вызова:

bash
bash scripts/<script>.sh --counter <ID> --date1 YYYY-MM-DD [--date2 ...] [--group month] [--csv path]
ScriptDescriptionSpecial params
counters.shСписок счётчиков--search "query"
goals.shЦели счётчика—
counter_info.shМетаданные счётчика—
traffic_summary.shТрафик по источникам—
conversions.shДостижение целей--goals "ID,ID" / --all-goals; по умолчанию из config.json
utm_report.shUTM-разбивка—
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
segments.shСписок, просмотр, создание и удаление API-сегментов--action; запись только с --apply
grants.shВладелец и прямые доступы по логинам; роли view, analyst, edit--action; запись только с --apply

Не все скрипты поддерживают все общие параметры — см. Special params. Сценариям управления segments.sh и grants.sh для надёжного разбора JSON нужен Python 3.10+ либо uv; обычные отчёты по-прежнему работают без них.

Show full SKILL.md (340 more words)Show less
Отчёт по целям

conversions.sh автоматически запрашивает цели частями по шесть и объединяет их в один CSV. Это работает для --all-goals, --goals и целей из config.json. При --all-goals список целей сначала обновляется через Management API. Объединение выполняется обычным awk; для запуска отчётов Python и uv не нужны. На каждую цель сохраняются три метрики: визиты с достижением, достижения и конверсия. Порядок целей в колонках соответствует выбранному списку.

В запросы добавляется общий показатель визитов, чтобы источники с нулевыми достижениями не исчезали из отдельных частей. В итоговом CSV служебных метрик нет, но источники без конверсий сохраняются; итоговая конверсия учитывает их визиты. Источники сортируются по визитам с достижением первой выбранной цели, при равенстве — по источнику.

--limit ограничивает число источников: без --group допустимо 1–100000 (по умолчанию 100); с --group — 1–30 (по умолчанию 30, параметр API top_keys). Даты при этом не сокращаются. Отчёт попадает в кеш и --csv только после успешного получения и объединения всех частей.

Общие параметры отчётных скриптов

ParamRequiredDefaultValues
--counteryes-ID счётчика
--date1yes-YYYY-MM-DD
--date2notodayYYYY-MM-DD
--groupno-day, week, month
--devicenoalldesktop, mobile, tablet
--sourcenoallorganic, ad, referral, direct, social
--attributionnolastsignlastsign, last, first
--filtersnoбез роботоввыражение сегментации API отчётов
--limitnoAPI defaultчисло строк
--csvno-путь для экспорта
--no-cacheno-пропустить кеш

Кеш-стратегия

Кеш хранится в 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/.

Расширенные сценарии

Лимиты API

  • Reporting API: ~200 запросов / 5 минут (при превышении — ждите ~5 минут)
  • Скрипты автоматически обрабатывают 429 (Retry-After ≤ 60s → retry, иначе fail с сообщением)

© artwist-polyakov, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 30 other files (scripts, references) in plugins/yandex-metrika/skills/yandex-metrika of artwist-polyakov/polyakov-claude-skills.

  • SKILL.md
  • .gitignore
  • cache/.gitkeep
  • config/.env.example
  • config/README.md
  • references/ACCESS.md
  • references/API_REFERENCE.md
  • references/CUSTOM_REPORTS.md
  • references/DIRECT_COSTS.md
  • references/PERIOD_COMPARISON.md
  • references/SEARCH_QUERIES.md
  • references/SEGMENTS.md
  • scripts/common.sh
  • scripts/comparison.sh
  • scripts/conversions.sh
  • scripts/counter_info.sh
  • scripts/counters.sh
  • … and 14 more

Open the folder on GitHubat commit 8bbeead

Compare with similar skills

Yandex Metrika next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Yandex Metrika compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yandex Metrika this skillartwist-polyakov/polyakov-claude-skills208—~2.1kAutomated safety check: NotesMIT
Google SEO APIsAgriciDaniel/claude-seo19k1 repos~4.2kAutomated safety check: PassMIT
AnalyticsNexus-JPF/note-companion8707 repos~2.2kAutomated safety check: PassMIT
GEO Monthly Delta Reportzubair-trabzada/geo-seo-claude11k—~2.4kAutomated safety check: NotesMIT
Conversion Signal QAaaron-he-zhu/aaron-marketing-skills2.9k2 repos~2.4kAutomated safety check: PassApache-2.0
LLM Mention Trackingunifapi-agent/agents589—~1.8kAutomated safety check: PassMIT

Similar skills

  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed
  • Analytics

    Nexus-JPF/note-companion

    When the user wants to set up, improve, or audit analytics tracking and measurement.

    870 GitHub starsUsed in 7 repos~2.2k tokens
    Marketing & SEOAuto-check passed
  • GEO Monthly Delta Report

    zubair-trabzada/geo-seo-claude

    Compares a baseline and a current GEO audit for a client, calculates score changes and action item progress, and writes a monthly progress report.

    11k GitHub stars~2.4k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • Conversion Signal QA

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "QA my conversion tracking before launch", "check my UTMs / pixel / event firing", "set up a tracking pre-flight", or "set the dedup rule so Meta and…

    2.9k GitHub starsUsed in 2 repos~2.4k tokens
    Marketing & SEOAuto-check passed
  • LLM Mention Tracking

    unifapi-agent/agents

    When the user wants to track how often their brand or domain gets mentioned across ChatGPT and AI search engines over a set of prompts, and how that share of voice compares to named competitors over…

    589 GitHub stars~1.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Google Analytics 4 Analysis

    LichAmnesia/lich-skills

    Pulls Google Analytics 4 data through the Data API with TypeScript scripts and turns it into a daily SEO report or prioritized traffic and bounce-rate recommendations.

    234 GitHub stars~2k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check: notes

More from artwist-polyakov/polyakov-claude-skills

All 21 skills in this repo
  • Agent Deck Sessions

    artwist-polyakov/polyakov-claude-skills

    Launches, monitors and collects results from child AI agent sessions with the agent-deck terminal session manager.

    208 GitHub stars~965 tokensUpdated 3 days ago
    Auto-check passed
  • Crawl4AI SEO Site Crawler

    artwist-polyakov/polyakov-claude-skills

    Crawls a site with Crawl4AI to audit titles, meta tags, H1s, canonicals, navigation and internal links, and to compare landing pages and competitor sites.

    208 GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed
  • GitHub Pages Publisher

    artwist-polyakov/polyakov-claude-skills

    Publishes already-built static pages to a GitHub Pages repo under a year, year-month and slug folder layout, optimizes large images and returns the public URL.

    208 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Perplexity Search and Research

    artwist-polyakov/polyakov-claude-skills

    Shell scripts for web search and research through the Perplexity API: raw results, cited answers, background deep research and page fetching, with results cached on disk.

    208 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check: notes
  • Sourcecraft Publisher

    artwist-polyakov/polyakov-claude-skills

    Publish static page artifacts to SourceCraft Sites (Yandex infrastructure, works in Russia), with advisory image optimization and an original-image path.

    208 GitHub stars~990 tokensUpdated 3 days ago
    Auto-check: notes
  • X/Twitter Research via Grok

    artwist-polyakov/polyakov-claude-skills

    Searches X/Twitter through the xAI Grok API to build digests, trend reports and thread analysis, meant to surface post ideas for a Telegram channel.

    208 GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check: notes

Categories

Questions about Yandex Metrika

What does Yandex Metrika do?

Яндекс Метрика: детализация трафика по источникам и UTM-меткам, отчёты по конверсиям и поисковым системам, API-сегменты и доступы к счётчикам. Yandex Metrika is an agent skill from artwist-polyakov/polyakov-claude-skills. Яндекс Метрика: детализация трафика по источникам и UTM-меткам, отчёты по конверсиям и поисковым системам, API-сегменты и доступы к счётчикам.

When should I use Yandex Metrika?

Yandex Metrika fits situations like: tasks that involve Marketing analytics.

How do I install Yandex Metrika in Claude Code?

Run `npx skills add artwist-polyakov/polyakov-claude-skills --skill yandex-metrika -a claude-code`. Or copy the skill folder (plugins/yandex-metrika/skills/yandex-metrika in artwist-polyakov/polyakov-claude-skills) into .claude/skills/yandex-metrika in your project. Claude Code loads it when a task matches its description.

How do I install Yandex Metrika in Codex?

Run `npx skills add artwist-polyakov/polyakov-claude-skills --skill yandex-metrika -a codex`. Or copy the skill folder (plugins/yandex-metrika/skills/yandex-metrika in artwist-polyakov/polyakov-claude-skills) into .agents/skills/yandex-metrika in your project. Codex loads it when a task matches its description.

Can I use Yandex Metrika in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add artwist-polyakov/polyakov-claude-skills --skill yandex-metrika -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yandex-metrika, .gemini/skills/yandex-metrika, .github/skills/yandex-metrika and .opencode/skills/yandex-metrika in your project.

What does Yandex Metrika need to run?

Going by SKILL.md and its folder, Yandex Metrika needs a shell for the scripts in its folder, the command-line tools its instructions call (bash and rg) and credentials named YANDEX_METRIKA_TOKEN. Our summary lists: Python 3; A Bash shell; A credential in YANDEX_METRIKA_TOKEN.

Does Yandex Metrika access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Yandex Metrika safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Yandex Metrika use?

Yandex Metrika is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yandex Metrika use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.9k tokens, read only when the agent opens those files.

What are the alternatives to Yandex Metrika?

Skills that share tags, products or a category with Yandex Metrika: Google SEO APIs (AgriciDaniel/claude-seo, 19k stars), Analytics (Nexus-JPF/note-companion, 870 stars), GEO Monthly Delta Report (zubair-trabzada/geo-seo-claude, 11k stars) and Conversion Signal QA (aaron-he-zhu/aaron-marketing-skills, 2.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yandex Metrika?

artwist-polyakov (a GitHub user) maintains it in artwist-polyakov/polyakov-claude-skills, which has 208 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 8, 2026.

Source: artwist-polyakov/polyakov-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.