What it does
Collects Yandex search statistics via API and returns structured data. The agent can use it to generate SEO pages, advertising campaigns, and content plans.
Commands for the agent
«Собери семантику по теме [тема] через Wordstat»
«Покажи топ-20 запросов по [ключ]»
«Сгенерируй SEO-страницы на основе семантики из semantic_results.json»
Variables
WORDSTAT_API_KEY # API-ключ Яндекс.Облака
WORDSTAT_FOLDER_ID # ID каталога (20 символов)
Script
scripts/collect.py — accepts a list of seed phrases, returns JSON with phrases and frequencies.
python3 scripts/collect.py "фраза1" "фраза2"
Limits
- 100 requests per hour
- 0.3 sec between requests
- No more than 90 requests per session (10% buffer)
Pitfalls
- All numbers come as strings →
int(count) - folderId exactly 20 characters →
.strip() - Date for dynamics — the last day of the month/week