Анализ поискового спроса через Yandex Wordstat API. An agent skill from artwist-polyakov/polyakov-claude-skills.

MITAuto-check passedDocuments & Office

Install Yandex Wordstat

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

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

GitHub CLI
$ gh skill install artwist-polyakov/polyakov-claude-skills yandex-wordstat --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-wordstat/skills/yandex-wordstat .claude/skills/yandex-wordstat && 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-wordstat
GitHub stars
208
Token cost
~2.6k tokens
SKILL.md length
937 words
Files
38 (incl. scripts, references)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Анализ поискового спроса через Yandex Wordstat API. An agent skill from artwist-polyakov/polyakov-claude-skills.

  • Works in 5 steps: Skepticism to non-target demand — high… → Creative semantic expansion — think like… → Always clarify region — ask user for… → …
  • Tasks that involve CSV and tabular files
  • SKILL.md covers Настройка, Philosophy, CRITICAL: Intent Verification and Workflow, plus 5 more sections
  • Runs Shell and Python scripts from its folder; calls bash

What it does

Yandex Wordstat is an agent skill from artwist-polyakov/polyakov-claude-skills. Анализ поискового спроса через Yandex Wordstat API. Используй когда нужно: исследовать спрос, семантическое ядро, частотность запросов, сезонность или региональный спрос. Топ до 2000 запросов, ассоциации, динамика, экспорт CSV. Поиск упущенного спроса: анализ XLSX-выгрузки из Яндекс Директ, сегментация фраз, расширение семантики, сравнение OR-запросов. Triggers: упущенный спрос.

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

It sits in Documents & Office, covering CSV and tabular files and Excel spreadsheets. It works with Microsoft Excel. The repository describes itself as: Набор скиллов для Claude. The licence is MIT.

When your agent uses it

  • Tasks that involve CSV and tabular files
  • Tasks that involve Excel spreadsheets

Example prompts

  • “/yandex-wordstat”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

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

  1. Skepticism to non-target demand — high numbers don't mean quality traffic
  2. Creative semantic expansion — think like a customer
  3. Always clarify region — ask user for target region before analysis
  4. Show operators in reports — include Wordstat operators for verification
  5. VERIFY INTENT via web search — always check what people actually want to buy

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 9 files in scripts/ (Shell and Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

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

  • Network

    Links to these hosts (documentation or services it may open):

    • aistudio.yandex.ru

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Yandex Wordstat loads about 2.6k tokens when it runs, and up to ~8.4k if it reads all its reference files. Until then it costs about 99 tokens; SKILL.md has 937 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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). 937 words, ~2,596 tokens.

Download SKILL.mdSave it as .claude/skills/yandex-wordstat/SKILL.md (or your agent's skills folder). This skill also uses 37 other files; get the full folder from GitHub.
name
yandex-wordstat
description
Анализ поискового спроса через Yandex Wordstat API. Используй когда нужно: исследовать спрос, семантическое ядро, частотность запросов, сезонность или региональный спрос. Топ до 2000 запросов, ассоциации, динамика, экспорт CSV. Поиск упущенного спроса: анализ XLSX-выгрузки из Яндекс Директ, сегментация фраз, расширение семантики, сравнение OR-запросов. Triggers: упущенный спрос.

yandex-wordstat

Analyze search demand and keyword statistics using Yandex Wordstat API.

Настройка

Скилл работает через Wordstat API в Yandex Cloud Search API v2. Для авторизации выберите IAM через авторизованный JSON-ключ сервисного аккаунта или API-ключ сервисного аккаунта. IAM-токен скрипты получают и обновляют автоматически; API-ключ автоматически не обновляется.

Единая инструкция по настройке, переходу со старого API и устранению ошибок: config/README.md.

⚠️ Операторы в dynamics: при --period weekly|monthly поддерживается только оператор +. Минус-слова, кавычки, группировки и точные формы работают только при --period daily. Скилл проверяет фразу и сообщает об ошибке до отправки запроса. Подробнее — в README.

Philosophy

  1. Skepticism to non-target demand — high numbers don't mean quality traffic
  2. Creative semantic expansion — think like a customer
  3. Always clarify region — ask user for target region before analysis
  4. Show operators in reports — include Wordstat operators for verification
  5. VERIFY INTENT via web search — always check what people actually want to buy

CRITICAL: Intent Verification

Before marking ANY query as "target", verify intent via WebSearch!

The Problem

Query "каолиновая вата для дымохода" looks relevant for chimney seller, but:

  • People search this to BUY COTTON WOOL, not chimneys
  • They already HAVE a chimney and need insulation material
  • This is NOT a target query for chimney sales!
Verification Process

For every promising query, ASK YOURSELF:

  1. What does the person want to BUY? (not just "what are they interested in")
  2. Will they buy OUR product from this search?
  3. Or are they looking for something adjacent/complementary?
MANDATORY: Use WebSearch

Always run WebSearch to check:

WebSearch: "каолиновая вата для дымохода" что ищут покупатели

Look at search results:

  • What products are shown?
  • What questions do people ask?
  • Is this informational or transactional intent?
Red Flags (likely NOT target)
  • Query contains "для [вашего продукта]" — they need ACCESSORY, not your product
  • Query about materials/components — they DIY, not buy finished product
  • Query has "своими руками", "как сделать" — informational, not buying
  • Query about repair/maintenance — they already own it
Examples
QueryLooks likeActuallyTarget?
каолиновая вата для дымоходаchimney buyercotton wool buyer❌ NO
дымоход купитьchimney buyerchimney buyer✅ YES
утепление дымоходаchimney buyerinsulation DIYer❌ NO
дымоход сэндвич ценаchimney buyerchimney buyer✅ YES
потерпевший дтпlawyer clientnews reader❌ NO
юрист после дтпlawyer clientlawyer client✅ YES
Workflow Update
  1. Find queries in Wordstat
  2. WebSearch each promising query to verify intent
  3. Mark as target ONLY if intent matches the sale
  4. Report both target AND rejected queries with reasoning

Workflow

STOP! Before any analysis:
  1. ASK user about region and WAIT for answer:

    "Для какого региона анализировать спрос?
    - Вся Россия (по умолчанию)
    - Москва и область
    - Конкретный город (какой?)"

    НЕ ПРОДОЛЖАЙ пока пользователь не ответит!

  2. ASK about business goal:

    "Что именно вы продаёте/рекламируете?
    Это важно для фильтрации нецелевых запросов."
After getting answers:
  1. Check connection: bash scripts/quota.sh
  2. Run analysis using appropriate script
  3. Verify intent via WebSearch for each promising query
  4. Present results with target/non-target separation

Scripts

quota.sh

Check API connection.

bash
bash scripts/quota.sh
top_requests.sh

Get top search phrases. Supports up to 2000 results and CSV export.

bash
bash scripts/top_requests.sh \
  --phrase "юрист дтп" \
  --regions "213" \
  --devices "all"

# Extended: 500 results exported to CSV
bash scripts/top_requests.sh \
  --phrase "юрист дтп" \
  --limit 500 \
  --csv report.csv

# Max results with comma separator
bash scripts/top_requests.sh \
  --phrase "юрист дтп" \
  --limit 2000 \
  --csv full_report.csv \
  --sep ","
ParamRequiredDefaultValues
--phraseyes-text with operators
--regionsnoallcomma-separated IDs
--devicesnoallall, desktop, phone, tablet
--limitno50 (set by the skill)1-2000 (maps to API numPhrases)
--csvno-path to output CSV file
--sepno;CSV separator (; for RU Excel)
Show full SKILL.md (424 more words)Show less
Result types: Top Requests vs Associations

The output contains two sections (both in stdout and CSV):

  • top (topRequests) — queries that contain the words from your phrase, sorted by frequency. These are direct variations of the search query. Example: phrase "юрист дтп" → "юрист по дтп", "консультация юриста по дтп".
  • assoc (associations) — queries similar by meaning but not necessarily containing the same words, sorted by similarity. These are semantically related searches. Example: phrase "юрист дтп" → "юридическая ответственность", "адвокат аварии".

For analysis: top results are your primary keyword pool. assoc results are useful for semantic expansion but often contain noise — always verify intent before including them.

CSV export details

CSV format: UTF-8 with BOM, columns: n;phrase;impressions;type. When --csv is set, stdout shows first 20 rows per section; full data goes to file.

Working with large CSV exports

When --limit is set to a high value (e.g. 500-2000), use CSV export and read the file in chunks:

bash
# Export 2000 results
bash scripts/top_requests.sh --phrase "query" --limit 2000 --csv data.csv

# Read first 50 rows (header + data)
head -n 51 data.csv

# Read rows 51-100
tail -n +52 data.csv | head -50

# Count total rows
wc -l < data.csv

# Filter only associations
grep ";assoc$" data.csv

This approach lets the agent process large datasets without flooding stdout.

dynamics.sh

Get search volume trends over time.

bash
bash scripts/dynamics.sh \
  --phrase "юрист дтп" \
  --period "monthly" \
  --from-date "2025-01-01"
ParamRequiredDefaultValues
--phraseyes-text
--periodnomonthlydaily, weekly, monthly
--from-dateyes-YYYY-MM-DD
--to-datenotodayYYYY-MM-DD
--regionsnoallregion IDs
--devicesnoallall, desktop, phone, tablet
regions_stats.sh

Get regional distribution.

bash
bash scripts/regions_stats.sh \
  --phrase "юрист дтп" \
  --region-type "cities"
ParamRequiredDefaultValues
--phraseyes-text
--region-typenoallcities, regions, all
--devicesnoallall, desktop, phone, tablet
regions_tree.sh

Show common region IDs.

bash
bash scripts/regions_tree.sh
search_region.sh

Find region ID by name.

bash
bash scripts/search_region.sh --name "Москва"

Wordstat Operators

Quotes "query"

Shows demand ONLY for this exact phrase (no additional words).

"юрист дтп" → "юрист дтп", "юристы дтп"
             but NOT "юрист по дтп"
Exclamation !word

Fixes exact word form.

!юрист → "юрист по дтп", "юрист москва"
         but NOT "юристы", "юриста"
Combination "!word !word"

Exact phrase + exact forms.

"!юрист !по !дтп" → only "юрист по дтп"
Minus -word

Exclude queries with this word.

юрист дтп -бесплатно -консультация
Grouping (a|b|c)

Multiple variants in one query.

(юрист|адвокат) дтп → combined demand
Stop words

Always fix prepositions with !:

юрист !по дтп    ← correct
юрист по дтп     ← "по" ignored!

Analysis Strategy

  1. Broad query: юрист дтп — see total volume
  2. Narrow with quotes: "юрист дтп" — exact phrase only
  3. Fix forms: "!юрист !по !дтп" — exact match
  4. Clean with minus: юрист дтп -бесплатно -онлайн
  5. Expand: synonyms, related terms, client problems
RegionID
Россия225
Москва213
Москва и область1
Санкт-Петербург2
Екатеринбург54
Новосибирск65
Казань43

Run bash scripts/regions_tree.sh for full list.

Квоты и лимиты

Актуальные ограничения для Wordstat приведены в документации Yandex Search API.

Example Session

User: Найди запросы для рекламы дымоходов

Claude: Для какого региона анализировать спрос?
        И уточните — вы продаёте готовые дымоходы или
        материалы для их изготовления/утепления?

User: Москва, продаём готовые сэндвич-дымоходы

Claude: [Запускает анализ для региона 213]

        Нашёл запросы. Проверяю интент через веб-поиск...

        ✅ ЦЕЛЕВЫЕ (покупают дымоходы):
        - "дымоход сэндвич купить" — 450 показов
        - "дымоход для бани цена" — 380 показов

        ❌ НЕ ЦЕЛЕВЫЕ (покупают другое):
        - "каолиновая вата для дымохода" — ищут утеплитель, не дымоход
        - "монтаж дымохода своими руками" — DIY, не покупатели
        - "чистка дымохода" — уже владеют, сервисный запрос
Key Points
  1. ВСЕГДА спрашивай регион и жди ответа
  2. ВСЕГДА уточняй что именно продаёт клиент
  3. ВСЕГДА проверяй интент через WebSearch
  4. Разделяй отчёт на целевые/нецелевые с объяснением

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

Поиск упущенного спроса

Анализ рекламной кампании Яндекс Директ для нахождения фраз, не покрытых текущей семантикой. Требования: XLSX-выгрузка из Яндекс Директ (лист «Тексты»). Подробнее: MISSED_DEMAND.md

© 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 37 other files (scripts, references) in plugins/yandex-wordstat/skills/yandex-wordstat of artwist-polyakov/polyakov-claude-skills.

  • SKILL.md
  • .gitignore
  • cache/.gitkeep
  • config/.env.example
  • config/README.md
  • config/config.example.json
  • references/MISSED_DEMAND.md
  • scripts/common.sh
  • scripts/dynamics.sh
  • scripts/missed_demand.py
  • scripts/query_total.sh
  • scripts/quota.sh
  • scripts/regions_stats.sh
  • scripts/regions_tree.sh
  • scripts/search_region.sh
  • scripts/tests/fixtures
  • … and 22 more

Open the folder on GitHubat commit 8bbeead

Compare with similar skills

Yandex Wordstat 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 Wordstat compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yandex Wordstat this skillartwist-polyakov/polyakov-claude-skills208—~2.6kAutomated safety check: PassMIT
Data Table Managern8n-io/n8n207k—~2.3kAutomated safety check: PassCustom licence
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0
Markitshift-labs-ai/markit1.3k—~299Automated safety check: PassMIT
Convert Fileduckdb/duckdb-skills6031 repos~720Automated safety check: NotesMIT
Research Integrity Auditxuzhougeng/wisp-science1k—~2.6kAutomated safety check: PassAGPL-3.0

Similar skills

  • Official

    Load before calling data-tables or parse-file. An agent skill from n8n-io/n8n.

    207k GitHub stars~2.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed
  • Markit

    shift-labs-ai/markit

    Convert files and URLs to Markdown. An agent skill from shift-labs-ai/markit.

    1.3k GitHub stars~299 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Convert File

    duckdb/duckdb-skills

    Official

    Convert any data file to another format: CSV, Parquet, JSON, Excel, GeoJSON, and more.

    603 GitHub starsUsed in 1 repo~720 tokens
    Documents & OfficeAuto-check: notes
  • Research Integrity Audit

    xuzhougeng/wisp-science

    学术审查 / research-integrity screening of a manuscript's figures and reported numbers.

    1k GitHub stars~2.6k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Jmh Benchmark Compare

    eclipse-rdf4j/rdf4j

    Parse JMH result text by finding the first header line that starts with Benchmark and contains Mode and Score, build a structured table for all columns/rows, compare overlapping benchmarks across 2+…

    420 GitHub stars~804 tokensUpdated yesterday
    Documents & OfficeAuto-check passed

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 2 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 2 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 2 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 2 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 2 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 2 days ago
    Auto-check: notes

Works with

Questions about Yandex Wordstat

What does Yandex Wordstat do?

Анализ поискового спроса через Yandex Wordstat API. An agent skill from artwist-polyakov/polyakov-claude-skills. Yandex Wordstat is an agent skill from artwist-polyakov/polyakov-claude-skills. Анализ поискового спроса через Yandex Wordstat API.

When should I use Yandex Wordstat?

Yandex Wordstat fits situations like: tasks that involve CSV and tabular files; tasks that involve Excel spreadsheets.

How do I install Yandex Wordstat in Claude Code?

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

How do I install Yandex Wordstat in Codex?

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

Can I use Yandex Wordstat 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-wordstat -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-wordstat, .gemini/skills/yandex-wordstat, .github/skills/yandex-wordstat and .opencode/skills/yandex-wordstat in your project.

What does Yandex Wordstat need to run?

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

Does Yandex Wordstat access the network?

SKILL.md names 1 domain. As links in the text: aistudio.yandex.ru. This is read from the text; nothing was executed.

Is Yandex Wordstat safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. 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 Wordstat use?

Yandex Wordstat 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 Wordstat use?

About 2.6k tokens (SKILL.md is roughly 10k 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 5.9k tokens, read only when the agent opens those files.

What are the alternatives to Yandex Wordstat?

Skills that share tags, products or a category with Yandex Wordstat: Data Table Manager (n8n-io/n8n, 207k stars), Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Markit (shift-labs-ai/markit, 1.3k stars) and Convert File (duckdb/duckdb-skills, 603 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yandex Wordstat?

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.