Все статьи

22 октября 2026 г. · 7 мин чтения · Артём Гапоненко

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

Обложка статьи «Сбор семантики через Wordstat»: задача агенту и таблица семантического ядра с запросами, частотой, типом и страницей

Семантику собирают для структуры сайта под поиск, рекламы в Яндекс Директе и анализа ниши. Данные для неё есть в Яндекс Вордстате, и собирать их можно через API: подключаете Wordstat API, отдаёте ключ Claude через скилл, и он собирает спрос вашей ниши, чистит запросы и раскладывает их по страницам. По этому принципу собран мой сайт: 6 015 запросов, после чистки 5 450, и у каждого есть своя страница.

Зачем смотреть спрос

Для сайта спрос — это SEO-структура: какие страницы делать и под какие запросы. Что люди ищут и какими словами, нужно учесть на сайте до того, как писать тексты. Те же данные нужны для Яндекс Директа, чтобы подобрать запросы для рекламы, и для анализа ниши: что в ней ищут и как меняется спрос.

Руками в Wordstat приходится вбивать запросы по одному, выгружать их в таблицу и чистить, и уходит на это несколько дней. Я сделал скилл для Wordstat и подключил API Яндекса. Теперь семантику собирает агент: проходит по запросам, чистит их и раскладывает по страницам, и всё это очень быстро.

Как подключить Wordstat API Яндекса

Wordstat по API работает через Yandex AI Studio, это часть Yandex Cloud. Шаги по официальной документации:

  1. Войдите в AI Studio через Яндекс ID и создайте организацию: укажите её название и название облака. Внутри сразу появится каталог default.

  2. Привяжите платёжный аккаунт. В правом верхнем углу нажмите «Привязать платежный аккаунт» → «Добавить карту». Статус аккаунта должен быть ACTIVE или TRIAL_ACTIVE, без этого Wordstat отвечает ошибкой доступа.

  3. Создайте API-ключ. В правом верхнем углу нажмите «Создать API-ключ», выберите срок действия и нажмите «Создать». Вместе с ключом сервис сам создаст сервисный аккаунт с ролью search-api.webSearch.user: именно она открывает доступ к Wordstat. Секретный ключ показывают один раз, поэтому сохраните его сразу и никому не передавайте.

    Кнопка «Создать API-ключ» в правом верхнем углу Yandex AI Studio

  4. Скопируйте идентификатор каталога. Наведите курсор на название каталога вверху экрана и нажмите на значок копирования. Идентификатор начинается с b1g.

    Подсказка «Копировать идентификатор каталога» у названия каталога default в Yandex AI Studio

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.

Как поставить:

  1. Отправьте архив Claude и напишите: «Установи этот скилл».

  2. Сохраните ключ и идентификатор каталога. В файлах скилла ключа нет, скрипт берёт оба значения из переменных окружения YC_API_KEY и YC_FOLDER_ID. Как их задать, Claude подскажет сам. Ключ в чат не вставляйте: у меня ключи лежат в отдельном файле, агент их не читает и не выводит.

  3. Проверьте запросом к Claude: «Покажи частотность запроса „семантическое ядро“ по России». В ответ придёт таблица: популярные запросы с этой фразой за последние 30 дней и похожие запросы, которые ищут рядом.

Ещё скилл умеет показывать динамику: как менялся спрос по дням, неделям или месяцам.

Вручную скилл ставится так: папка yandex-wordstat из архива кладётся в .claude/skills проекта.

Как Claude собирает семантику ниши

Ядро для моего сайта агент собирал так:

  1. Исходные фразы по каждой услуге. 95 фраз в 11 группах: внедрение, автоматизация, агенты, Claude, контент, визуал, сайты, обучение и другие.
  2. По каждой фразе до 200 запросов из Wordstat и похожие запросы.
  3. Вторая волна. Из собранного агент берёт самые частотные запросы, от 700 показов в месяц, которых ещё не было в списке, и по каждому собирает то же самое.
  4. Каждый ответ сохраняется в файл. Если сбор прервался, при повторном запуске уже собранное заново не запрашивается, и деньги с лимитом на это не уходят. Упёрся в лимит — ждёт 10 минут и продолжает.

Для своей ниши можно начать с такого запроса к Claude:

Собери спрос моей ниши через скилл Wordstat. Ниша: <чем вы занимаетесь>. Регион: <вся Россия или город>.

  1. Составь исходные фразы по группам: одна группа на каждую услугу или продукт.
  2. По каждой фразе возьми до 200 популярных запросов и похожие запросы за последние 30 дней.
  3. Сделай вторую волну по самым частотным находкам, которых ещё нет в списке.
  4. Каждый ответ сохраняй в файл, чтобы повторный запуск не тратил запросы. Лимит — 100 запросов в час: упёрся — подожди и продолжи.
  5. Почисти: убери «бесплатно», «скачать», чужие отрасли и запросы не по теме.
  6. У каждого запроса отметь тип (купить или узнать), группу и страницу сайта. Сведи всё в таблицу «страница · тип · группа · запрос · частота» и отсортируй по частоте.

Чистка и разбивка по страницам

В сыром сборе много мусора: из 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. Агент нужен, чтобы не отправлять сотню запросов по одному и не чистить таблицу руками.