yandex-wordstat

Когда использовать

• Подбор ключевых слов для SEO и контекстной рекламы
• Анализ частотности поисковых запросов
• Поиск похожих запросов
• Анализ сезонности запросов

Запуск

php .opencode/skills/yandex-wordstat/wordstat.php [опции] <фраза>

Обязательный параметр

• фраза — поисковый запрос для анализа (в кавычках если есть пробелы)

Опции

Опция	Сокращение	Описание	Значения	По умолчанию
--geo	-g	Регион поиска	ID региона (например: 1 - Москва, 2 - СПб)	без региона
--type	-t	Тип отчёта	freq, similar, history	freq
--limit	-l	Лимит записей	число (например: 10, 20, 50)	все записи
--pages	-p	Страниц для истории	число (для history)	12

Типы отчётов

Параметр	Описание
freq	Частотность фразы (по умолчанию)
similar	Похожие запросы
history	История показов по месяцам

Примеры

# Частотность фразы
php .opencode/skills/yandex-wordstat/wordstat.php "купить ноутбук"

# Частотность для Москвы (geo=1)
php .opencode/skills/yandex-wordstat/wordstat.php -g 1 "веб-разработка"

# Похожие запросы
php .opencode/skills/yandex-wordstat/wordstat.php --type similar "seo продвижение"

# История показов за 24 месяца
php .opencode/skills/yandex-wordstat/wordstat.php -t history -p 24 "курсы python"

# Топ-20 похожих запросов
php .opencode/skills/yandex-wordstat/wordstat.php -t similar -l 20 "маркетинг"

Результат

wordstat_reports/YYYY-MM-DD/:

• wordstat_YYYY-MM-DD_HH-MM-SS.csv / .md — данные Wordstat

Поля в отчёте freq/similar

Поле	Описание
phrase	Поисковая фраза
shows	Показы за месяц

Поля в отчёте history

Поле	Описание
phrase	Поисковая фраза
month	Месяц (YYYY-MM)
shows	Показы

Требования

• Приложение Яндекс.OAuth с доступом к Яндекс.Direct
• Токен авторизации

Ограничения API

⚠️ API Яндекс.Direct имеет лимиты на количество запросов. При частом использовании возможно временное ограничение.