Перейти к содержанию

Нормативная английская спецификация

Небольшой контракт SKU.md с источниками.

v1 определяет два чистых Markdown-документа: корневой каталог и необязательные знания о товаре. Машинные метки — английские, человеческий текст — на любом языке.

Корневой каталог

Публикуется точно в /sku.md и указывает продавца, официальный сайт и публичный каталог того же origin.

# Example Outdoor Gear> Lightweight outdoor equipment for hikers. SKU.md: [1.0.0-beta](https://sku.md/spec/1.0.0-beta/)Website: [example-outdoor.com](https://www.example-outdoor.com/) ## Catalog- [All products](https://www.example-outdoor.com/collections/all)

Знания о товаре

Один документ на каноническую страницу; каждый пункт заканчивается абсолютным HTTPS Source.

# UltraLight 2P Tent> A lightweight two-person tent for three-season backpacking. SKU.md: [1.0.0-beta](https://sku.md/spec/1.0.0-beta/)Catalog: [Example Outdoor Gear](https://www.example-outdoor.com/sku.md)Product: [Official product page](https://www.example-outdoor.com/products/tent)Updated: 2026-08-11 ## Facts- Packaged weight is 1.35 kg. [Source](https://www.example-outdoor.com/products/tent)

Альтернативная ссылка в HTML товара

Страница товара может объявить альтернативный Markdown, но корневой /sku.md и ссылки Product knowledge остаются основным путём обнаружения.

<link rel="alternate" type="text/markdown" href="https://www.example-outdoor.com/products/tent.sku.md">

Синтаксис

Используйте заголовки, строки фиксированных меток, списки и обычные ссылки Markdown. Неизвестные разделы остаются понятными людям, но не считаются нормативными полями.

Три области проверки

Результат полезен только с указанной областью.

document

Структура, безопасные ссылки, размер и источники.

published

Дополнительно URL, HTTP 200, MIME, UTF-8, перенаправления и конечный ресурс.

graph

Дополнительно взаимные ссылки, origin, доступность Source, дубликаты и циклы.

Поведение Reference Consumer

Хранит источник рядом с фактом и не делает статический файл живым торговым полномочием.

  • Указывать Source для каждого использованного факта.
  • Разделять факты, советы, ограничения и совместимость.
  • Для цены, остатка, доставки и оформления обращаться к живому источнику или отвечать, что данных нет.

Граница безопасности

SKU.md — публичный Markdown, а не скрытый канал команд.

  • Отклонять HTML, script, form, опасные URL, превышение размера и неверный UTF-8.
  • Не называть автоматическое извлечение подтверждённым продавцом без проверки человеком.
  • Не добавлять манипуляции рейтингом, скрытые инструкции агенту и торговые секреты.

История версий

1.0.0-beta несовместима с v0.10; нет режима совместимости, конвертера или переключателя.