본문으로 이동

규범 영문 사양

작고 출처를 보존하는 SKU.md 계약.

v1은 루트 카탈로그와 선택 상품 지식이라는 두 순수 Markdown 문서를 정의합니다. 고정 레이블은 영어이고 본문은 어떤 언어든 가능합니다.

루트 카탈로그

/sku.md에 정확히 게시해 판매자, 공식 사이트, 동일 출처의 공개 카탈로그를 표시합니다.

# 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

상호 링크, 동일 출처, Source 접근성, 중복과 순환 추가 검사.

참조 소비자 동작

사실과 출처를 함께 유지하고 정적 문서를 실시간 권한으로 만들지 않습니다.

  • 상품 사실마다 사용한 Source를 제시합니다.
  • 사실, 안내, 제한, 호환성을 구분합니다.
  • 가격, 재고, 배송, 결제는 실시간 출처로 보내고 모르면 알 수 없다고 답합니다.

안전 경계

SKU.md는 공개 Markdown이며 숨은 명령 채널이 아닙니다.

  • HTML, script, form, 위험 URL, 크기 초과, 잘못된 UTF-8 거부.
  • 사람이 검토하지 않은 자동 추출을 판매자 확인으로 표현하지 않음.
  • 순위 조작, 숨은 Agent 지시, 거래 자격 증명 금지.

버전 이력

1.0.0-betav0.10과 단절되며 호환 모드, 변환기, 선택기가 없습니다.