Сбор семантики через Wordstat API с агентом: пошаговая инструкция

Семантику собирают для структуры сайта под поиск, рекламы в Яндекс Директе и анализа ниши. Данные для неё есть в Яндекс Вордстате, и собирать их можно через API: подключаете Wordstat API, отдаёте ключ Claude через скилл, и он собирает спрос вашей ниши, чистит запросы и раскладывает их по страницам. По этому принципу собран мой сайт: 6 015 запросов, после чистки 5 450, и у каждого есть своя страница.
Зачем смотреть спрос
Для сайта спрос — это SEO-структура: какие страницы делать и под какие запросы. Что люди ищут и какими словами, нужно учесть на сайте до того, как писать тексты. Те же данные нужны для Яндекс Директа, чтобы подобрать запросы для рекламы, и для анализа ниши: что в ней ищут и как меняется спрос.
Руками в Wordstat приходится вбивать запросы по одному, выгружать их в таблицу и чистить, и уходит на это несколько дней. Я сделал скилл для Wordstat и подключил API Яндекса. Теперь семантику собирает агент: проходит по запросам, чистит их и раскладывает по страницам, и всё это очень быстро.
Как подключить Wordstat API Яндекса
Wordstat по API работает через Yandex AI Studio, это часть Yandex Cloud. Шаги по официальной документации:
-
Войдите в AI Studio через Яндекс ID и создайте организацию: укажите её название и название облака. Внутри сразу появится каталог
default. -
Привяжите платёжный аккаунт. В правом верхнем углу нажмите «Привязать платежный аккаунт» → «Добавить карту». Статус аккаунта должен быть ACTIVE или TRIAL_ACTIVE, без этого Wordstat отвечает ошибкой доступа.
-
Создайте API-ключ. В правом верхнем углу нажмите «Создать API-ключ», выберите срок действия и нажмите «Создать». Вместе с ключом сервис сам создаст сервисный аккаунт с ролью
search-api.webSearch.user: именно она открывает доступ к Wordstat. Секретный ключ показывают один раз, поэтому сохраните его сразу и никому не передавайте.
-
Скопируйте идентификатор каталога. Наведите курсор на название каталога вверху экрана и нажмите на значок копирования. Идентификатор начинается с
b1g.
Claude понадобятся только ключ и идентификатор каталога.
Сколько стоит и какие лимиты
API платный. Цены Яндекса с НДС на октябрь 2026:
- топ запросов по фразе — 20 ₽ за 1 000 запросов;
- динамика спроса — тоже 20 ₽ за 1 000;
- распределение спроса по регионам — 50 ₽ за 1 000.
Всё ядро моего сайта — это 130 запросов к Wordstat, по текущим ценам меньше 3 рублей. Лимит — 100 запросов в час, поэтому большой сбор идёт с паузой: на лимите агент ждёт и продолжает.
Как дать ключ Claude: скилл Wordstat
Скилл — это инструкция и небольшой скрипт. Claude читает в нём, как обращаться к Wordstat, и сам отправляет запросы. Свой скилл я отдаю целиком, в архиве три файла:
SKILL.md— инструкция для Claude: какие запросы есть и как их отправлять;scripts/wordstat.py— скрипт, который отправляет запросы в Wordstat API;references/setup.md— как получить ключ и идентификатор каталога, на английском.
Скачать скилл — архив пришлёт бот в Telegram.
Как поставить:
-
Отправьте архив Claude и напишите: «Установи этот скилл».
-
Сохраните ключ и идентификатор каталога. В файлах скилла ключа нет, скрипт берёт оба значения из переменных окружения
YC_API_KEYиYC_FOLDER_ID. Как их задать, Claude подскажет сам. Ключ в чат не вставляйте: у меня ключи лежат в отдельном файле, агент их не читает и не выводит. -
Проверьте запросом к Claude: «Покажи частотность запроса „семантическое ядро“ по России». В ответ придёт таблица: популярные запросы с этой фразой за последние 30 дней и похожие запросы, которые ищут рядом.
Ещё скилл умеет показывать динамику: как менялся спрос по дням, неделям или месяцам.
Вручную скилл ставится так: папка yandex-wordstat из архива кладётся в .claude/skills проекта.
Как Claude собирает семантику ниши
Ядро для моего сайта агент собирал так:
- Исходные фразы по каждой услуге. 95 фраз в 11 группах: внедрение, автоматизация, агенты, Claude, контент, визуал, сайты, обучение и другие.
- По каждой фразе до 200 запросов из Wordstat и похожие запросы.
- Вторая волна. Из собранного агент берёт самые частотные запросы, от 700 показов в месяц, которых ещё не было в списке, и по каждому собирает то же самое.
- Каждый ответ сохраняется в файл. Если сбор прервался, при повторном запуске уже собранное заново не запрашивается, и деньги с лимитом на это не уходят. Упёрся в лимит — ждёт 10 минут и продолжает.
Для своей ниши можно начать с такого запроса к Claude:
Собери спрос моей ниши через скилл Wordstat. Ниша: <чем вы занимаетесь>. Регион: <вся Россия или город>.
- Составь исходные фразы по группам: одна группа на каждую услугу или продукт.
- По каждой фразе возьми до 200 популярных запросов и похожие запросы за последние 30 дней.
- Сделай вторую волну по самым частотным находкам, которых ещё нет в списке.
- Каждый ответ сохраняй в файл, чтобы повторный запуск не тратил запросы. Лимит — 100 запросов в час: упёрся — подожди и продолжи.
- Почисти: убери «бесплатно», «скачать», чужие отрасли и запросы не по теме.
- У каждого запроса отметь тип (купить или узнать), группу и страницу сайта. Сведи всё в таблицу «страница · тип · группа · запрос · частота» и отсортируй по частоте.
Чистка и разбивка по страницам
В сыром сборе много мусора: из 6 015 запросов после чистки осталось 5 450. Агент убирал:
- запросы со словами «бесплатно», «скачать», «торрент», «реферат»;
- чужие отрасли: 1С, станки с ЧПУ, автосервисы, рестораны и всё, что к моим услугам не относится;
- шум: рядом с «ии ассистент» Wordstat выдаёт запросы вроде «ии ассистент глиф» и «все о дзене», к теме они не относятся.
Потом у каждого запроса появляются тип и страница. Тип агент определяет по словам: «заказать», «цена», «под ключ», «услуги», «для бизнеса» — человек ищет, у кого купить. Остальные запросы информационные: человек хочет разобраться сам. Коммерческие запросы ведут на страницы услуг, информационные — в блог.
Вот как это выглядит в моём ядре:
| Запрос | Показов в месяц | Тип | Страница |
|---|---|---|---|
| создание ии агента | 4 010 | купить | услуга «ИИ-агент для бизнеса» |
| как создать ии агента | 4 009 | узнать | статья «Как создать ИИ-агента» |
| внедрение ии в бизнес | 1 251 | купить | услуга «Внедрение ИИ в бизнес» |
| claude code | 66 497 | узнать | статья о Claude Code |
Первые два запроса почти совпадают и по словам, и по частоте, но один человек ищет исполнителя, а другой хочет сделать сам. Поэтому они ведут на разные страницы.

Как это легло в структуру сайта
Из ядра вышло 10 групп спроса, и каждая привязана к странице сайта:
- шесть страниц услуг — под коммерческие запросы;
- блог — под информационные: так появилась статья «Как создать ИИ-агента» под запрос с 4 тысячами показов в месяц;
- страница «Вопросы» — из самых частотных вопросов в Вордстате.
По ядру видно, что запросов «купить услугу» мало, а информационных много. Поэтому трафик и доверие собирают статьи и инструкции, а страницы услуг и кейсов ловят тех, кто уже ищет исполнителя. Подробнее, с цифрами, — в кейсе о семантическом ядре.
Регулярный сбор: динамика спроса
Собирать семантику можно регулярно и смотреть динамику. Тот же скилл показывает, как менялась частота запроса по месяцам. Например, «claude code» в октябре 2025 года искали 10 246 раз в месяц, в апреле 2026-го — 93 366, в сентябре — 65 222. По таким цифрам видно, какие темы растут, а какие идут на спад, и по ним вы делаете выводы для сайта и контента. Регулярный срез можно отдать агенту, и он будет собирать спрос по расписанию.
Если нужны семантика и структура под ваш сайт, это можно обсудить: сайт или лендинг под поиск.
Частые вопросы
Wordstat API бесплатный?
Нет. Нужен платёжный аккаунт в Yandex Cloud с привязанной картой. Топ запросов по фразе и динамика стоят 20 ₽ за 1 000 запросов, распределение по регионам — 50 ₽ за 1 000. Всё семантическое ядро моего сайта — 130 запросов к Wordstat, по текущим ценам это меньше 3 рублей.
Сколько запросов к Wordstat можно отправить?
По квоте Yandex Search API — 100 запросов в час и 10 в секунду. Если нужно больше, квоту увеличивают через техническую поддержку Yandex Cloud.
Можно ли посмотреть спрос по своему городу?
Да. В запросе указывается регион: 225 — вся Россия, 213 — Москва, 2 — Санкт-Петербург. Отдельно можно смотреть запросы с компьютеров, телефонов или планшетов.
Без агента Wordstat API работает?
Да. API можно вызвать запросом из терминала, пример есть в документации Yandex AI Studio. Агент нужен, чтобы не отправлять сотню запросов по одному и не чистить таблицу руками.