X9 Wb Product Search

x9-wb-product-search — подбор товаров на Wildberries

Работает в Claude Code и Codex. Относительные пути разрешаются от каталога установленного skill.

Машиночитаемый контракт внешних предпосылок: references/onboarding.json.

Базовое поведение, язык и тон — как в AGENTS.md: отвечай по-русски, на «ты», коротко и по делу. Этот навык добавляет рабочий процесс поиска и проверки товаров на Wildberries.

Когда применять

Применяй навык, если пользователь:

• просит подобрать товар на Wildberries или WB;
• хочет топ-3/топ-5/лучший вариант;
• выбирает между несколькими карточками Wildberries;
• просит проверить отзывы, продавца, состав, характеристики, цену за штуку;
• хочет купить набор, коробку, одиночную штуку или пробники.

Определи действие

• «Хочу купить», «что купить», «подбери» и похожие формулировки означают поиск и рекомендацию, а не изменение аккаунта.
• Явная команда добавить выбранный товар в избранное или корзину разрешает именно это действие; проверь нужный вариант и итоговое состояние интерфейса, не спрашивая повторно то же разрешение.
• Перед оформлением или оплатой заказа покажи товар, вариант, количество и итоговую сумму и получи отдельное подтверждение. Не выводи разрешение на покупку из запроса на подбор.

Главный принцип

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

Для WB-поиска предпочитай сортировку «По рейтингу»; «По популярности» — только запасной режим (когда и почему на него переключаться — в §4).

Инструменты

1. Для Wildberries всегда используй реальный залогиненный Chromium-браузер пользователя по CDP. Текущая проверенная конфигурация использует Microsoft Edge; подключение и переносимая настройка принадлежат установленному skill x9-browser-session. Запрещён только встроенный (in-app / computer-use) браузер Codex, отдельный Chromium, Playwright-браузер, публичные поисковые страницы или другой чистый браузер как основной способ проверки WB — цена, наличие, доставка, регион, избранное, корзина и вход зависят от пользовательского сеанса.

2. Перед первой браузерной операцией загрузи x9-browser-session и прочитай указанный в нём setup reference. Они владеют выбором инструмента, подключением к живому браузеру и правилом отдельной вкладки. Специфика WB: не продолжай подбор через другой браузер, пока пользователь не подтвердит запуск настроенного авторизованного Chromium-браузера (в проверенном адаптере — Edge) или явно не разрешит запасной путь без его сеанса — цена, наличие, доставка, регион, избранное и корзина зависят от его сеанса.

3. Открывай карточки WB в отдельной вкладке, не трогая вкладки пользователя (chrome-devtools MCP new_page, либо резерв agent-edge --session main tab new), и уже там ищи, фильтруй и проверяй.

4. Используй браузер для поиска, фильтров, визуальной проверки, отзывов, вариантов товара, продавца и текущего состояния карточки.

5. Можно использовать публичные структурированные данные Wildberries для ускоренного извлечения цены, рейтинга, характеристик и состава, но не подменяй ими проверку карточки и отзывов. В ответе честно скажи, если часть данных взята из карточных данных WB, а часть проверена в браузере.

6. Для составов, спецификаций и официальных характеристик сверяйся с сайтом бренда или производителя, если карточка WB заполнена мутно или противоречиво.

Рабочий процесс

1. Уточни критерии

Если критерии неясны и ошибка покупки будет неприятной, задай 1–3 коротких вопроса. Не превращай это в анкету.

Нужно понять:

• что покупаем и для кого;
• бюджет или ожидаемую цену;
• одиночная штука, пробник, набор или коробка;
• обязательные свойства и запреты;
• что пользователь уже пробовал и что не подошло.

2. Сформируй несколько запросов

Масштабируй поиск по неопределённости задачи. Если пользователь уже дал конкретные карточки или точную модель, сравни их напрямую и добавляй новые запросы только для проверки очевидных альтернатив. Для открытого подбора используй несколько вариантов, пока они дают новых релевантных кандидатов:

• точный запрос пользователя;
• широкий запрос по категории;
• запрос с брендом;
• запрос с форматом, размером, количеством или моделью;
• запрос с ключевым ограничением: «для стерилизованных», «без сахара», «оригинал», «набор 12 шт», «1 шт», «запчасть», «для iPhone 15» и т.п.

3. Выполни поиск в текущем runtime

Не передавай основной workflow другому агенту или runtime. Агент, который загрузил skill, сам выполняет сбор кандидатов, проверку карточек и отзывов, оценку рисков и финальный ответ. Единственное исключение — ограниченная независимая проверка финалистов по правилам шага 8:

• в Claude Code весь workflow выполняет текущая Opus-сессия Claude Code;
• в Codex весь workflow выполняет текущая сессия Codex.

Не вызывай Codex из Claude Code или Claude Code из Codex для основного поиска. Если браузерный инструмент упал или был отменён, сообщи об этом прямо; не подменяй недостающую проверку памятью, публичной выдачей или выводом другого агента.

4. Используй сортировку поиска

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

Не используй «По популярности» как основной режим. Дефолтная выдача WB может быть персонализированной, рекламной или зашумлённой карточками без отзывов.

Используй «По популярности» только как запасной режим, если:

• в «По рейтингу» мало релевантных товаров;
• сверху идут товары с 5.0 и единичными отзывами;
• выдача явно нерелевантна запросу;
• нужно проверить, не пропущен ли массовый очевидный товар;
• пользователь прямо просит сравнить популярные товары.

При сортировке «По рейтингу» всё равно отсекай слабые карточки:

• 5.0 с 1–10 отзывами обычно хуже, чем 4.8–4.9 с сотнями или тысячами релевантных отзывов;
• общий рейтинг карточки не считается надёжным, пока отзывы не проверены по нужному варианту;
• рекламная метка, скидка или высокая позиция в выдаче не являются аргументом качества.

5. Собери пул кандидатов

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

• название и ссылку;
• цену и цену за единицу;
• бренд и продавца;
• рейтинг и число отзывов;
• количество в упаковке, размер, модель или вкус;
• ключевые характеристики, состав или комплектацию;
• дату доставки и наличие, если это влияет на выбор.

Фиксируй также, из какого режима найден кандидат: «По рейтингу», «По популярности» (см. §4 про основной/запасной режим), точный поиск, широкий поиск, брендовый поиск.

Если кандидат найден через «По популярности», проверяй его особенно внимательно: у него должны быть релевантные отзывы, понятный продавец и нормальные характеристики. Не добавляй товар без отзывов в топ только потому, что WB поднял его высоко в дефолтной выдаче.

Дедублируй одинаковые товары у разных продавцов. Если карточки одинаковые, выбирай ту, где лучше сочетание цены, отзывов, продавца и понятности характеристик.

Останови расширение пула, когда выполняется хотя бы одно условие:

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

Если покрытие осталось слабым, верни меньший топ, укажи фактический размер проверенного пула и перечисли недоступные проверки. Пометь результат DEGRADED, а не заполняй топ слабыми товарами ради количества.

6. Проверь отзывы

Отзывы — обязательный этап для итогового топа, если пользователь не попросил специально «без отзывов» или «только официальный состав».

Перед анализом отзывов прочитай references/review-audit.md: там обязательный порядок проверки конкретного варианта товара, признаки смешанной карточки, режимы сортировки отзывов и шаблоны ответа. Без этого шага топ не считается проверенным.

7. Оцени риски карточки

Помечай товар как рискованный, если есть хотя бы один признак:

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

8. Сформируй топ

Перед тем как отдать финальный топ, сверься по каждой позиции:

• выбрана плитка нужного варианта, а не общая вкладка «Все»;
• прочитаны отзывы по сортировкам «Новые» и «С низкой оценкой»;
• фото проверены, если формат/размер/цвет/комплектация важны;
• поле «риск» в ответе заполнено (низкий/средний/высокий).

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

Verifier получает запрос и критерии пользователя, ссылки, выбранные варианты, цены, продавцов, характеристики, краткую выжимку отзывов и причины включения в топ. Он не повторяет поиск и не добавляет кандидатов. Его задача — попытаться опровергнуть выбор: проверить соответствие отзывов варианту, смешение карточек, повторяющиеся жалобы, противоречия характеристик и фото, подделки, упаковку и сроки годности. По каждой позиции он возвращает PASS, DOWNRANK или REJECT с доказательством.

В Claude Code verifier должен быть fresh Opus subagent; в Codex — fresh native subagent. Запускай его последовательно в отдельной task-owned вкладке с доступом к той же авторизованной WB-сессии. Если авторизованный маршрут недоступен, сначала восстанови его, получи разрешение на sessionless fallback или верни DEGRADED/ BLOCKED: subagent не заменяет отсутствующий доступ. Если обязательный verifier не может проверить живые карточки, пометь независимую проверку как DEGRADED.

По умолчанию дай топ-5. Если подходящих товаров меньше, так и скажи. Не набивай топ слабыми карточками ради красивого числа.

Формат:

Короткий вывод: что лучше купить и почему.

Топ-5:
1. Название — ссылка
   Цена / цена за единицу
   Почему подходит
   Характеристики/состав/комплектация
   Отзывы:
   - вариант: подтверждён / смешанная карточка / не удалось отделить
   - новые: что пишут свежие покупатели
   - низкие оценки: повторяющиеся жалобы
   - фото: совпадают ли с товаром, если проверялось
   - риск: низкий / средний / высокий
   Риски

Что не взял:
- товар/тип товара: причина

Мой выбор:
- если брать одну штуку
- если брать набором

Для простого запроса можно сократить ответ до 3–5 пунктов, но не убирай причины выбора и риски.

Правила для разных типов товаров

• Зоотовары и еда: состав важнее маркетинга. Проверяй конкретные ингредиенты, назначение, возраст/вес/состояние животного, формат упаковки, срок годности и жалобы на реакцию.
• Безрецептурные лекарства: проверяй точное наименование, производителя, официальную инструкцию, продавца, срок годности, упаковку и отзывы о подделках или повреждениях. Не ставь диагноз, не назначай лечение и не придумывай персональную дозировку; если выбор зависит от состояния здоровья, прямо укажи, чего карточка WB не позволяет установить.
• Электроника и брендовые товары: проверяй оригинальность, продавца, гарантию, модель, комплектацию и отзывы на конкретный вариант.
• Одежда и обувь: отзывы по размеру, посадке, фото покупателей, материал, возвраты, соответствие размерной сетке.
• Расходники и запчасти: совместимость, размеры, материал, количество в наборе, реальные фото и жалобы на несоответствие.

Честность в ответе

Если данные неполные, скажи прямо: «состав в карточке не раскрыт», «отзывов мало», «есть риск смешанной карточки», «нужно проверить фото/описание перед заказом».

Не делай вид, что товар надёжен, если опора только на рейтинг. Wildberries часто содержит дубликаты, смешанные карточки и слабые характеристики.