Инструкция: инструмент «Сбор ключей»

Инструмент «Сбор ключей» подбирает ключевые фразы из Яндекс Wordstat через API Яндекс.Директ v4. Результат — таблица фраз с частотностью (количество показов за последний месяц), как в левой колонке Wordstat «что искали вместе с фразой».

Важно: для работы нужен подключённый аккаунт Яндекс.Директ с OAuth-токеном. Если аккаунт не подключён, сервис перенаправит в личный кабинет на страницу подключения.

Как пользоваться

  1. Откройте инструмент: /keyword-parser.
  2. В поле «Ключевая фраза» введите один или несколько запросов — каждая фраза с новой строки, например:
    ремонт квартир
    отделка квартир
  3. Выберите регион (по умолчанию — Россия). Можно найти регион через поле поиска над списком.
  4. При необходимости включите галки в блоке настроек (см. разделы ниже).
  5. Нажмите «Подобрать».
  6. Дождитесь результата (см. раздел «Парсинг на сервере» — время ожидания зависит от выбранного режима).
  7. Результаты появятся в таблице: колонка «Группа» (исходная фраза из поля ввода), ключевая фраза из Wordstat и частотность. Строки сгруппированы по исходным фразам, внутри группы — по убыванию частотности.

На странице инструмента есть кнопка «Инструкция» — она ведёт на эту страницу.

Расширенная выдача (топ-10)

Галка: «Расширить выдачу: дополнительно спарсить топ-10 фраз из первого отчёта».

Если галка включена, для каждой исходной фразы (каждой строки в поле ввода) инструмент работает в два этапа:

  1. Сначала собирается обычная выдача по этой фразе.
  2. Из неё берутся 10 самых частотных ключей.
  3. По этим 10 фразам запрашивается второй отчёт Wordstat.
  4. Результаты добавляются в ту же группу (исходная фраза). Дубликаты удаляются внутри группы, сортировка — по группам в порядке ввода, внутри группы по частотности.

Расширенный режим даёт больше уникальных ключей, но расходует больше баллов API и работает дольше (обычно до 2 минут в обычном режиме, в фоновом — аналогично по времени на стороне сервера).

Парсинг на сервере

Галка: «Парсинг на сервере: сохранять настройки и итог».

Этот режим предназначен для длительных запросов: парсинг выполняется в фоне на сервере, а не в открытой вкладке браузера.

Что сохраняется (для вашего аккаунта AdPump):

  • ключевая фраза;
  • выбранный регион;
  • состояние галки «Расширить выдачу»;
  • состояние галки «Парсинг на сервере»;
  • последние 5 выдач — каждая со своей таблицей, датой и итогом (total); более старые автоматически удаляются.

Как работает пошагово

  1. Включите галку «Парсинг на сервере».
  2. Заполните фразу и регион, при необходимости включите «Расширить выдачу».
  3. Нажмите «Подобрать».
  4. Задача ставится в очередь на сервере. На странице появится сообщение, что парсинг выполняется в фоне.
  5. Вкладку можно закрыть — парсинг продолжится на сервере.
  6. После завершения:
    • результат сохранится на сервере;
    • в шапке сайта в колокольчике уведомлений () появится сообщение «Сбор ключей готов» со ссылкой на конкретную выдачу и кнопкой «Открыть результат»;
    • при ошибке придёт уведомление «Ошибка сбора ключей» с текстом причины.
  7. Откройте /keyword-parser снова — форма подставится автоматически, последняя выдача откроется в таблице (или нажмите «Открыть результат» в уведомлении / в блоке истории).

Если вкладка остаётся открытой

  • страница сама опрашивает статус задачи каждые 5 секунд;
  • после завершения таблица появится без перезагрузки;
  • колокольчик уведомлений обновится (проверка непрочитанных — каждые 30 секунд на всех страницах сайта).

Уведомления в колокольчике

  • Клик по колокольчику в шапке загружает список последних уведомлений.
  • Уведомление о готовом парсинге содержит ссылку на конкретную выдачу (адрес вида /keyword-parser?result=...) и метку «Открыть результат».
  • Та же кнопка «Открыть результат» есть на странице /notifications (ссылка «Показать все» в выпадающем меню колокольчика).

Последние 5 выдач

Если включена галка «Парсинг на сервере», на странице инструмента появляется блок «Последние выдачи».

  • Хранится до 5 последних успешных парсингов для вашего аккаунта.
  • В таблице для каждой выдачи: запрос, количество фраз, дата и время.
  • Кнопка «Открыть результат» загружает сохранённую таблицу без повторного запроса к Wordstat.
  • Текущая открытая выдача подсвечивается в списке.
  • Ссылка из уведомления (?result=...) сразу открывает нужную выдачу при заходе на /keyword-parser.
  • При новом парсинге выдача добавляется в начало списка; если выдач больше 5 — самая старая удаляется.

Если галка выключена

  • парсинг выполняется синхронно: нужно дождаться ответа в той же вкладке (обычно 30–60 секунд, с расширенной выдачей — до 2 минут);
  • настройки и результаты не сохраняются на сервере — при обновлении страницы таблица пропадёт, блок «Последние выдачи» не отображается;
  • уведомление в колокольчик не отправляется.

Одновременные запуски

Если парсинг на сервере уже выполняется (статус «в очереди» или «выполняется»), повторный запуск будет отклонён — дождитесь завершения текущей задачи или откройте страницу позже и посмотрите результат.

Что означает «Частотность»

Число в колонке «Частотность» — показы по фразе за прошедший месяц (данные Wordstat через Direct API v4, поле SearchedWith).

В заголовке таблицы отображается итог: «Результаты (N)», где N — количество уникальных фраз в выдаче. При сохранении на сервере рядом может отображаться время сохранения.

Ограничения

  • Один отчёт Wordstat v4 возвращает до ~200 фраз; параметра «вернуть 2000» в этом API нет.
  • Расширенная выдача увеличивает число уникальных ключей за счёт второго отчёта, но не снимает лимит API на один отчёт.
  • На аккаунте должны быть доступны баллы API Яндекс.Директ.
  • В поле «Ключевая фраза» — до 20 фраз (по одной на строку), каждая до 200 символов.
  • Одновременно на сервере Яндекса может быть не более 5 отчётов Wordstat — инструмент удаляет старые отчёты автоматически.
  • В режиме «Парсинг на сервере» одновременно может выполняться только одна задача на пользователя.
  • В режиме «Парсинг на сервере» сохраняется не более 5 последних выдач на пользователя.
  • Фоновые задачи обрабатываются очередью Laravel на сервере; при большой нагрузке старт может занять до 1 минуты после постановки в очередь.

Типичные ошибки

Нет OAuth / аккаунт не подключён Подключите Яндекс.Директ в личном кабинете.
Недостаточно баллов API Попробуйте позже или подключите другой аккаунт Директа.
Превышено время ожидания отчёта Wordstat на стороне Яндекса формирует отчёт дольше обычного — повторите запрос через минуту. В фоновом режиме проверьте уведомление или откройте страницу инструмента позже.
Парсинг уже выполняется Дождитесь завершения текущей фоновой задачи. Результат появится в уведомлении и на странице /keyword-parser.
Закрыл вкладку — где результат? Откройте /keyword-parser, блок «Последние выдачи» или колокольчик уведомлений — нажмите «Открыть результат».
Выдача не найдена Сохранённый результат уже удалён из истории (хранится только 5 последних). Запустите парсинг заново.

Краткая схема режимов

Настройка Галка выключена Галка включена
Парсинг на сервере Синхронно в браузере, без сохранения Фоново на сервере, с сохранением и уведомлением
Расширить выдачу Один отчёт Wordstat Два отчёта: исходная фраза + топ-10 из первой выдачи
Можно закрыть вкладку Нет — запрос прервётся Да
Уведомление в колокольчик Нет Да, с кнопкой «Открыть результат»
История выдач Нет До 5 последних, кнопка «Открыть результат»

История изменений

  • 26.06.2026 — несколько фраз в поле ввода (с новой строки), колонка «Группа» в результатах.
  • 26.06.2026 — история последних 5 выдач, кнопка «Открыть результат» в инструменте и уведомлениях, ссылки ?result=....
  • 26.06.2026 — парсинг на сервере в фоне, сохранение настроек, уведомления в колокольчик.
  • 25.06.2026 — первая версия инструкции: базовый подбор, регион, расширение по топ-10 фраз.
Перейти в инструмент