xonika9/agent-skills / skills/x9-wb-product-search
x9-wb-product-search
VerifiedПодбирает и сравнивает товары на Wildberries/WB, проверяет карточки, отзывы, продавцов и варианты товара перед покупкой. Не применяется к другим магазинам и общим вопросам о товарах без намерения выбрать или проверить их на WB. В Claude Code требует текущую сессию Opus.
x9-wb-product-search — подбор товаров на Wildberries
Относительные пути разрешаются от каталога установленного skill.
Машиночитаемый контракт внешних предпосылок: references/onboarding.json.
Язык и обращение следуют запросу пользователя и действующим инструкциям. Этот навык определяет поиск и проверку товаров на Wildberries.
Когда применять
Применяй навык, если пользователь:
- просит подобрать товар на Wildberries или WB;
- хочет топ-3/топ-5/лучший вариант;
- выбирает между несколькими карточками Wildberries;
- просит проверить отзывы, продавца, состав, характеристики, цену за штуку;
- хочет купить набор, коробку, одиночную штуку или пробники.
Определи действие
- «Хочу купить», «что купить», «подбери» и похожие формулировки означают поиск и рекомендацию, а не изменение аккаунта.
- Явная команда добавить выбранный товар в избранное или корзину разрешает именно это действие; проверь нужный вариант и итоговое состояние интерфейса, не спрашивая повторно то же разрешение.
- Перед оформлением или оплатой заказа покажи товар, вариант, количество и итоговую сумму и получи отдельное подтверждение. Не выводи разрешение на покупку из запроса на подбор.
Главный принцип
Не выбирай товар только по названию, цене или рейтингу. Сначала собери кандидатов, потом проверь карточку, отзывы и риски. Если два товара похожи, обычно предпочитай карточку с большим числом релевантных отзывов и понятным продавцом, даже если она немного дороже.
Правила сортировки поиска находятся в §4.
Инструменты
-
Для Wildberries используй реальный залогиненный Chromium-профиль пользователя через маршрут, выбранный
x9-browser-session. Не используй отдельный чистый браузер или публичные поисковые страницы как основной способ проверки WB — цена, наличие, доставка, регион, избранное, корзина и вход зависят от пользовательского сеанса. -
Перед первой браузерной операцией загрузи
x9-browser-session: он владеет выбором инструмента, подключением к живому браузеру и правилом отдельной вкладки. Справку по настройке загружай только при установке или изменении адаптера. Специфика WB: не продолжай подбор через другой браузер, пока пользователь не подтвердит запуск настроенного авторизованного Chromium-браузера или явно не разрешит запасной путь без его сеанса — цена, наличие, доставка, регион, избранное и корзина зависят от его сеанса. -
Ищи, фильтруй и проверяй карточки в отдельной вкладке задачи по правилам
x9-browser-session, сохраняя вкладки пользователя. -
Используй браузер для поиска, фильтров, визуальной проверки, отзывов, вариантов товара, продавца и текущего состояния карточки.
-
Можно использовать публичные структурированные данные Wildberries для ускоренного извлечения цены, рейтинга, характеристик и состава, но не подменяй ими проверку карточки и отзывов. В ответе честно скажи, если часть данных взята из карточных данных WB, а часть проверена в браузере.
-
Для составов, спецификаций и официальных характеристик сверяйся с сайтом бренда или производителя, если карточка WB заполнена мутно или противоречиво.
Рабочий процесс
1. Уточни критерии
Если критерии неясны и ошибка покупки будет неприятной, задай 1–3 коротких вопроса. Не превращай это в анкету.
Нужно понять:
- что покупаем и для кого;
- бюджет или ожидаемую цену;
- одиночная штука, пробник, набор или коробка;
- обязательные свойства и запреты;
- что пользователь уже пробовал и что не подошло.
2. Сформируй несколько запросов
Масштабируй поиск по неопределённости задачи. Если пользователь уже дал конкретные карточки или точную модель, сравни их напрямую и добавляй новые запросы только для проверки очевидных альтернатив. Для открытого подбора используй несколько вариантов, пока они дают новых релевантных кандидатов:
- точный запрос пользователя;
- широкий запрос по категории;
- запрос с брендом;
- запрос с форматом, размером, количеством или моделью;
- запрос с ключевым ограничением: «для стерилизованных», «без сахара», «оригинал», «набор 12 шт», «1 шт», «запчасть», «для iPhone 15» и т.п.
3. Выполни поиск в текущем runtime
Не передавай основной workflow другому агенту или runtime. Агент, который загрузил skill, сам выполняет сбор кандидатов, проверку карточек и отзывов, оценку рисков и финальный ответ. Единственное исключение — ограниченная независимая проверка финалистов по правилам шага 8:
- в Claude Code весь workflow выполняет текущая Opus-сессия Claude Code;
- в Codex весь workflow выполняет текущая сессия Codex;
- в OpenCode весь workflow выполняет текущая сессия OpenCode.
В Claude Code текущая модель Opus служит условием готовности. Перед началом
подбора проверь модель текущей сессии по доступным сведениям среды. Если активна
другая модель, Opus недоступен или текущую модель нельзя подтвердить, верни
BLOCKED: укажи, какое условие не выполнено, и что для продолжения нужна текущая
сессия Opus. Не начинай основной поиск, не переключай модель сам и не обходи
это условие передачей работы другой сессии.
Не вызывай для основного поиска другую среду из текущей. Если браузерный инструмент упал или был отменён, сообщи об этом прямо; не подменяй недостающую проверку памятью, публичной выдачей или выводом другого агента.
4. Используй сортировку поиска
После ввода поискового запроса на Wildberries по умолчанию переключай выдачу на «По рейтингу». Для популярных категорий — техника, чай, зубные пасты, щётки, косметика, бытовые товары, расходники — эта сортировка часто лучше поднимает товары с высокой оценкой и большим числом отзывов, чем дефолтная выдача.
Не используй «По популярности» как основной режим. Дефолтная выдача WB может быть персонализированной, рекламной или зашумлённой карточками без отзывов.
Используй «По популярности» только как запасной режим, если:
- в «По рейтингу» мало релевантных товаров;
- сверху идут товары с 5.0 и единичными отзывами;
- выдача явно нерелевантна запросу;
- нужно проверить, не пропущен ли массовый очевидный товар;
- пользователь прямо просит сравнить популярные товары.
При сортировке «По рейтингу» всё равно отсекай слабые карточки:
- 5.0 с 1–10 отзывами обычно хуже, чем 4.8–4.9 с сотнями или тысячами релевантных отзывов;
- общий рейтинг карточки не считается надёжным, пока отзывы не проверены по нужному варианту;
- рекламная метка, скидка или высокая позиция в выдаче не являются аргументом качества.
5. Собери пул кандидатов
Собери достаточно разных релевантных карточек, чтобы новые результаты перестали менять список лучших кандидатов. Для узкого или точного запроса пул может быть небольшим; для открытой категории расширяй его несколькими запросами и режимами сортировки. Не добивай заранее заданное число нерелевантными или дублирующими карточками. Для каждой важной карточки фиксируй:
- название и ссылку;
- цену и цену за единицу;
- бренд и продавца;
- рейтинг и число отзывов;
- количество в упаковке, размер, модель или вкус;
- ключевые характеристики, состав или комплектацию;
- дату доставки и наличие, если это влияет на выбор.
Фиксируй также, из какого режима найден кандидат: «По рейтингу», «По популярности» (см. §4 про основной/запасной режим), точный поиск, широкий поиск, брендовый поиск.
Если кандидат найден через «По популярности», проверяй его особенно внимательно: у него должны быть релевантные отзывы, понятный продавец и нормальные характеристики. Не добавляй товар без отзывов в топ только потому, что WB поднял его высоко в дефолтной выдаче.
Дедублируй одинаковые товары у разных продавцов. Если карточки одинаковые, выбирай ту, где лучше сочетание цены, отзывов, продавца и понятности характеристик.
Останови расширение пула, когда выполняется хотя бы одно условие:
- новые запросы или страницы повторяют уже просмотренные карточки и не меняют список лучших кандидатов;
- найдено достаточно различающихся подходящих кандидатов для запрошенного топа;
- выдача стала нерелевантной или не даёт новых проверяемых данных;
- браузерный маршрут заблокирован, повторяется одна и та же ошибка или исчерпан разумный бюджет задачи.
Если покрытие осталось слабым, верни меньший топ, укажи фактический размер
проверенного пула и перечисли недоступные проверки. Пометь результат DEGRADED,
а не заполняй топ слабыми товарами ради количества.
6. Проверь отзывы
Отзывы — обязательный этап для итогового топа, если пользователь не попросил специально «без отзывов» или «только официальный состав».
Перед анализом отзывов прочитай references/review-audit.md: там обязательный порядок проверки конкретного варианта товара, признаки смешанной карточки, режимы сортировки отзывов и шаблоны ответа. Без этого шага топ не считается проверенным.
7. Оцени риски карточки
Помечай товар как рискованный, если есть хотя бы один признак:
- название и характеристики противоречат друг другу;
- состав или комплектация описаны общими словами;
- много отзывов, но они про другой товар или другой вариант;
- ноль отзывов у неизвестного продавца;
- подозрительно низкая цена для бренда;
- продавец не похож на официальный или профильный;
- в карточке объединены дешёвые и дорогие варианты ради отзывов;
- для еды, косметики, лекарств, детских товаров или зоотоваров есть жалобы на запах, срок годности, повреждённую упаковку, подделку или реакцию организма.
8. Сформируй топ
Перед тем как отдать финальный топ, сверься по каждой позиции. Проверки отзывов применяются только когда отзывы входят в запрос по §6; явные исключения пользователя действуют и здесь, и при независимой проверке. Для ответа без отзывов укажи эту границу доказательств и не заполняй поля отзывов вымышленными выводами.
- выбрана плитка нужного варианта, а не общая вкладка «Все»;
- прочитаны отзывы по сортировкам «Новые» и «С низкой оценкой»;
- фото проверены, если формат/размер/цвет/комплектация важны;
- поле «риск» в ответе заполнено (низкий/средний/высокий).
Для еды, лекарств, детских товаров и зоотоваров передай только финалистов новому субагенту для независимой проверки. Делай то же при противоречивых данных, неоднозначном выборе или низкой уверенности основного агента. Для обычного уверенного выбора дополнительная проверка не нужна.
Verifier получает запрос и критерии пользователя, ссылки, выбранные варианты,
цены, продавцов, характеристики, краткую выжимку отзывов и причины включения в топ.
Он не повторяет поиск и не добавляет кандидатов. Его задача — попытаться опровергнуть
выбор в пределах запроса: при включённой проверке отзывов проверить их соответствие
варианту, смешение карточек, повторяющиеся
жалобы, противоречия характеристик и фото, подделки, упаковку и сроки годности.
По каждой позиции он возвращает PASS, DOWNRANK или REJECT с доказательством.
В Claude Code verifier должен быть fresh Opus subagent; в Codex и OpenCode — fresh
native subagent. Запускай его последовательно в отдельной task-owned вкладке с доступом к
той же авторизованной WB-сессии. Если авторизованный маршрут недоступен, сначала
восстанови его, получи разрешение на sessionless fallback или верни DEGRADED/
BLOCKED: subagent не заменяет отсутствующий доступ. Если обязательный verifier
не может проверить живые карточки, пометь независимую проверку как DEGRADED.
По умолчанию дай топ-5; размер подборки и поведение при слабом покрытии определены в §5.
Формат:
Короткий вывод: что лучше купить и почему.
Топ-5:
1. Название — ссылка
Цена / цена за единицу
Почему подходит
Характеристики/состав/комплектация
Отзывы:
- вариант: подтверждён / смешанная карточка / не удалось отделить
- новые: что пишут свежие покупатели
- низкие оценки: повторяющиеся жалобы
- фото: совпадают ли с товаром, если проверялось
- риск: низкий / средний / высокий
Риски
Что не взял:
- товар/тип товара: причина
Мой выбор:
- если брать одну штуку
- если брать набором
Для простого запроса можно сократить ответ до 3–5 пунктов, но не убирай причины выбора и риски.
Правила для разных типов товаров
- Зоотовары и еда: состав важнее маркетинга. Проверяй конкретные ингредиенты, назначение, возраст/вес/состояние животного, формат упаковки, срок годности и жалобы на реакцию.
- Безрецептурные лекарства: проверяй точное наименование, производителя, официальную инструкцию, продавца, срок годности, упаковку и отзывы о подделках или повреждениях. Не ставь диагноз, не назначай лечение и не придумывай персональную дозировку; если выбор зависит от состояния здоровья, прямо укажи, чего карточка WB не позволяет установить.
- Электроника и брендовые товары: проверяй оригинальность, продавца, гарантию, модель, комплектацию и отзывы на конкретный вариант.
- Одежда и обувь: отзывы по размеру, посадке, фото покупателей, материал, возвраты, соответствие размерной сетке.
- Расходники и запчасти: совместимость, размеры, материал, количество в наборе, реальные фото и жалобы на несоответствие.
Честность в ответе
Если данные неполные, скажи прямо: «состав в карточке не раскрыт», «отзывов мало», «есть риск смешанной карточки», «нужно проверить фото/описание перед заказом».
Не делай вид, что товар надёжен, если опора только на рейтинг. Wildberries часто содержит дубликаты, смешанные карточки и слабые характеристики.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |