From yandex-wordstat
Analyzes Yandex Wordstat API for search demand, keyword frequency, seasonality, regional stats, associations, and dynamics up to 2000 queries. Verifies buyer intent via web search; processes Yandex Direct XLSX for missed demand.
npx claudepluginhub artwist-polyakov/polyakov-claude-skills --plugin yandex-wordstatThis skill uses the workspace's default tool permissions.
Analyze search demand and keyword statistics using Yandex Wordstat API.
Guides 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.
Analyze search demand and keyword statistics using Yandex Wordstat API.
Requires YANDEX_WORDSTAT_TOKEN in config/.env.
See config/README.md for token setup instructions.
Before marking ANY query as "target", verify intent via WebSearch!
Query "каолиновая вата для дымохода" looks relevant for chimney seller, but:
For every promising query, ASK YOURSELF:
Always run WebSearch to check:
WebSearch: "каолиновая вата для дымохода" что ищут покупатели
Look at search results:
| Query | Looks like | Actually | Target? |
|---|---|---|---|
| каолиновая вата для дымохода | chimney buyer | cotton wool buyer | ❌ NO |
| дымоход купить | chimney buyer | chimney buyer | ✅ YES |
| утепление дымохода | chimney buyer | insulation DIYer | ❌ NO |
| дымоход сэндвич цена | chimney buyer | chimney buyer | ✅ YES |
| потерпевший дтп | lawyer client | news reader | ❌ NO |
| юрист после дтп | lawyer client | lawyer client | ✅ YES |
ASK user about region and WAIT for answer:
"Для какого региона анализировать спрос?
- Вся Россия (по умолчанию)
- Москва и область
- Конкретный город (какой?)"
НЕ ПРОДОЛЖАЙ пока пользователь не ответит!
ASK about business goal:
"Что именно вы продаёте/рекламируете?
Это важно для фильтрации нецелевых запросов."
bash scripts/quota.shCheck API connection.
bash scripts/quota.sh
Get top search phrases. Supports up to 2000 results and CSV export.
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 ","
| Param | Required | Default | Values |
|---|---|---|---|
--phrase | yes | - | text with operators |
--regions | no | all | comma-separated IDs |
--devices | no | all | all, desktop, phone, tablet |
--limit | no | API default (50) | 1-2000 (maps to API numPhrases) |
--csv | no | - | path to output CSV file |
--sep | no | ; | CSV separator (; for RU Excel) |
The output contains two sections (both in stdout and CSV):
topRequests) — queries that contain the words from your phrase, sorted by frequency. These are direct variations of the search query. Example: phrase "юрист дтп" → "юрист по дтп", "консультация юриста по дтп".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 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.
When --limit is set to a high value (e.g. 500-2000), use CSV export and read the file in chunks:
# 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.
Get search volume trends over time.
bash scripts/dynamics.sh \
--phrase "юрист дтп" \
--period "monthly" \
--from-date "2025-01-01"
| Param | Required | Default | Values |
|---|---|---|---|
--phrase | yes | - | text |
--period | no | monthly | daily, weekly, monthly |
--from-date | yes | - | YYYY-MM-DD |
--to-date | no | today | YYYY-MM-DD |
--regions | no | all | region IDs |
--devices | no | all | all, desktop, phone, tablet |
Get regional distribution.
bash scripts/regions_stats.sh \
--phrase "юрист дтп" \
--region-type "cities"
| Param | Required | Default | Values |
|---|---|---|---|
--phrase | yes | - | text |
--region-type | no | all | cities, regions, all |
--devices | no | all | all, desktop, phone, tablet |
Show common region IDs.
bash scripts/regions_tree.sh
Find region ID by name.
bash scripts/search_region.sh --name "Москва"
"query"Shows demand ONLY for this exact phrase (no additional words).
"юрист дтп" → "юрист дтп", "юристы дтп"
but NOT "юрист по дтп"
!wordFixes exact word form.
!юрист → "юрист по дтп", "юрист москва"
but NOT "юристы", "юриста"
"!word !word"Exact phrase + exact forms.
"!юрист !по !дтп" → only "юрист по дтп"
-wordExclude queries with this word.
юрист дтп -бесплатно -консультация
(a|b|c)Multiple variants in one query.
(юрист|адвокат) дтп → combined demand
Always fix prepositions with !:
юрист !по дтп ← correct
юрист по дтп ← "по" ignored!
юрист дтп — see total volume"юрист дтп" — exact phrase only"!юрист !по !дтп" — exact matchюрист дтп -бесплатно -онлайн| Region | ID |
|---|---|
| Россия | 225 |
| Москва | 213 |
| Москва и область | 1 |
| Санкт-Петербург | 2 |
| Екатеринбург | 54 |
| Новосибирск | 65 |
| Казань | 43 |
Run bash scripts/regions_tree.sh for full list.
User: Найди запросы для рекламы дымоходов
Claude: Для какого региона анализировать спрос?
И уточните — вы продаёте готовые дымоходы или
материалы для их изготовления/утепления?
User: Москва, продаём готовые сэндвич-дымоходы
Claude: [Запускает анализ для региона 213]
Нашёл запросы. Проверяю интент через веб-поиск...
✅ ЦЕЛЕВЫЕ (покупают дымоходы):
- "дымоход сэндвич купить" — 450 показов
- "дымоход для бани цена" — 380 показов
❌ НЕ ЦЕЛЕВЫЕ (покупают другое):
- "каолиновая вата для дымохода" — ищут утеплитель, не дымоход
- "монтаж дымохода своими руками" — DIY, не покупатели
- "чистка дымохода" — уже владеют, сервисный запрос
Анализ рекламной кампании Яндекс Директ для нахождения фраз, не покрытых текущей семантикой. Требования: XLSX-выгрузка из Яндекс Директ (лист «Тексты»). Подробнее: MISSED_DEMAND.md