Wordstat Collector

Яндекс.Вордстат через API — автоматический сбор поисковой семантики для AI-агента (100 запросов/час). Use when нужна частотность, сезонность и кластеризация запросов для RU-рынка — «собери семантику», «вордстат», «частотность запросов», keyword research для Яндекса.

axelfreeman f2de8a5 1.9 KB Updated

File contents

Wordstat Collector

Что делает

Собирает поисковую статистику Яндекса через API и возвращает структурированные данные. Агент может использовать их для генерации SEO-страниц, рекламных кампаний и контент-планов.

Команды для агента

«Собери семантику по теме [тема] через Wordstat»
«Покажи топ-20 запросов по [ключ]»
«Сгенерируй SEO-страницы на основе семантики из semantic_results.json»

Переменные

WORDSTAT_API_KEY     # API-ключ Яндекс.Облака
WORDSTAT_FOLDER_ID   # ID каталога (20 символов)

Скрипт

scripts/collect.py — принимает список seed-фраз, возвращает JSON с фразами и частотами.

python3 scripts/collect.py "фраза1" "фраза2"

Лимиты

  • 100 запросов в час
  • 0.3 sec между запросами
  • Не больше 90 запросов за сессию (запас 10%)

Питфоллы

  • Все числа приходят строками → int(count)
  • folderId ровно 20 символов → .strip()
  • Дата для dynamics — последний день месяца/недели

axelfreeman/yandex-wordstat-guide/tree/main/skill commit f2de8a5197

Frequently asked questions

npx skillmds@latest add axelfreeman/wordstat-collector