yandex-wordstat

Config

YANDEX_WORDSTAT_TOKEN

config/.env

config/README.md

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

The Problem

• 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

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

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

• 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

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

bash scripts/quota.sh

top_requests.sh

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

--phrase

--regions

--devices

dynamics.sh

bash scripts/dynamics.sh \
  --phrase "юрист дтп" \
  --period "monthly" \
  --from-date "2025-01-01"

--phrase

--period

--from-date

--to-date

--regions

--devices

regions_stats.sh

bash scripts/regions_stats.sh \
  --phrase "юрист дтп" \
  --region-type "cities"

--phrase

--region-type

--devices

regions_tree.sh

bash scripts/regions_tree.sh

search_region.sh

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

Wordstat Operators

Quotes

"query"

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

Exclamation

!word

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

Combination

"!word !word"

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

Minus

-word

юрист дтп -бесплатно -консультация

Grouping

(a|b|c)

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

Stop words

!

юрист !по дтп    ← 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

Popular Region IDs

bash scripts/regions_tree.sh

Limits

• 10 requests/second
• 1000 requests/day

Example Session

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

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

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

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

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

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

        ❌ НЕ ЦЕЛЕВЫЕ (покупают другое):
        - "каолиновая вата для дымохода" — ищут утеплитель, не дымоход
        - "монтаж дымохода своими руками" — DIY, не покупатели
        - "чистка дымохода" — уже владеют, сервисный запрос

Key Points

1. ВСЕГДА спрашивай регион и жди ответа
2. ВСЕГДА уточняй что именно продаёт клиент
3. ВСЕГДА проверяй интент через WebSearch
4. Разделяй отчёт на целевые/нецелевые с объяснением