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 — последний день месяца/недели