본문으로 이동

BLOG / what-is-sku-md.mdx

SKU.md란? 에이전트를 위해 판매자가 호스팅하는 상품 지식

SKU.md 문서군과 읽기·조회·실행 계층의 역할, 그리고 넘지 말아야 할 권한 경계를 설명합니다.

게시일

작성 SKU.md Editorial Team

원래 사양 버전: v0.10

SKU.md는 자동화된 소비자가 상품을 찾고 안정적이며 출처가 있는 상품 지식을 이해하기 쉽도록 판매자가 직접 호스팅하는 방식입니다. 오래 유지되는 설명을 라이브 커머스 출처와 연결하지만, 그 출처를 대체하지 않습니다.

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

상품 지식이 여러 곳에 흩어져 있습니다

상품 하나의 정보도 HTML, Product JSON-LD, 피드, 설명서, 정책 페이지, 사이즈 표, 라이브 Catalog, Checkout으로 나뉩니다. 이름과 현재 가격만으로는 소재 주장이 시험되었는지, 어느 Variant에 적용되는지, 근거를 언제 검토했는지 알 수 없습니다. 긴 마케팅 페이지도 오늘의 재고를 누가 결정하는지는 알려 주지 않습니다.

SKU.md는 식별, 지식, 근거, 제한, 라이브 검증 진입점을 작은 문서 그래프로 제시하되, 이들을 거짓된 단일 진실로 합치지 않습니다.

읽기, 조회, 실행은 서로 다른 계층입니다

계층 가장 잘하는 일 권한 경계
읽기 가능한 계층 안정적인 설명, 근거, 고지, 탐색 SKU.md가 참여할 수 있음
조회 가능한 계층 현재 Catalog, 가격, 재고, 배송 예상 라이브 Catalog, API, MCP가 응답을 관할
실행 가능한 계층 Cart, 결제, 주문, 페이지 작업 Checkout, 주문 시스템, UCP, 검토된 WebMCP 작업이 실행을 관할

상품을 찾고, 출처가 있는 지식을 읽고, 현재 조건을 조회한 뒤, 중요한 작업 전 사용자 확인을 받는 순환입니다. 정적 지식은 라이브 검사를 없애는 대신 이 순환을 더 안전하게 만들어야 합니다.

v0.10 문서군

v0.10 사양은 루트 Catalog Manifest, 선택형 Partition Index, Product Document를 정의합니다. manifest-basic 진입점은 라이브 기능이 있다고 주장하지 않고 식별 정보와 Catalog 링크를 공개할 수 있습니다. Product Document는 지식을 안정적인 Product와 Variant 식별자에 연결하며 오퍼 없이도 유효할 수 있습니다.

선택형 offer_snapshot은 과거 관측을 기록하고 live_offer는 별도로 선언한 라이브 조회를 가리킵니다. 어느 필드도 Markdown을 구속력 있는 견적으로 만들지 않습니다. 표준 URL과 상위 문서 링크는 그래프 검토를 돕고, 게시 리소스 검사는 의미가 아니라 전달을 입증합니다.

게시자, 구현자, 소비자

게시자는 상품 출처를 검토할 수 있는 판매자 또는 권한 있는 운영자입니다. 구현자는 생성기, 검증기, 플랫폼 경로, 안전한 소비자를 만듭니다. 소비자는 출처가 있는 상품 맥락이 필요한 에이전트, 검색·Catalog 도구, 접근성 도구, 내부 시스템일 수 있습니다.

역할 책임 있는 선택 위험한 지름길
게시자 식별, 출처, 날짜, 제한 확인 미검토 문구를 Fact로 승격
구현자 모호하면 중단하고 공개 전달 검증 로컬 Schema 성공을 게시 완료로 간주
소비자 출처를 제시하고 변동 상태 재확인 오래된 관측 기록을 오늘 가격으로 사용

SKU.md가 부여하지 못하는 것

권한 부여, 인증, 결제 승인, 이행 보증은 할 수 없고, 구문 분석이 된다는 이유로 주장이 참이 되지도 않습니다. 모델이 크롤링, 인용, 추천, 순위 지정, 전환을 수행한다고 증명할 수도 없습니다.

역할은 좁지만 실용적입니다. 판매자는 안정적이고 검토 가능한 상품 설명을 공개하고, 불확실성을 어디서 해결해야 하는지 소비자에게 알려 줄 수 있습니다.

더 읽기

인접 형식은 llms.txt와 agents.md, SKU.md 비교에서, 전달 흐름은 첫 SKU.md 게시하기에서 확인하세요.

다음 단계

빠른 시작 안내 보기