포토샵 대신 코드로 상세페이지를 만들어 봤습니다 — "상세페이지 디자인 시스템"
2026.07.24

소개
저는 온라인 비즈니스 컨설팅 일을 합니다. 쇼핑몰 운영하시는 분들을 많이 만나는데, 다들 공통으로 가장 어려워하는 게 상세페이지 기획과 제작입니다. 관행은 거의 같습니다 — 포토샵으로 만든 긴 이미지를 외주로 제작해서 올리는 방식이요. 코드로 만든다는 건 현장에서 대부분 시도하지 않습니다. "그건 개발자나 하는 일"이라고들 여기니까요. 그러다 보니 제작 기간이 길고, 오타 하나 고치는 데도 파일을 다시 만들어야 하는 불편함이 반복되는 걸 옆에서 계속 봤습니다.
요즘 고객은 챗GPT 같은 AI에게 "배선 없이 달 수 있는 벽등 있어?"라고 직접 물어보는데, 문제는 이미지로 만든 상세페이지는 AI가 읽을 수 없다는 것입니다. 사람 눈엔 멀쩡해 보여도 그 안의 글자를 검색엔진도 AI도 읽지 못합니다. 이미지 상세페이지가 검색(SEO)과 AI 검색(AEO)에서 불리한 이유입니다.
코칭 중인 조명 브랜드의 상세페이지를 다음 순서로 OS를 만들었습니다. 다른 업체도 같은 순서로 진행했습니다.
1. 클로드 프로젝트를 이용해 기획
2. 클로드 디자인에서 디자인 스타일 결정
3. 클로드 코드로 한 개의 상세페이지 전체 코딩
4. 완성된 코드를 템플릿으로 이용해 다른 상품의 상세페이지를 제작 할 수 있는 OS 완성
5. 특징은 원고 한 벌에서 카페24용·스마트스토어용(쿠팡, SSG등 오픈몰과 종합몰에 이용 가능) 코드가 나오는 체계를 완성
[이미지 1: 완성된 상세페이지 — 자사몰 버전 캡처]
진행 방법을 설명하면....
클로드 디자인, 클로드코드, GPT, 클로드 프로젝트 — 네 도구를 단계마다 다르게 썼습니다. 디자인 시스템이 하루아침에 나온 게 아니라, 6단계를 거치며 만들어진 과정 그대로 소개합니다.
1단계. 클로드 프로젝트로 기획
먼저 클로드 프로젝트에서 상세페이지를 기획했습니다 — 어떤 순서로 설득할지, 각 섹션이 고객의 질문에 답할지, 어떤 자료가 필요한지를 문서로 잡는 단계입니다.
■ 기본 정보
제품명 / 카테고리
판매 가격대
구매 주기 (일회성 구매 vs 반복 구매)
타깃 고객층 (알고 있다면)
경쟁사 URL 1~3개
■ 고객 언어 자료 (리뷰·반응)
자사 리뷰 데이터 (텍스트, 엑셀, 캡처)
타사(경쟁사) 리뷰
쿠팡/네이버쇼핑 등 플랫폼 리뷰
유튜브 영상 링크 (댓글 포함 참고)
네이버 카페/블로그/커뮤니티 글
자사 FAQ, 고객 문의 내역
SNS 댓글·반응
■ 이미지/영상 소스
보유 중인 제품 사진 (단독컷, 사용 장면, 디테일컷)
제품 영상 원본/편집본
도면, 일러스트, 참고 레퍼런스
■ 기존 상세페이지
현재 상세페이지 URL
현재 페이지의 문제점 (느끼는 대로)
잘 됐다고 생각하는 경쟁사 상세페이지
■ LLM 질문 결과 (선택이지만 강력 권장)
검색 질문 3종: "사람들이 어떻게 검색할 것 같아?" / "뭐라고 물어볼 것 같아?" / "노출 잘 되는 상세페이지를 어떻게 기획해야 해?"
페르소나 질문: 고객이 실제 쓰는 표현 그대로의 problem/need
■ 기타
제품 관련 특이사항, 현장 경험 등 무엇이든

2단계. 클로드 디자인에서 디자인 스타일 결정
그 기획을 들고 클로드 디자인으로 넘어가 화면을 보면서 수정을 반복해 디자인을 완성했습니다. 포토샵 시안 대신 처음부터 "살아있는 코드"로 디자인한 것이 이후 모든 단계의 출발점이 됩니다.

3단계. 클로드코드로 코드 완성 (카페24용 시맨틱 구조로 코딩)
완성된 디자인의 코드를 다운로드해서, 클로드코드로 검색과 AI가 잘 읽는 구조(시맨틱)로 다듬었습니다. 제목 태그 위계(h2부터), FAQ를 질문-답 구조(dl + FAQPage 구조화 데이터)로, 이미지에 설명(alt)과 지연 로딩까지. 자사몰용은 표현의 제약이 없으니 넣을 수 있는 검색 신호를 전부 넣는 방향입니다.
4단계. GPT로 "스마트스토어에서 안 깨지는 코드" 조사와 테스트
문제는 스마트스토어입니다. 필터가 태그를 잘라내는데, 공식 문서가 친절하지 않습니다. GPT에게 제약 사항을 조사시키고, 후보 코드를 만들어 실제 스토어에 등록하며 테스트했습니다. 여기서 실전 지식이 쌓였습니다 — 예를 들어 div 배경색은 모바일에서 깨진 사례가 있지만 table+bgcolor는 살아남는다, 외부 호스팅 WebP는 표시된다 같은 것들이요.
5단계. 클로드에서 "초보수" 스마트스토어 코딩 원칙 문서화
테스트 결과를 들고 클로드 프로젝트로 돌아와, 의심스러우면 쓰지 않는 초보수 기준의 코딩 원칙 문서를 만들었습니다. 원칙은 한 줄로 요약됩니다:
6단계. OS(관리 시스템)에 두 디자인 시스템(cafe24를 위한 시멘틱구조, 스마트스토어용) 이식 — "찍어내는" 구조의 완성
마지막으로 이 문서 두 벌을 상세페이지 관리 시스템(OS)에 넣었습니다.
원고(문구·사진 순서)는 한 벌만 관리하고, 출력만 채널별로 — 카페24 버튼을 누르면 시맨틱 코드가, 스마트스토어 버튼을 누르면 안전 코드가 나옵니다. 같은 원고, 출력되는 코드는 두개입니다.
이 구조의 진짜 특징은 확장성입니다.
디자인 시스템(브랜드 룩)과 기획 규칙(카피 만드는 법)이 문서로 고정돼 있으니,
두 번째 상품부터는 기본 정보(스펙표)·리뷰·사진만 준비하면 같은 스타일의 상세페이지가
카페24용·스마트스토어용으로 나뉘어 나옵니다.
상품이 10개든 수백 개든 과정이 같습니다 — 상품마다 디자인을 새로 고민하는 게 아니라, 자료를 올리고 결과를 검토하는 일만 반복되니까요. 상세페이지 제작이 "건별 프로젝트"에서 "찍어내는 공정"으로 바뀌는 지점입니다.
물론 사람이 검수과정을 OS에 넣었습니다. AI가 만든 카피가 실제 리뷰와 "같은 얘기인가?"를 확인하고 승인하는 검토자 역할은 남습니다. 다만 그 판단에 전문 지식이 필요 없도록 화면이 짜여 있어서,
처음 온 직원도 할 수 있는 수준입니다.

[이미지 5: 카피 검토 화면 — 생성 카피와 근거 리뷰가 나란히 보이는 캡처]

상세페이지 OS는 콘텐츠와 코드 측면에서 GPT나 제미나이, 구글등에 추천될 수 있는 구조를 만드는데 있습니다.
"근거 없는 카피는 쓰지 않는다". 실제 리뷰·Q&A를 문장 단위로 쪼개 needs(해결하려는 문제) / wants(바라는 모습) / 걱정 / 결정 계기로 분류하고, 모든 문구에 출처 번호를 답니다. 상세페이지가 "우리가 하고 싶은 말"이 아니라 "고객이 이미 하고 있는 말"로 채워집니다.
이 고객 질문들이 그대로 AEO 재료가 됩니다. 섹션 제목을 실제 질문으로("우리 집에 설치할 수 있나요?") 달고 바로 아래에 답을 두고, 수치는 이미지가 아닌 진짜 글자로 두면 — AI가 내 페이지를 읽고 고객 질문에 내 상품으로 답하게 됩니다. 포토샵 이미지에서는 성립할 수 없는 일입니다.
사진 설명(캡션)도 규칙화했습니다. AI가 시적으로 지어내길래("천장으로 번지는 저녁의 무드"...) 이렇게 다시 줬습니다:
# 캡션 출력 규칙
1. 사진에 보이는 것을 담백하게 설명 (시적 표현 금지)
2. 명사형으로 끝낸다 / 한글 8~20자, 25자 초과 금지
3. alt와 같은 문장 금지 / "사진·이미지" 표현 금지 / ~입니다 금지
+ 실물 사진을 확인하지 않고는 쓰지 않는다
마지막 줄이 핵심입니다. AI는 사진을 안 보고도 그럴듯하게 지어냅니다. 실물을 확인시키자 틀린 설명("화이트 단독 컷" → 실제로는 두 컬러 비교 컷)이 바로잡혔습니다.
이렇게 만들어진 콘텐츠를 시멘틱 구조로 코딩하는 것은 AI 봇이 맥락을 파악해서 상품을 찾는 고객에게 우리 상품을 추천할 수 있게 하는 중요한 포인트입니다.
결과와 배운 점
직접 해보니 이렇게 달랐습니다 (이번 실험 기준의 비교입니다):
포토샵 이미지 방식 | 디자인 시스템 + AI 코딩 | |
|---|---|---|
제작 | 외주 1~2주 | 자료 올리면 AI가 생성 |
수정 | 디자이너 요청·대기·비용 | 문구만 고치면 즉시 반영 |
두 채널 | 디자인 하나 제작 | 원고 한 벌 → 두 벌 출력 |
통일성 | 만들 때마다 흔들림 | 토큰·표준 블록으로 보장 |
SEO/AEO | AI에게 백지 | 검색·AI가 읽는 페이지 |
상품이 늘면 | 상품 수만큼 비용·기간 반복 | 자료 준비 → 같은 공정 반복 (수백 개도 동일) |
가장 큰 배움: 필요한 건 코딩 실력이 아니라 "규칙을 문서로 만드는 일"이었습니다. 상품마다 필요한 건 새 디자인이 아니라 그 브랜드의 디자인 시스템과 통일된 기획 규칙이었고, 이 두 문서가 생기니 코드는 AI의 일이 되었습니다. 만드는 과정에서 사람이 직접 코드를 짤 일은 없었기 때문에, 코딩 경험이 없는 분도 시도해 볼 수 있는 방식이라고 생각합니다. 상세페이지 때문에 고민해 본 분들이라면 비슷하게 실험해 보실 수 있을 것 같아, 과정을 그대로 나눕니다.
시행착오와 꿀팁:
AI가 "확인했다"고 해도 검증하세요. 이미지 변환 결과가 백지였는데 AI는 정상이라 답한 적이 있습니다. 이후 모든 결과물에 기계 검증(픽셀 검사, 금지 태그 0건 체크)을 붙였습니다.
규칙은 실제 등록 테스트로 확정하세요. "표는 무조건 깨진다"던 통념도 직접 올려보니 멀쩡했습니다. 도구별 역할 분담(GPT로 조사 → 실등록 테스트 → 클로드로 원칙 문서화)이 여기서 힘을 발휘했습니다.
새 규칙을 만들기 전에 기존 규칙과 대조하세요. 쌓다 보면 충돌합니다. "먼저 대조, 그다음 결정"을 절차로 만들었습니다.
도움이 필요한 부분: 스마트스토어 필터 규칙이 공지 없이 바뀔 수 있어서, 등록 후 검증 체크리스트를 매번 돌리고 있습니다. 비슷한 경험이나 최신 정보 있으신 분과 교류하고 싶습니다.
앞으로의 계획: 신규 상품은 자료(스펙·리뷰·사진)만 올리면 두 채널 상세페이지가 자동으로 나오는 단계까지 갑니다. 목표는 "오늘 입사한 직원이 업로드하고 확인만 하면 되는" 수준입니다.
도움 받은 글 (옵션)
네이버 스마트스토어 상세페이지 HTML 제약 — GPT 조사 + 자체 실등록 검증
schema.org FAQPage 구조화 데이터 문서
로그인하고 댓글을 남겨 주세요
원고 한 벌에서 카페24용과 스마트스토어용 코드를 각각 출력하도록 만들고, 실제 등록·실기기 검증을 거쳐 디자인 시스템을 확정하신 과정이 정말 인상적입니다. 특히 “CSS가 전부 제거되어도 내용이 온전히 전달되는가”라는 기준을 세운 뒤, 표에 대한 보수적인 규칙까지 실등록 결과에 맞춰 개정하신 점에서 실험을 지식으로 바꾸는 꼼꼼함이 느껴졌어요. 고객 리뷰와 Q&A를 근거로 카피를 만들고 출처까지 연결한 덕분에, 코딩을 넘어 반복 가능한 상세페이지 제작 공정을 완성하신 점이 돋보입니다.



선좋아요, 후정독 하겠습니다!
오늘 오프모임에서 뵙게되어 반가웠어요🤗