첫 SKU.md 게시하기: 플랫폼에 구애받지 않는 정확한 튜토리얼

첫 SKU.md 게시는 승인한 문서가 선언한 HTTPS URL에서 직접 제공되고 온라인 전달 검사까지 통과해야 완료됩니다. 로컬에서 유효한 파일은 아직 로컬 파일일 뿐입니다.

SKU.md는 판매자가 직접 호스팅하는 상품 탐색 및 안정적인 상품 지식 계층입니다. Agent가 상품을 찾고, 출처가 있는 사실을 이해하며, 실시간 상거래 정보를 어디에서 다시 확인해야 하는지 알도록 돕습니다. 새로운 Checkout 프로토콜이 아닙니다.

1. 가장 작고 정직한 출처 준비하기

상점 오리진, 공개 Catalog 진입점, 기본 언어와 시장, 안정적인 판매자 식별, 검토자가 책임질 수 있는 공개 출처를 수집합니다. manifest-basic부터 시작하고 필드를 채우기 위해 MCP 엔드포인트, 라이브 조회, 식별자, 상품 Fact를 만들어 내지 마세요.

입력	허용	거부 또는 보류
판매자 식별	안정적인 공개 이름과 오리진	추측한 법인 정보
Catalog 진입	기존 같은 오리진 URL	비공개 관리자 엔드포인트
Knowledge	검토된 문장과 출처	마케팅 문구 자동 승격
Offer	시각이 있는 관측 또는 선언된 조회	기한 없는 가격 약속

2. 오프라인에서 생성하고 검증하기

Basic 생성기나 sku.md/0.10-draft를 출력하는 구현을 사용합니다. canonical, 콘텐츠 언어, 시장, 문서 유형을 확인하고 offline_document로 안전한 YAML, Schema 유효성, 의미 일관성, 본문 일치를 검사합니다.

오프라인 성공은 바이트가 허용 가능한 문서를 이룬다는 것만 입증합니다. DNS, 라우팅, 상태, 미디어 형식, 캐시, 상위 문서 링크, 공개 접근성은 입증하지 않습니다.

3. 정확한 루트 URL에 게시하기

게시자 가이드는 루트 매니페스트를 정확한 HTTPS /sku.md에 둘 것을 요구합니다.

1. 리디렉션을 따르지 않고 https://merchant.example/sku.md를 요청합니다.
2. 301, 302, 206이나 일반 성공 페이지가 아닌 정확한 HTTP 200을 요구합니다.
3. Content-Type: text/markdown을 요구합니다. 지원되는 MIME 매개변수는 생략할 수 있지만, 포함하면 유효해야 합니다.
4. 프런트매터의 canonical이 요청 URL과 같은지 확인합니다.
5. 응답 본문을 검토해 승인한 바이트와 비교합니다.

호스팅된 HTML 보기, CDN 자산 URL, 테마 대체 화면, 리디렉션은 호환 표시에는 유용할 수 있지만 엄격한 루트 게시는 아닙니다.

4. 온라인 검사와 문서 그래프 검사하기

각 공개 문서에 published_resource를 실행하고 루트에서 document_graph를 검사합니다. 표준 URL, 상위 문서 링크, 콘텐츠 언어, 링크된 리소스의 상태, 미디어 형식, 파싱 가능성, 깊이 제한, 실패 동작을 검증합니다. 알 수 없는 문서 경로가 200과 일반 HTML 대체 응답을 반환해서는 안 됩니다.

범위	입증하는 것	입증하지 않는 것
offline_document	로컬 구조와 의미	공개 전달
published_resource	정확한 온라인 리소스 하나	전체 문서 그래프
document_graph	도달 가능한 부모·자식 계약	외부 채택이나 순위

5. 탐색과 운영 순환 추가하기

적절한 공개 페이지나 문서화된 탐색 표면에서 /sku.md를 연결합니다. Sitemap, Product JSON-LD, llms.txt, agents.md는 각자의 역할을 유지합니다. 승인한 바이트의 해시를 감시하고 경로, 테마, CDN, 도메인 변경 후 온라인 검사를 다시 실행합니다.

Product Document를 추가할 때 안정적인 식별과 출처 검토를 유지합니다. 현재 가격, 재고, 배송, 세금, 결제, 주문은 라이브 Catalog나 Checkout에서 다시 확인합니다.

더 읽기

전달 문제는 Schema는 유효하지만 게시 준비가 되지 않은 경우에서, 필드 분류는 안정적인 지식과 라이브 데이터에서 확인하세요.

다음 단계

Basic 문서 생성하기