BLOG / publish-your-first-sku-md.mdx
Публикация первого SKU.md: точное руководство без привязки к платформе
Подготовка, создание и проверка корневого /sku.md с прямым HTTP 200, text/markdown, канонической идентичностью и онлайн-тестами.
Публикация завершена лишь тогда, когда принятые байты доступны напрямую по заявленному HTTPS URL и проходят сетевые проверки. Валидный локальный файл остается локальным.
SKU.md — это размещаемый самим продавцом слой для обнаружения товаров и стабильных знаний о товарах. Он помогает агентам находить товары, понимать факты с указанием источников и знать, где повторно проверять актуальные коммерческие данные. Это не новый протокол Checkout.
Подготовьте честный минимум
| Входные сведения | Принять | Отклонить или отложить |
|---|---|---|
| Идентичность продавца | Устойчивое публичное имя и исходный домен | Угаданное юридическое лицо |
| Точка Catalog | Существующий URL того же исходного домена | Закрытый административный адрес |
| Знание | Проверенное утверждение с источником | Автоматически повышенный рекламный текст |
| Предложение | Наблюдение с датой или заявленный живой запрос | Обещание вечной цены |
Каждый Variant v0.10 требует непустой sku продавца; если его нет, не изобретайте значение и не выдавайте другой идентификатор за замену.
Создайте и проверьте локально
Начните с корневого манифеста каталога и минимального manifest-basic. Проверьте схему, канонический URL, родительские ссылки, одинаковую идентичность в метаданных и теле, а также отсутствие недоказанных фактов. Локальная проверка offline_document не доказывает публичную доставку.
Опубликуйте точный корневой ресурс
Требуется прямой GET https://example.com/sku.md с точным HTTP 200 без перенаправления, MIME text/markdown и ожидаемыми байтами. HTML-страница совместимости, мягкая подмена главной страницей или 301 не соответствуют строгой публикации. Кэш и пограничное преобразование нужно проверять на реальном URL.
Проверьте сеть и граф
| Проверка | Что доказывает | Чего не доказывает |
|---|---|---|
offline_document |
Локальная структура и смысл | Публичная доставка |
published_resource |
Один точный сетевой ресурс | Полный граф |
document_graph |
Доступная связь родителя и потомков | Официальное принятие или ранжирование |
После публикации добавьте обнаружение через llms.txt, agents.md, Product JSON-LD или MCP там, где эти поверхности действительно существуют. Наблюдайте ошибки и повторяйте проверку после изменения платформы, маршрута, CDN или документа. Корневой /sku.md должен оставаться канонической точкой, а не неявной копией. Подробный порядок дан в руководстве издателя.
Дополнительные материалы
Сначала уточните границу стабильных и живых данных, затем сравните платформенные маршруты.