commercial-demand-research
Исследование коммерческого спроса по нише, географии, товару или услуге через Wordstat до перехода к рекламной семантике.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- commercial-demand-research
- description
- Исследование коммерческого спроса по нише, географии, товару или услуге через Wordstat до перехода к рекламной семантике.
02 资源文件 2
- 参考文档agents/openai.yaml490 B
- 参考文档references/client-research-workflow.md19.8 KB
03 SKILL.md 正文
Исследование коммерческого спроса
Этот навык отвечает на вопросы о существующем спросе и сегментах рынка. Для кампаний, объявлений, бюджетов и работы с кабинетом используйте yandex-direct-unified после завершения исследования.
Порядок
- Пройти общий preflight навыков.
- Проверить, какой провайдер Wordstat подключён (официальный Wordstat второго поколения через Yandex Cloud или XMLRiver) и какие закрытые файлы доступа указал пользователь. Установить продукт или услугу, географию, язык, исключения и результат из запроса и имеющихся данных; спрашивать только о том, что существенно меняет работу.
- Проверить Wordstat маленьким запросом чтения.
- Собрать исходные данные до сегментов, рекомендаций и стоп-слов.
- Сохранить каждый ответ, запрос, географию, язык, время и способ сбора.
- Классифицировать каждую строку ровно в один слой:
validated_service_demand,excluded_noiseилиdoubtful. - Сверить покрытие и только затем строить выводы и передачу в рекламу.
Сбор
- первая волна использует 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 примеров — не полный список ключей. Выгружать актуальное подмножество целиком, с точными фразами и строками источника; прежние числа и прогнозы, описывавшие другой набор, помечать заменёнными.
Связанная задача (спрос, рекламные конкуренты, посадочные, доработки сайта, медиаплан) — по справочнику связанного исследования.
Результат
- рабочая таблица с фильтрацией, поиском, сортировкой и полными фразами;
- отдельные слои подтверждённого спроса, шума и сомнительных строк;
- сегмент, объём, доля, основные фразы, исходные маски, сезонность и причина статуса;
- таблица передачи
include|defer|rejectс причиной и точным целевым артефактом; - для рекламы — точный маршрут до кампании, группы и посадочной страницы либо явный блокер.
Основной результат — не только текстовый отчёт, а проверяемая рабочая поверхность. Она должна позволять искать и фильтровать фразы, сортировать сегменты, раскрывать исходные строки, отдельно видеть исключённые и сомнительные слои и выгружать таблицу без обрезки значимых фраз.
Таблица содержит как минимум сегмент, подсегмент при необходимости, показы, число фраз, долю, основные фразы, исходные маски, сезонность, слой и причину статуса. Это полный реестр, а не выбранный верхний список.
Проверка
- Повторно сверить продукт, географию, язык и исключения с метаданными сбора.
- Доказать, что каждая исходная строка представлена ровно в одном слое.
- Убедиться, что итоговые сегменты используют только
validated_service_demand. - Вручную просмотреть самые значимые исключённые и сомнительные строки.
- Проверить поиск, фильтры, сортировку, раскрытие и выгрузку рабочей поверхности.
- Просканировать артефакты на ключи, токены, файлы сеанса и частные идентификаторы.
Типовые ошибки
- использование составной фразы вместо широкой исходной маски;
- сегменты и стоп-слова, придуманные до сбора;
- смешение шума с подтверждённым спросом;
- выводы без полного построчного реестра;
- переход к рекламной семантике до подтверждения бизнес-спроса;
- исчезновение крупного сегмента из последующего плана без решения
include|defer|reject.
Перед завершением проверить, что каждая исходная строка представлена ровно один раз, верхние исключённые и сомнительные строки просмотрены вручную, а в артефактах нет доступов и частных идентификаторов.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.