Commercial Demand Research

---
name: commercial-demand-research
description: Исследование коммерческого спроса по нише, географии, товару или услуге через Wordstat до перехода к рекламной семантике.
---

# Исследование коммерческого спроса

Этот навык отвечает на вопросы о существующем спросе и сегментах рынка. Для кампаний, объявлений, бюджетов и работы с кабинетом используйте `yandex-direct-unified` после завершения исследования.

## Порядок

1. Пройти общий preflight навыков.
2. Проверить, какой провайдер Wordstat подключён (официальный Wordstat второго поколения через Yandex Cloud или XMLRiver) и какие закрытые файлы доступа указал пользователь. Установить продукт или услугу, географию, язык, исключения и результат из запроса и имеющихся данных; спрашивать только о том, что существенно меняет работу.
3. Проверить Wordstat маленьким запросом чтения.
4. Собрать исходные данные до сегментов, рекомендаций и стоп-слов.
5. Сохранить каждый ответ, запрос, географию, язык, время и способ сбора.
6. Классифицировать каждую строку ровно в один слой: `validated_service_demand`, `excluded_noise` или `doubtful`.
7. Сверить покрытие и только затем строить выводы и передачу в рекламу.

## Сбор

- первая волна использует 5–10 однословных масок из карты продукта;
- связанные слова новой волны сначала проходят ручную проверку;
- все строки сохраняются в `raw/`, а общий реестр — в `data/all_phrases.csv`;
- ограничения, ошибки и неполный ответ фиксируются явно;
- при недоступном источнике данные не заменяются догадками или поисковыми фрагментами.

Артефакты сбора включают `raw/*.json`, `data/all_phrases.csv`, `data/collection_summary.json`, исходную маску, географию, язык, дату и способ получения. Сбор продолжается волнами, пока новые проверенные маски добавляют существенную коммерческую лексику либо зафиксирован реальный блокер доступа или квоты.

## Анализ

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

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

Исполнители частей не имеют права придумывать строки, заменять построчную классификацию кратким пересказом, переносить сомнительные строки в подтверждённый спрос или самостоятельно выпускать окончательную агрегацию. Неполная часть, повторные ключи, потерянные граничные строки и изменение схемы отклоняются.

## Правила из практики

- **Только маски.** Если пользователь разрешил только маски и предварительное исследование, Wordstat не запускается: никаких фиктивных сырых файлов, частотностей и статуса полного покрытия, результат не называется полной семантикой. Сохраняются список масок, обоснование и доступные источники конкурентов и отзывов; гипотезы и недостающие измерения помечаются.
- **Ошибка доступа.** При ошибке доступа, квоты или транспорта посмотреть фактический ответ и сохранённое состояние, оставить успешные данные и повторить затронутый запрос. Сбой одного вызова не блокирует задачу. Если сбор действительно недоступен — записать, каких данных нет, продолжить независимую работу и вернуться к сбору после восстановления доступа. Спрос не подменяется фрагментами выдачи, догадкой, общими трендами или чужим аккаунтом.
- **Спрос ≠ готовность рекламы.** Фраза может показывать реальный спрос на покупку, закупку, стоимость, сравнение или смежную услугу и при этом быть слишком широкой, информационной, регулируемой или непригодной для немедленной рекламы. Такой спрос не исключается из бизнес-картины: слой спроса сохраняется, готовность рекламы, сайта и предложения помечается отдельно.
- **Ограничения модерации не останавливают сбор.** Юридические ограничения и запрещённые формулировки ограничивают будущие тексты и запуск, но не повод прекращать сбор или отфильтровывать задачи клиентов, пока цель — узнать, чего хотят клиенты. Ограничения записываются отдельно, спрос классифицируется по исходным строкам.
- **Уровни доказательств.** Если исследование питает позиционирование, не смешивать работающий прототип, пилот с одним клиентом, модульный тест, узкий живой тест и полный пользовательский сценарий. Аудитория, рынок или предложение не «подтверждены» по одному клиенту. Перед публичным позиционированием — матрица: исходные строки, реализованная возможность, покрытие тестами, живое подтверждение, оставшиеся допущения.
- **Мониторинговый и закупочный спрос.** Региональные, отраслевые, тендерные, реестровые, ценовые и поставщиковые запросы и запросы на доступ к данным могут быть реальным спросом на мониторинг, даже если это не прямая покупка услуги. Они хранятся в отдельном слое или помечаются `doubtful` с причиной; исключаются только после подтверждения, что это навигация, посторонний бренд или площадка либо вне оцениваемой услуги.
- **Независимая классификация.** Каждая фраза классифицируется по своему тексту, строке источника, маске и записанному контексту. Роль покупателя, маршрут, посадочная, коммерческий статус и сегмент не наследуются от маски, соседних строк, названия части или ожидаемого итога. Повторяющиеся нормализованные фразы из разных масок, частей и волн сводятся до агрегации: одно каноническое решение с доказательством либо журнал конфликтов с объяснением, почему решения законно различаются.
- **Помощники.** Ориентир — одна часть на 4000 фраз. Помощники классифицируют подготовленные части после завершения сбора и не используют необъявленные модели и побочные каналы. Перед приёмкой механически проверяются точное число строк, устойчивые идентификаторы, порядок, уникальность, обязательные поля, сохранность фразы и маски, распределение по слоям.
- **Трассировка вниз по цепочке.** Если исследование питает план сайта, предложения или рекламы, каждый крупный подтверждённый сегмент получает `include`, `defer` или `reject` с причиной и целевым артефактом; исчезновение сегмента без решения — блокер. Для рекламного плана ядровые и тестовые фразы и характерные частотные строки сопоставляются со статусом маршрута, кампанией или экспериментом, группой, посадочной и следующим действием. Смешанные статусы (`core`, `test`, `first_launch`, `separate_test`) сводятся к одному однозначному правилу запуска либо остаются заблокированными. Смысловое соответствие проверяется вручную.
- **Детализация потребностей.** Каждая отдельная потребность прослеживается ниже уровня широких категорий: доказательства рекламы конкурентов, точная рекламная посадочная, предложенная страница и вход прогноза — либо запись, почему шаг неприменим. Назначение строк по словарю «категория → страница» доказывает только назначение. Объединение разных потребностей на одной странице требует обоснования. Потолка в 3–5 страниц и квоты в 15–20 нет. При изменении семантики покрытие и прогнозы недействительны до перепроверки.
- **Доля слова ≠ спрос.** Доля строк со словом (например, «цена» или «отзывы») — не доля посетителей, спроса или готовности к покупке. Называть знаменатель и правило совпадения; выводы о дизайне формулировать как гипотезы с контраргументами и пределами источника.
- **Ключ строки.** Ссылаясь на выбранную вручную строку источника, закреплять и перечитывать и ключ строки, и точный текст фразы: номер строки может указывать на посторонний запрос. Обзор посадочной привязывается к точному запросу и метке потребности, прочитанным из текущей записи; запрос хранится рядом с обзором.
- **Повторное использование проекта.** Перед утверждениями о покрытии сверять датированные сводки и выборки «верхних фраз» с последней картой «фраза → группа или страница». Поле из 15 примеров — не полный список ключей. Выгружать актуальное подмножество целиком, с точными фразами и строками источника; прежние числа и прогнозы, описывавшие другой набор, помечать заменёнными.

Связанная задача (спрос, рекламные конкуренты, посадочные, доработки сайта, медиаплан) — по [справочнику связанного исследования](references/client-research-workflow.md).

## Результат

- рабочая таблица с фильтрацией, поиском, сортировкой и полными фразами;
- отдельные слои подтверждённого спроса, шума и сомнительных строк;
- сегмент, объём, доля, основные фразы, исходные маски, сезонность и причина статуса;
- таблица передачи `include|defer|reject` с причиной и точным целевым артефактом;
- для рекламы — точный маршрут до кампании, группы и посадочной страницы либо явный блокер.

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

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

## Проверка

1. Повторно сверить продукт, географию, язык и исключения с метаданными сбора.
2. Доказать, что каждая исходная строка представлена ровно в одном слое.
3. Убедиться, что итоговые сегменты используют только `validated_service_demand`.
4. Вручную просмотреть самые значимые исключённые и сомнительные строки.
5. Проверить поиск, фильтры, сортировку, раскрытие и выгрузку рабочей поверхности.
6. Просканировать артефакты на ключи, токены, файлы сеанса и частные идентификаторы.

## Типовые ошибки

- использование составной фразы вместо широкой исходной маски;
- сегменты и стоп-слова, придуманные до сбора;
- смешение шума с подтверждённым спросом;
- выводы без полного построчного реестра;
- переход к рекламной семантике до подтверждения бизнес-спроса;
- исчезновение крупного сегмента из последующего плана без решения `include|defer|reject`.

Перед завершением проверить, что каждая исходная строка представлена ровно один раз, верхние исключённые и сомнительные строки просмотрены вручную, а в артефактах нет доступов и частных идентификаторов.