본문으로 이동
SKU.md
메뉴
한국어

상품 하나로 시작하기: Shopify, SHOPLINE, WooCommerce, BigCommerce의 SKU.md 도입 안내

v1.0.0 특집

플랫폼별 게시 조건을 비교하고 상품 하나로 SKU.md를 생성, 검토, 공개 검증하는 시범 도입을 시작하세요.

게시일

작성 SKU.md Editorial Team

현재 사양 버전: v1.0.0

쇼핑 에이전트를 위한 상품 지식을 준비하려고 쇼핑몰 전체를 개편할 필요는 없습니다. Shopify, SHOPLINE, WooCommerce, BigCommerce 판매자는 상품 하나의 정확한 자료를 모으고 파일 제공 방법을 확인한 뒤 확대 여부를 판단할 수 있습니다.

SKU.md v1.0.0은 상품 페이지, 구조화 데이터, 채널 Feed를 보완하는 개방형 표현입니다. 재고, 결제, 주문은 기존 시스템이 맡습니다. 아래 경로는 평가할 도입 방법이며 네 플랫폼의 기본 지원을 주장하는 것이 아닙니다.

무엇을 제공할 수 있는지 먼저 확인하세요

내용 정확성과 온라인 제공은 별개입니다. 운영자는 사양, 옵션, 제한, 출처를 정리하고 기술 담당자나 서비스 업체는 매장 도메인의 실제 응답을 확인합니다.

공식 자료에 근거한 아래 판단도 개별 매장의 인증은 아닙니다. 호스팅, 권한, 실제 테스트가 필요하며 파일 업로드 가능 여부만으로 끝내면 안 됩니다.

플랫폼 통제할 수 있는 부분 확인할 전제 검증 항목
Shopify 테마 내용, 구성에 따른 직접 관리 스토어 경로 App Proxy의 제한된 접두사가 루트 제어를 뜻하지 않음 테마 HTML 대신 Markdown 응답
SHOPLINE 상품 내용과 허용된 리디렉션 리디렉션만으로 적합성을 입증할 수 없으며 동일 출처 제공 확인 필요 대상 주소, 본문, 이동 경로
WooCommerce 권한에 따른 WordPress 경로나 정적 파일 다시 쓰기 규칙뿐 아니라 올바른 응답 구현 필요 상태, 콘텐츠 유형, 캐시, 본문
BigCommerce Stencil 템플릿이나 직접 관리 스토어 경로 페이지 템플릿은 루트 Markdown 제공의 증거가 아님 HTML 페이지와 파일 응답 구별

이는 플랫폼 기능에서 도출한 구현 판단입니다. 적절한 경로가 없으면 우선 상품 자료를 정비하고 담당 업체에 검토를 요청하세요. 파일 하나를 위해 플랫폼을 바꿀 필요는 없습니다.

현행 규격의 발견 방식

같은 사이트의 정확한 /sku.md를 우선합니다. 해당 경로가 명확한 HTTP 404를 반환한 뒤에만 같은 출처 홈페이지의 모호하지 않은 선언 하나를 확인할 수 있습니다.

<link rel="alternate" type="text/markdown" title="SKU.md" href="/catalog.md">

선언된 파일도 같은 출처의 HTTPS여야 하고 쿼리나 프래그먼트가 없어야 하는 등 규격을 따라야 합니다. 시간 초과, 서버 오류, 잘못된 문서는 파일이 없다는 뜻이 아닙니다.

모든 테마에서 가능한 요령이 아니라 조건부 경로입니다. 홈페이지 선언과 실제 파일을 모두 통제하고 검증해야 합니다. CDN 다운로드, HTML 소개 페이지, 다른 출처로의 이동을 곧바로 적합한 것으로 보지 않습니다.

최소 카탈로그부터 만드세요

아래는 가상 매장의 루트 예시입니다. 이름, 요약, 도메인, 카탈로그 주소를 실제 정보로 바꾼 뒤 생성하고 검증합니다. 루트만으로 상품의 모든 속성을 설명했다고 주장하지 않습니다.

# 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)

상품 지식 문서는 선택 사항입니다. 추가할 때 루트에서 명시적으로 연결하고 상품 문서에 카탈로그 역링크, 상품 페이지, 사실별 출처를 포함합니다. 상품 전체와 특정 옵션의 적용 범위도 구분합니다.

다섯 단계로 검증 가능한 시범 도입

  1. 상품 선택. 공개 자료가 충실하고 사양 질문이 많은 상품을 고릅니다. 전 매장 수집부터 할 필요는 없습니다.
  2. 사실 검토. 식별 정보, 사양, 제한, 근거를 실제 페이지와 대조하고 미상인 부분은 추측하지 않습니다.
  3. 생성과 검사. 생성기로 루트 파일을 만들고 세부 속성은 상품 개선 도구에서 검토합니다.
  4. 게시와 검증. 매장 담당자가 파일을 제공한 뒤 공개 URL 검사기로 실제 URL을 확인합니다. 상품 문서와 카탈로그의 관계는 별도로 검증합니다.
  5. 유지 관리. 담당자를 정하고 근거를 보관하며 사양, 옵션, 출처가 바뀌면 갱신하고 다시 검사합니다.

공개 HTTPS, HTTP 200, UTF-8 Markdown 본문, 허용된 콘텐츠 유형 text/markdown 또는 text/plain을 확인합니다. 안전한 이동, 카탈로그 관계, 출처도 검사합니다. 브라우저에 글이 보인다는 것만으로 전체 통과는 아닙니다.

확대 여부를 판단하는 기준

파일에 접근할 수 있는지, 사실에 출처가 있는지, 옵션 범위가 맞는지, 어떤 질문을 실시간 시스템으로 넘겨야 하는지 답할 수 있어야 합니다. 생성한 파일 수보다 이 확인을 먼저 하세요.

SKU.md는 관리자 로그인, 상품 자동 게시, 외부 쇼핑 채널 자동 제출을 하지 않습니다. 판매자가 공개 내용을 결정하고 Agent가 실제 소비하는지는 따로 검증합니다. 가격, 재고, 배송 약속은 실시간 시스템에 남습니다.

빠른 시작을 따라 검토한 상품 하나의 지식을 쇼핑몰 담당자에게 전달하세요. 작지만 구체적인 출발점입니다.

공식 자료

← 모든 글