WooCommerce와 SKU.md: 흩어진 상품 정보를 출처가 있는 지식으로 연결하기

한 매장은 상품 페이지에 규격을 적고, 블로그에는 관리 방법을 올리며, 다운로드 공간에는 사용 설명서를 보관한다. 고객이 액세서리가 구형 기기에 맞는지 물으면 세 곳을 모두 확인해야 답할 수 있다. 비슷한 글을 하나 더 추가해도 이 자료들의 관계가 저절로 명확해지지는 않는다.

WooCommerce 매장은 흔히 이런 모습으로 성장한다. WordPress에는 긴 상품 이야기, 사용법, 설명서, 플러그인이 관리하는 항목이 함께 쌓인다. 담당 편집자와 시스템이 달라도 각 자료는 유용할 수 있다. 판매자에게 필요한 것은 이미 알고 있는 내용을 다시 연결하고, 답마다 고객이 확인할 수 있는 공개 근거를 보여 주는 일이다.

열린 플랫폼일수록 자료의 관계를 분명히 한다

WooCommerce는 WordPress 위에서 운영되는 오픈 소스 전자상거래 플랫폼이다. 필요한 권한이 있는 판매자는 플러그인을 설치하고 콘텐츠 구조와 호스팅 환경을 조정할 수 있다. 이 유연성 덕분에 상품 지식을 게시할 방법을 찾기 쉽지만, 호스팅 업체, 대행사, 플러그인 관리자, 편집자, 상품팀이 책임을 나누어 맡는 경우도 많다. 모든 매장이 동일한 운영 화면과 조건을 쓰는 단일 SaaS 서비스는 아니다.

WooCommerce의 AI 상품 발견에 관한 글은 상품 데이터 품질을 중요한 출발점으로 다룬다. 상품명, 속성, 옵션이 정확해야 추가 설명도 제 역할을 한다. 모델 번호가 틀렸거나 호환성 항목이 비어 있다면 긴 소개문을 여러 곳에 복사해도 문제는 해결되지 않는다.

SKU.md는 독립적인 실험 단계의 1.0.0-beta 제안이다. 루트 카탈로그 진입점과 선택적인 출처 기반 상품 지식을 제공한다. WordPress의 개방성은 이런 게시를 가능하게 하지만 SKU.md가 WooCommerce의 기본 기능이라는 뜻은 아니며, 어떤 AI 플랫폼이 이를 채택했다는 증거도 아니다. 내용의 정확성은 판매자가 계속 책임진다.

실제로 들어오는 질문 하나를 고른다

고객 지원 대화는 좋은 편집 출발점이다. “장착할 수 있나요?”라는 질문에는 모델과 연결 방식이 필요하고, “물로 씻어도 되나요?”라는 질문에는 정확히 그 상품을 위한 관리 안내가 필요하다. 일반적인 브랜드 소개는 어느 쪽에도 충분한 답이 되지 못한다.

답을 쓰기 전에 상품의 정체부터 확정해야 한다. 매장에는 익숙한 제품군 이름 아래 여러 세대가 함께 등록되어 있고, 서로 다른 세대용 액세서리가 겉보기에는 같을 수 있다. 상품 페이지는 “전 제품군 호환”이라고 쓰는데 설명서에는 두 모델만 나온다면, 상품 책임자가 사실을 확인하고 공개 자료를 먼저 바로잡아야 한다.

선택형 상품 지식 문서의 사실, 제한, 호환성 설명에는 각각 Source 링크가 필요하다. 판매자가 공개한 자료나 신뢰할 수 있는 제조사 문서를 출처로 삼을 수 있다. 사내 채팅은 답을 찾는 단서가 될 수 있지만, 고객이 직접 확인할 수 없다면 공개 상품 지식의 근거로는 부족하다.

카탈로그를 정리한 뒤 상품 문서를 넓힌다

최소 루트 카탈로그는 브랜드와 사이트, 상품 모음의 관계를 연결한다. 첫날부터 모든 상품을 변환하려 하지 말고 현재 명세에 맞춰 작은 카탈로그를 만든다. 자료가 완전한 상품이 하나 생기면 Product knowledge를 통해 선택형 문서를 연결할 수 있다.

이 과정에서는 원래 페이지의 문제도 드러난다. 관리 글에 적용 모델이 빠져 있거나 오래된 설명서 주소가 바뀌었을 수 있다. 옵션 속성과 본문 설명이 서로 다른 경우도 있다. 공개 출처부터 고치면 일반 방문자도 즉시 도움을 받고, 상품 지식 문서 역시 더 믿을 만한 내용을 인용할 수 있다.

SKU.md에는 안정적인 규격, 사용법, 관리 방법, 호환성 제한이 잘 맞는다. 가격, 재고, 배송, 세금, 결제, 주문 상태는 WooCommerce와 연결 서비스가 실시간으로 처리한다. Store API는 고객 대상 상품, 장바구니, 체크아웃 경험을 위한 JSON을 제공한다. 이 실시간 JSON은 Markdown 지식 문서가 아니며, 그 시점의 상거래 상태를 정적 문장으로 복사해서도 안 된다.

문서가 잘 갖춰진 한 상품이면 편집 과정을 시험하기에 충분하다. 출처를 누가 관리하고 시간이 지난 뒤 상품 식별 오류를 누가 고칠지 정해졌을 때 다음 상품으로 범위를 넓히는 편이 낫다.

WordPress에서 전용 게시 경로를 마련한다

플러그인이나 호스팅 권한이 있는 팀은 WordPress의 Rewrite API와 template_include를 이용해 /sku.md에 전용 응답을 제공할 수 있다. 테마가 적용된 일반 페이지가 아니라 일반 Markdown을 반환해야 한다. 실제 구현은 현재 사이트의 플러그인, 라우팅, 보안, 캐시를 아는 담당자가 맡는 것이 안전하다.

순서는 간단하다. 최소 카탈로그를 생성하고 루트 경로를 관리하는 사람을 확인한 뒤 게시한다. 실제 주소는 게시 URL 검사기로 점검한다. 출처가 준비된 경우에만 상품 지식 문서 하나를 더한다. 직접 200을 반환하는 방식이 가장 확인하기 쉽다. 명세는 점검된 안전한 리디렉션을 최대 3회까지 허용하므로, 실제 이동 경로를 확인한 뒤 판단해야 한다.

사이트 유지관리 담당자를 위한 구현 메모

정확한 /sku.md 요청만 일치시키고 query_vars를 통해 공개 라우팅 표식을 등록한 다음 template_include에서 전용 응답을 선택한다. 이 표식은 라우팅 상태일 뿐 민감한 데이터를 담는 공간이 아니다. 관련 없는 요청은 기존 WordPress 흐름으로 돌려보낸다. 재작성 규칙은 플러그인을 활성화하거나 비활성화할 때, 또는 경로 정의가 바뀔 때만 갱신하고 매 요청마다 갱신하지 않는다.

text/markdown; charset=utf-8 같은 미디어 유형으로 일반 Markdown을 반환한다. WordPress 설치 경로와 공개 도메인의 루트가 다를 수 있으므로 하위 디렉터리 설치, Multisite, 캐시 설정을 각 공개 오리진에서 확인한다. 수정 뒤에는 캐시에 새 내용이 노출되는지, 상품 지식 링크가 명시한 출처로 이어지는지도 다시 확인한다.

WooCommerce 플랫폼 안내에는 사이트팀이 검토할 게시 조건이 더 자세히 정리되어 있다. 플러그인을 설치했다는 사실만으로 공개 루트 경로가 올바르게 작동한다고 볼 수는 없다. 호스팅 제한과 기존 확장 기능에 따라 매장마다 가능한 방법이 달라진다.

유지 관리를 평소 상품 업무에 넣는다

상품 책임자가 호환 범위를 바꾸면 편집자는 관련 지식 문장과 출처를 바로 찾을 수 있어야 한다. 첫 시험에는 매장이 이미 쓰는 상품 수정 절차를 활용해도 된다. 누가 공개 상품 페이지를 확인하고 누가 지식 문서를 갱신하는지 정한다. 담당자가 없는 파일을 한꺼번에 만드는 것보다 한 상품이 실제 수정 과정을 끝까지 거치는 편이 더 좋은 시험이다.

Google의 검색 AI 기능 관련 안내는 특별한 AI용 Markdown 파일이 Google 노출이나 순위에 유리하거나 불리하지 않다고 설명한다. 접근 가능한 페이지, 정확한 콘텐츠, 기존 SEO 관행은 여전히 중요하다. 유효한 SKU.md 경로 역시 어떤 모델이 파일을 읽는다고 보장하지 않는다.

시험의 성과는 구체적인 변화로 판단할 수 있다. 빠져 있던 호환성 제한을 찾았는지, 오래된 설명서 링크를 고쳤는지, 다음 업데이트 담당자를 정했는지를 본다. 다른 방식은 Shopify의 브랜드 상품 지식 접근법과 BigCommerce의 멀티채널 상품 맥락에서 비교할 수 있다. 공개 카탈로그 하나를 준비했다면 WooCommerce 생성기 열기에서 시작하자.