BLOG / sku-md-platform-publishing-guide.mdx
Руководство по публикации SKU.md на четырех торговых платформах
Сравнение строгого корневого ресурса и совместимых путей на четырех платформах с источниками и обязательной повторной проверкой.
Совместимая страница или перенаправление полезны для обнаружения, но не равны строгому прямому ресурсу /sku.md. Возможности платформ нужно перепроверять перед каждой публикацией.
SKU.md — это размещаемый самим продавцом слой для обнаружения товаров и стабильных знаний о товарах. Он помогает агентам находить товары, понимать факты с указанием источников и знать, где повторно проверять актуальные коммерческие данные. Это не новый протокол Checkout.
Строгая публикация и совместимость
| Путь | Задокументированная возможность | Оценка SKU.md |
|---|---|---|
| Тема Shopify | Шаблоны Shopify для agents.md и llms |
Совместимое обнаружение, не доказательство произвольного /sku.md |
| Shopify App Proxy | Один маршрут под разрешенным префиксом | Корневой путь обещать нельзя |
| WooCommerce | WordPress Rewrite API регистрирует корневой маршрут | Кандидат после живой проверки |
| BigCommerce Stencil | Шаблоны привязаны к типам страниц | Совместимость, не произвольный Markdown в корне |
| BigCommerce с отделенной витриной или пограничным приложением | Приложение того же исходного домена под контролем продавца | Кандидат после живой проверки |
| SHOPLINE | Библиотека файлов (File Library) и обход через 301 для llms.txt |
Только совместимость; 301 не равен прямому 200 |
Не превращайте возможность в заявление о поддержке
Shopify документирует собственные агентские файлы, но не официальное принятие SKU.md. WordPress позволяет зарегистрировать маршрут, однако реальная конфигурация должна вернуть правильные статус, MIME и байты. Stencil обслуживает известные типы страниц, а система с отделенной витриной дает больше контроля только при владении маршрутом. Обход SHOPLINE через редирект прямо показывает ограничение строгого контракта. Перед выпуском перепроверьте официальные материалы SHOPLINE о работе с llms.txt и библиотеке файлов.
Что перепроверять
- Открыть актуальную документацию платформы из первичного источника.
- Запросить
/sku.mdс отключенными редиректами. - Потребовать HTTP 200,
text/markdown, точные байты и правильный канонический адрес. - Пройти родительские ссылки и проверить 404 для неизвестного пути.
- Заявлять принятие только при явном документе платформы, называющем SKU.md.
Платформенная совместимость, строгое соответствие и официальная поддержка — три разные характеристики. Ни одна локальная сборка не доказывает поведение реального магазина.
Текущая серия v1 для трёх платформ
Для текущей реализации используйте статью v1 о нужной платформе:
Дополнительные материалы
Следуйте нейтральному руководству по публикации и сверяйте матрицу форматов.