wb-product-card

name	wb-product-card
id	wb-product-card
title	Карточка товара WB
description	Собирает живые данные карточки товара Wildberries через браузер пользователя: цену, рейтинг, остатки по складам и размерам, склейку артикулов. Используйте, когда пользователь спрашивает про остатки или сток артикула ВБ, наличие по складам или размерам, цену, рейтинг, карточку товара или склейку по nm_id / SKU.
skill_schema_version	1
introduced_in	2026.7.0
updated_in	2026.7.5
status	experimental

Карточка товара WB

Контракт

Скилл получает данные карточек товаров Wildberries (одной или батчем до 50 артикулов) через браузер пользователя.

Сначала прочитайте общий контракт браузерных заданий: ../../shared/browser-job/README.md. Он описывает требования, выбор транспорта (обязательно сначала попробуй postMessage-снипет; DOM mailbox — только если postMessage не ответил, а не по умолчанию), передачу trigger_url, опрос, чтение результатов, снимок-семантику и общие ошибки. Весь флоу гоняйте сами в браузере пользователя — не отдавайте ему trigger_url и не просите «достать данные»; не выдумывайте ошибку авторизации (реальная приходит только из submit/progress().setupError). Всю работу выполняет расширение через API — не скрапьте DOM карточки и не разбирайте сырой WB-JSON, когда хватает сводки.

Как работает

1. Вызовите MCP tool browser_job:

   { "job_type": "product_card", "articles": [791050753, 913357757] }
   

   До 50 артикулов, дубликаты схлопываются. Ответ: trigger_url, job_ids (один родительский jobId), expires_at (~5 минут — открывайте сразу, не откладывайте).

2. Выполните общий workflow из ../../shared/browser-job/README.md: submit → опрос progress → чтение. Читайте результат сводкой (agent_summary.js либо mailbox-команда summary): на каждый артикул придёт готовый объект ProductSummary — без разбора WB-JSON.

3. Поля сводки: nmId, name, brand, supplier/supplierId, subject/rootSubject, vendorCode, rating, feedbacks, pics, priceRub (basic/product/logistics/ return/cashback), quantity (total, byWarehouse — уже с именами складов, bySize), colors (склейка), options (характеристики), description. Поля best-effort — чего-то может не быть.

4. Сырые тела нужны только для полей, которых нет в сводке, — agent_read.js (readAll для 1-2 артикулов, конкретные unit ids порциями для батчей) по той же джобе, без нового browser_job. Юниты: <jobId>__nm<nm>__detail (ответ cards/v4/detail: цена, рейтинг, остатки sizes[].stocks[]), <jobId>__nm<nm>__card (контент card.json: склейка colors, описание, характеристики), <jobId>__local (данные расширения: storesData, productCardDetail; появляется последним).

5. Джоба — снимок: чтобы добрать поля по уже полученным артикулам, перечитывайте тот же jobId (сводкой или read). Новый browser_job — только за актуальными ценой/остатками, для новых артикулов или после истечения хранения (~1 сутки).

Как отвечать пользователю

• Не оставляйте сырые имена полей WB в ответе — переводите их на русский; булевы значения показывайте как «да/нет». Минимальный глоссарий:

  Поле WB	В ответе
  imt_id	Склейка (ID склейки)
  subjectId	ID предмета
  vendorCode / Vendor code	Артикул поставщика
  need_kiz	Обязательная маркировка (да/нет)
  time1, time2 (в stocks)	Время доставки — одно число time1 + time2, не сырые поля

• Отвечайте из полей сводки без дополнительных вычислений: цена — priceRub.product (базовая — priceRub.basic), рейтинг — rating/feedbacks, таблица «по складам» — quantity.byWarehouse (имя склада уже в поле warehouse; если его нет — покажите wh <id>), таблица «по размерам» — quantity.bySize, всего — quantity.total, склейка — colors, характеристики — options, описание — description.

• Глоссарий выше нужен при работе с сырыми телами (agent_read.js); время доставки (time1 + time2) есть только в сырых stocks юнита __detail.

• Юнит со status: 'done', но data.ok === false / data.status === 0 — сетевая ошибка WB: сообщите об этом по конкретному артикулу и предложите повторить.

• Указывайте, что остатки — моментальный снимок на момент запроса.