본문으로 이동

SKU.md 1.0.0 파일 형식과 검증 규칙.

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

루트 카탈로그

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

# Example Outdoor Gear> Lightweight outdoor equipment for hikers. SKU.md: [1.0.0](https://sku.md/spec/1.0.0/)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](https://sku.md/spec/1.0.0/)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은 v0.10과 단절되며 호환 모드, 변환기, 선택기가 없습니다.

관련 가이드

과거 글은 원래 날짜와 게시 당시 설명을 유지합니다. 현재 동작은 현행 사양과 도구를 확인하세요.