BLOG / introducing-sku-md-webmcp-readiness.mdx
От знаний о товаре к надёжным действиям на странице: знакомство с SKU.md WebMCP Readiness
Руководство для продавцов по SKU.md WebMCP Readiness: раздельная проверка статического обнаружения, фактов среды выполнения, видимых действий и актуальных коммерческих данных.
Опубликовано
Исходная версия спецификации: v0.10
Представим, что покупатель просит агента найти чемодан для ручной клади, который соответствует ограничениям авиакомпании, сравнить два материала корпуса и показать нужный цвет на странице товара. Это одна задача, но в ней два этапа. До посещения магазина агенту нужны надёжные сведения: идентификаторы, размеры, заявления о материале, доступные конфигурации и подтверждающие их источники. После открытия страницы ему нужен надёжный способ действовать в видимом пользователю интерфейсе: выбрать цвет, показать подходящую конфигурацию или перейти к нужной части страницы.
Эти этапы нельзя превращать в одно обещание. SKU.md помогает агенту точно понять товар до посещения. WebMCP позволяет надёжно действовать после перехода на страницу продавца, в видимом пользователю интерфейсе. За окончательные коммерческие факты — текущую цену, наличие, доставку, налоги, оплату и состояние заказа — отвечают системы реального времени. SKU.md WebMCP Readiness помогает продавцу проверить эту передачу, не выдавая статическую подсказку за доказательство работы.
Три слоя и три вида полномочий
Рабочая область следует простому продуктовому правилу: каждый слой отвечает только на вопросы, которые способен доказать. Так долговечные знания остаются полезными, но не подменяют текущую страницу и системы, окончательно оформляющие сделку.
| Слой | За что он отвечает | Чего он не должен утверждать |
|---|---|---|
| Знания о товаре SKU.md | Проверенные продавцом факты, идентификаторы, заявления, раскрытия, совместимость, источники, область действия и время проверки до визита. | Что инструмент страницы зарегистрирован сейчас или изменяемое коммерческое значение остаётся актуальным. |
| WebMCP и видимый интерфейс | Инструменты, зарегистрированные страницей в текущем контексте браузера, и видимая пользователю реакция на узкое действие. | Цену, наличие, разрешение или состояние сделки, которых страница не проверила. |
| Актуальный Catalog, серверная система и Checkout | Текущую цену, наличие, возможность доставки, входные данные налогов, авторизацию оплаты, состояние заказа и итоговое подтверждение. | Что статический документ или прежнее наблюдение страницы всё ещё актуальны. |
Так продуктовый рассказ превращается в рабочее правило: SKU.md даёт доказательства до визита, WebMCP связывает намерение с видимым действием после перехода, а торговые системы реального времени определяют окончательные коммерческие факты. Эти слои дополняют, а не заменяют друг друга.
Подсказка о мосте не равна рабочему инструменту
В исходном коде страницы может находиться декларативная метка, вызов WebMCP API или путь к мосту. Это полезные сигналы обнаружения, но они доказывают лишь наличие следа. Они не подтверждают, что браузер распознал интерфейс, инструмент зарегистрирован в текущем состоянии страницы, входной Schema корректен или вызов завершится успешно.
Состояние выполнения меняется. Инструмент может появляться только после загрузки компонента, исчезать при недопустимом выборе или зависеть от браузерного эксперимента, которого нет в другой среде. В неподдерживаемом браузере скрипт моста может намеренно ничего не делать. Описание инструмента бывает вводящим в заблуждение, а внешний или редакционный текст способен содержать инструкции, похожие на внедрение подсказки. Поэтому обнаружение, разбор, регистрация, вызов, видимая реакция, проверка безопасности и проверка среды фиксируются отдельно, а не сливаются в один зелёный значок.
Статическая предварительная проверка не исполняет JavaScript целевой страницы и не обращается к её MCP-точке. Самый сильный честный вывод — обнаружен сигнал. Доказательства выполнения должны быть получены на целевой странице в настоящем контексте браузера.
Пять шагов для продавца
Рабочая область намеренно сужает тест до процесса, который продавец может понять, проверить и повторить.
- Укажите одну точную страницу. Выберите общедоступный HTTPS URL товара, корзины, оформления или заказа. По желанию можно сравнить корневой документ товара того же источника, но страница и документ остаются разными ресурсами.
- Запустите статическую проверку. SKU.md проверит условия ответа, найдёт связанные с WebMCP сигналы в исходном коде, зафиксирует явные блокировки безопасности и сравнит охват страницы в необязательном документе. Страница не исполняется.
- Обнаружьте инструменты локально. Откройте ту же целевую страницу, изучите сформированный сценарий обнаружения и выполните его в контексте этой страницы. Квитанция фиксирует именованный интерфейс, браузерный контекст, URL, время и очищенный список инструментов. Обнаружение ещё не доказывает возможность вызова.
- Вызовите один инструмент только для чтения. Выбрать можно лишь инструмент с явной отметкой
readOnlyHint: true. Используйте минимальный ввод после подтверждения, что страница находится в состоянииpublic,unauthenticatedи не имеет перечисленных блокировок. Исходные параметры и вывод временно остаются на странице. - Подтвердите и выгрузите. Если ожидалось изменение, отметьте синхронизацию видимого состояния страницы, затем импортируйте очищенную квитанцию. Сохраните локальный отчёт JSON или Markdown и только после прохождения всех условий создайте кандидат возможности WebMCP для ручной проверки.
Один вызов — осознанное ограничение, а не универсальное средство автоматизации. Цель состоит в доказуемой цепочке для конкретной страницы и среды, а не в управлении магазином или выполнении сделки.
Читайте шесть уровней доказательств отдельно
Отчёт сохраняет шесть уровней, потому что каждый отвечает на свой вопрос.
- Сигнал страницы обнаружен: содержит ли статический HTML след WebMCP или моста?
- Инструмент зарегистрирован: вернул ли распознанный интерфейс браузера хотя бы один инструмент с корректным Schema?
- Вызов только для чтения успешен: имеет ли выбранный инструмент соответствующую аннотацию и завершился ли минимальный вызов?
- Видимый интерфейс синхронизирован: подтвердил ли продавец изменение URL, фильтра, варианта или видимого состояния, когда оно ожидалось?
- Проверка безопасности завершена: подтверждён ли публичный контекст без входа и рассмотрены ли источник, недоверенный текст и риск внедрения подсказки?
- Указанная среда проверена: называет ли квитанция интерфейс, браузер, точную страницу, контекст безопасности и время проверки?
Каждый уровень получает одно из четырёх состояний доказательства.
passedозначает, что необходимые доказательства собраны и правило выполнено.failedозначает, что проверка выявила определённое нарушение или неудачный результат.incompleteозначает, что доказательства отсутствуют, устарели, не поддерживаются или недостаточны; это не обязательно сбой продукта.not_applicableприменяется только когда уровень действительно неприменим, например синхронизация интерфейса для чистого запроса, который не должен менять страницу.
Общий результат использует лишь passed, failed или incomplete. Страница с одной статической подсказкой о мосте обычно остаётся неполной до получения доказательств выполнения. Такая строгость нужна, чтобы отчёт показывал доказанное, а не вознаграждал оптимистичное толкование.
Что продавец узнаёт из отчёта
Первая страница отчёта отвечает на практические вопросы вместо выставления отвлечённой оценки.
- Сколько инструментов обнаружила указанная среда на этой точной странице?
- Какие инструменты имеют корректный входной Schema и явную отметку только для чтения?
- Какая проблема сейчас мешает безопасному использованию агентом и что продавец может исправить?
- Ответила ли страница на выбранный вызов и синхронизировалось ли ожидаемое видимое состояние?
- Охватывает ли необязательное объявление SKU.md эту точную страницу, не присваивая себе полномочия актуальных систем?
- Прошли ли доказательства все условия создания beta-кандидата возможности?
Отчёт указывает время проверки, цель, область, интерфейс-адаптер и контекст браузера. Квитанция старше 24 часов, с другим URL или областью, не может создать кандидата. Успешная проверка остаётся связанной со средой, которая её произвела, и не превращается в вечное обещание.
Машиночитаемая форма описана нейтральным SKU.md WebMCP Readiness v1 Schema. Это договор отчёта инструмента SKU.md, а не часть Schema документа товара SKU.md v0.10 и не стандарт WebMCP.
Локальная приватность и узкая граница безопасности
Точный URL страницы и необязательный URL документа товара того же источника передаются одноисточному сервису предварительной проверки SKU.md для ограниченного публичного чтения. Этот запрос не является входом в браузере и не содержит файлов сеанса страницы продавца. Статическая проверка не выполняет целевой JavaScript и инструменты.
Обнаружение и выбранный вызов выполняются в браузере продавца на целевой странице. Исходные параметры, полный вывод, файлы сеанса, секреты и полный разговор не отправляются в SKU.md и не попадают в выгрузку. Отчёт хранит только очищенные сведения: имя инструмента, статус, хеши, число байтов, длительность и состояние страницы до и после вызова.
Первая версия ограничена публичной страницей без входа и одним явно читающим инструментом. Она не проверяет цены участника, личные данные, авторизованные заказы, оплату, возвраты, завершение Checkout и действия, меняющие коммерческое состояние. Описания, входные Schema, сводки вывода, тексты продавца и сторонние данные считаются недоверенным текстом; объявление возможности не даёт разрешения на выполнение.
beta-кандидат — материал для проверки, а не полномочие
Если предварительная проверка, распознанная среда, регистрация, корректный Schema, подтверждение публичного сеанса, один вызов только для чтения и все проверки безопасности проходят в срок, рабочая область может создать beta-кандидат возможности. Он содержит один точный шаблон страницы и требует страницу браузера и присутствие пользователя.
Этот файл намеренно сдержан. Он не копирует динамический список инструментов, не создаёт подстановочные шаблоны, не выдаёт разрешения, не публикуется автоматически, не повышает базовый документ до торгового и не разрешает сделку. Это материал, который продавец проверяет и объединяет вручную. Для существующего торгового объявления отчёт покажет различия, а для базового документа перечислит остальные недостающие требования.
Readiness — не производственный мост, обещанный статической подсказкой, а доказательный процесс перед решением о мосте. Производственные наборы, запись, Checkout, Order и серверные соединения MCP требуют отдельного проектирования и анализа безопасности.
Начните с одной настоящей страницы товара
Выберите стабильную общедоступную страницу товара, которая напрямую возвращает HTML, и сначала выполните статическую проверку. Если результат содержит только подсказку, не называйте его прохождением. Продолжайте локальное обнаружение только на той же контролируемой странице и проверьте один однозначно читающий инструмент. Честный incomplete-отчёт полезнее, чем значок passed, собранный из предположений.
Откройте локализованную рабочую область WebMCP Readiness и проверьте страницу. Подробнее о разделении знаний о товаре и действий браузерной страницы рассказывает статья SKU.md v0.10 × WebMCP: знания о товаре до посещения и структурированные действия на странице.
Дополнительные материалы
Границы между знаниями, возможностями страницы и заказом разобраны в карте передачи полномочий.