# Яндекс Вордстат

Собирайте семантику под новую страницу прямо в чате

Статистика поисковых запросов — топ фраз, динамика, распределение по регионам

## Как агент работает с Яндекс Вордстат

Агент ходит в раздел wordstat Search API Yandex Cloud: отправляет фразу и получает топ запросов с этим словом, похожие формулировки за последние 30 дней, динамику по дням, неделям и месяцам и разрез частотности по регионам и устройствам. Справочник регионов он подтягивает отдельным запросом, чтобы фильтры и названия городов в отчёте совпадали со справочником сервиса, а не подставлялись на глаз.

Вордстат считает показы в поиске, а не людей и не будущий трафик — и агент называет цифру именно так. Частотность широкой фразы вбирает в себя все её уточнения, поэтому число по слову всегда больше суммы конкретных запросов, а смена региона переписывает картину целиком. К каждому числу агент проговаривает период и регион, из которых оно взято, чтобы сравнение вариантов названия шло на одной базе.

Писать здесь нечего и агент не притворяется, что может: он не создаёт и не меняет ничего в Yandex Cloud, ключ используется только на запросы статистики. Работа целиком аналитическая — собрать семантику под новую страницу, увидеть подъёмы и провалы спроса раньше, чем они дойдут до выручки, найти регионы, где спрос выше вашей доли присутствия, и сравнить несколько формулировок услуги до запуска.

Ключ уходит заголовком авторизации в каждый запрос и хранится зашифрованным; отзыв ключа в облаке гасит подключение сразу, а дальше статистики доступ всё равно не тянется — область ключа этим и ограничена. Обращения намеренно разрежены — порядка одного запроса в полминуты, — так что длинный список фраз набирается постепенно, а тарификация идёт по факту обращений. Пустую выдачу по фразе агент называет прямо, а не выдаёт её за отсутствие спроса.

## Сценарии интеграции

### Семантика под новую страницу
Агент соберёт топ фраз с вашим ключевым словом и похожие запросы за последние 30 дней и покажет, какими формулировками вас ищут.

### Сезонность спроса
Агент построит динамику запросов по дням, неделям или месяцам и покажет подъёмы и провалы раньше, чем они дойдут до выручки.

### Спрос по регионам
Агент разложит частотность фраз по регионам и городам и покажет, где спрос выше, чем ваша нынешняя доля присутствия.

### Проверка формулировок перед запуском
Агент сравнит частотность нескольких вариантов названия или услуги и покажет, какой из них ищут, а какой в поиске почти не встречается.

### Спрос с телефонов
Агент разложит частотность фразы по устройствам и покажет, какая доля спроса приходит с телефонов, а какая с десктопа, — за один период и регион.

### Длинный список фраз
Агент наберёт частотность по списку из сотен фраз постепенно, примерно по запросу в полминуты, и вернёт готовую таблицу, не упёршись в лимит сервиса.

## Как подключить

**Перед подключением**

- Аккаунт Yandex Cloud с правами администратора каталога.
- Облако, привязанное к платёжному аккаунту: Search API платный.

### Заведите сервисный аккаунт в Yandex Cloud
Консоль Yandex Cloud → «Identity and Access Management» → «Сервисные аккаунты» → «Создать сервисный аккаунт».

### Дайте аккаунту роль search-api.webSearch.user
На каталоге назначьте сервисному аккаунту роль search-api.webSearch.user. Устаревшую search-api.executor не используйте.

### Создайте API-ключ и сохраните его сразу
В карточке аккаунта: «Создать новый ключ» → «Создать API-ключ», в поле «Область действия» выберите yc.search-api.execute. Ключ показывается один раз.

### Скопируйте Folder ID каталога
В консоли откройте нужный каталог — идентификатор показан под названием и копируется по клику. Строка примерно из 20 символов, начинается с b1.

## Частые вопросы

### Как подключить Яндекс Вордстат?
Двумя значениями из Yandex Cloud: API-ключ сервисного аккаунта, начинающийся с AQVN, и идентификатор каталога Folder ID. Аккаунту нужна роль search-api.webSearch.user, а ключ создаётся с областью действия yc.search-api.execute.

### Что агент получает из Вордстата?
Частотность поисковых фраз и похожие запросы, динамику по дням, неделям и месяцам, разрез по регионам и устройствам и справочник регионов для фильтров.

### Пишет ли агент что-то в сервис?
Нет, это справочная статистика: агент отправляет фразу и получает цифры спроса. Создавать или менять что-либо в Yandex Cloud он не может — ключ используется только для запросов Search API.

### Почему большой список фраз собирается долго?
Обращения к Search API намеренно разрежены во времени, поэтому пачка фраз набирается постепенно. Запросы тарифицируются по факту, а облако должно быть привязано к платёжному аккаунту.

[Открыть Яндекс Вордстат](https://console.yandex.cloud)