Yandex Wordstat: API, парсинг, AI-автоматизация
Что такое Wordstat, как получить доступ к API, как парсить запросы скриптом и автоматизировать через AI-агентов вроде Claude Code и Cursor.
Что такое Yandex Wordstat
Wordstat — бесплатный сервис Яндекса, который показывает, сколько раз в месяц пользователи искали тот или иной запрос в Яндексе. Базовый инструмент SEO-специалиста: позволяет оценивать спрос, сезонность, региональные особенности, подбирать ключевые слова.
Wordstat API: что и как
Прямого публичного REST API у Wordstat нет — для автоматизации есть несколько путей:
- Яндекс Директ API — официальная ручка
CreateNewWordstatReport, но требует токен Директ-аккаунта и кампании. - Сторонние парсеры — Key Collector, Just Magic и подобные тулзы используют браузерную автоматизацию.
- Skill для AI-агента — навык в skillsbd обёртывает легальный путь (Директ API) и предоставляет агенту простую функцию
wordstat(query).
Как получить токен Яндекс Директ
- Зарегистрируйте OAuth-приложение в oauth.yandex.ru с правом «Управление кампаниями Яндекс Директа».
- Получите токен через стандартный OAuth-flow.
- В Директе должна быть хотя бы одна кампания (можно пустая) — для активации API.
- Подайте заявку на песочницу Директ API или продакшен-доступ через интерфейс рекламодателя.
Пример запроса (Python)
import requests
HEADERS = {
"Authorization": f"Bearer {TOKEN}",
"Accept-Language": "ru",
}
r = requests.post(
"https://api.direct.yandex.com/json/v5/wordstatreports",
headers=HEADERS,
json={"method": "CreateNewWordstatReport", "params": {"Phrases": ["нейросеть"], "GeoID": [225]}},
)
print(r.json())
Отчёт асинхронный. Первый запрос возвращает ReportID, далее опрашиваете GetWordstatReport до готовности.
Автоматизация в Claude Code / Cursor
Скрипт под Wordstat легко забыть или запутаться в схеме отчётов. Установите готовый навык — и AI-агент будет дергать API сам:
# Установите навык yandex-wordstat
$ npx skillsbd add artwist-polyakov/polyakov-claude-skills/yandex-wordstat
# Положите токен в .env
$ echo "YANDEX_DIRECT_TOKEN=..." >> .env
# Теперь Claude Code / Cursor умеют
# «покажи частоту запроса нейросеть в Москве»
Частые вопросы
Wordstat API платный?
Сам Wordstat бесплатный, но API доступен только активным рекламодателям Яндекс Директа. Дневные лимиты — от 1000 отчётов в зависимости от баллов аккаунта.
Можно ли без Директа?
Официально — нет. Неофициальные парсеры через браузер работают, но Яндекс может в любой момент закрутить капчу и заблокировать IP. Для серьёзных задач используйте Директ API.
Есть ли альтернативы?
Bukvarix, Mutagen, Key Collector — но это коммерческие сервисы с подпиской, и они тоже опираются на Wordstat-данные.
Как смотреть регион?
Параметр GeoID в запросе. 225 — вся Россия, 213 — Москва, 2 — Санкт-Петербург, полный список — в документации Директа.