
moai-seller
이커머스 셀러 전담 AI 코워커 — 스마트스토어·아임웹·카페24 MCP 연동과 상세페이지·마켓플레이스·광고·CRM 등 커머스 실무 스킬. VOC·채널 메시지는 moai-cs(CS매니저)로 이관. 자연어 요청 시 매칭 스킬이 자동 호출됩니다. 이런 분께 추천: 온라인 셀러·이커머스 운영자.
- version
- 1.4.33
- GitHub stars
- 316
Install
/plugin install moai-seller@moai-coworkRun it inside Claude Code after adding the marketplace with /plugin marketplace add modu-ai/moai-cowork.
Contents
Discovered from sourceSkills 33
광고 문구·표시 법규 검증 게이트 (Ad Claim Compliance KR)
개요
한국 셀러가 상세페이지·광고 소재·리스팅·SNS 광고에 사용할 카피를 발행하기 전, 표시광고법·식약처 규정·전자상거래법 3개 축으로 표현의 적법성을 점검하는 사전 게이트 스킬입니다.
책임 한 줄: 광고 카피(또는 상세페이지 전문) + 상품 카테고리 입력 → 3축 위험 신호 검사 → [문구 | 확인할 사항 | 근거 | 수정안] 표. 자료가 없으면 적법성 PASS를 선언하지 않습니다.
페어 분리: commerce-message-compliance-kr는 메시지 발송(정통망법 스팸 규정 — 옵트인·야간·수신거부) 전담이고, 본 스킬은 문구·표현 전담입니다. CRM 광고 메시지는 두 게이트를 모두 통과해야 합니다.
검사 축 1 — 표시광고법 부당표시 6유형
「표시·광고의 공정화에 관한 법률」 제3조 제1항은 부당한 표시·광고를 금지합니다. 법 조문상 4유형(거짓·과장 / 기만 / 부당 비교 / 비방)에 실무 빈발 파생 2유형을 더해 6유형으로 검사합니다.
| # | 유형 | 근거 | 검출 예시 |
|---|---|---|---|
| 1 | 거짓·과장 표시광고 | 표시광고법 제3조 제1항 제1호 | 근거 없는 "국내 판매 1위", "100% 효과" |
| 2 | 기만적 표시광고 (중요 정보 은폐·축소) | 표시광고법 제3조 제1항 제2호 | 유료 부가조건 미고지, 체험단 대가 관계 은폐 |
| 3 | 부당 비교 표시광고 | 표시광고법 제3조 제1항 제3호 | 기준·근거 없이 "타사 대비 2배" |
| 4 | 비방적 표시광고 | 표시광고법 제3조 제1항 제4호 | 경쟁사 제품의 결점을 근거 없이 지목 |
| 5 | 최상급·단정 표현 (거짓·과장의 파생) | 제3조 제1항 제1호 + 공정위 심사지침 | "최고", "최초", "유일" — 객관적 입증자료 없으면 위반 |
| 6 | 근거 미보유 실증 대상 주장 | 표시광고법 제5조 (실증 책임) | "임상 검증", "특허 기술" — 광고주가 입증자료 보유 의무 |
제재 수준: 위반 시 시정조치·과징금(관련 매출액 기준) 및 형사처벌 조항이 있습니다(표시광고법 제17조 등). 구체 액수는 사안별로 달라 '확인 필요'로 안내합니다.
최상급 표현 처리 원칙: "1위", "최초", "유일"은 자동 삭제가 아니라 입증자료(조사기관·기간·모수) 병기 여부를 확인합니다. 자료가 없으면 삭제 또는 "OO 기준" 한정 문구로 수정안을 제시합니다.
검사 축 2 — 식약처 의약품-오인 표현 금지
식품(건강기능식품 포함)과 화장품은 질병의 예방·치료 효능이 있는 것으로 오인될 표현이 금지됩니다.
2-1. 식품·건강기능식품
- 근거: 「식품 등의 표시·광고에 관한 법률」 제8조 (질병 예방·치료 효능 표방 금지, 의약품 오인 표시 금지, 건강기능식품 오인 표시 금지)
- 건강기능식품은 식약처가 인정한 기능성 문구만 사용 가능하며, 인정 문구를 임의로 강화·변형할 수 없습니다.
| 금지 표현 예시 | 사유 | 수정 방향 |
|---|---|---|
| "면역력 치료", "당뇨 개선", "암 예방" | 질병 예방·치료 효능 표방 | 인정받은 기능성 문구 원문으로 대체 (예: "면역 기능 증진에 도움을 줄 수 있음") |
| "다이어트 약", "지방 분해" | 의약품 오인 | "체지방 감소에 도움을 줄 수 있음" (해당 기능성 인정 원료인 경우에 한함) |
| 일반식품에 "관절 건강", "혈행 개선" | 일반식품의 기능성 표방 | 기능성 표현 삭제 또는 건강기능식품 인증 취득 후 사용 |
| "부작용 없음", "100% 천연이라 안전" | 절대적 안전성 단정 | 안전성 단정 문구 삭제 |
기능성 원료의 인정 문구·1일 섭취량은 현재 식약처 공식 자료와 제품별 인정 서류를 대조합니다. moai-lawyer:legal-mfds-safety가 설치되고 실제 조회가 가능하면 보조로 사용합니다. 조회나 서류 대조가 불가능하면 해당 표현의 적합성은 미확인으로 남기며 PASS로 표시하지 않습니다.
2-2. 화장품
- 근거: 「화장품법」 제13조 (의약품으로 잘못 인식할 우려가 있는 표시·광고 금지) + 식약처 「화장품 표시·광고 관리 가이드라인」
| 금지 표현 예시 | 사유 | 수정 방향 |
|---|---|---|
| "아토피 완화", "여드름 치료", "염증 개선" | 질병명 사용 = 의약품 오인 | 질병명 삭제, "피부 진정" 등 화장품 범위 표현 |
| "주름 제거", "흉터 재생", "탈모 치료" | 의학적 효능 단정 | 기능성화장품 심사·보고 범위 내 표현 ("주름 개선에 도움") |
| "미백" (비기능성 제품) | 기능성화장품 전용 표현 | 기능성 심사를 받은 제품만 사용, 미심사 제품은 "톤 정리" 등 |
| "피부과 의사 추천" (근거 없음) | 의료 권위 오용 + 실증 대상 | 실증자료 확보 또는 삭제 |
검사 축 3 — 전자상거래법 필수 고지
「전자상거래 등에서의 소비자보호에 관한 법률」(전상법) 기준으로 상세페이지·주문 화면의 필수 고지 사항을 점검합니다.
| # | 점검 항목 | 근거 | 판정 기준 |
|---|---|---|---|
| 1 | 청약철회 안내 (수령일로부터 7일) | 전상법 제17조 제1항 | 7일 미만으로 축소 고지·"환불 불가" 일괄 표기 시 BLOCK |
| 2 | 청약철회 제한 사유 고지 | 전상법 제17조 제2항·제6항 | 제한 사유(소비자 훼손, 신선식품 등)는 사전 고지 + 포장 등 조치가 있어야 유효 |
| 3 | 통신판매업 신고 여부와 신고번호 표시 | 전상법 제12조·제13조 | 신고 대상인지, 제12조 신고 예외에 해당하는지 먼저 확인. 신고 대상인 경우에만 번호 표시를 점검. 확인 불가 시 미확인으로 기록 |
| 4 | 사업자 정보 (상호·대표자·주소·연락처·사업자등록번호) | 전상법 제13조 | 누락 항목별 지적 |
| 5 | 배송비·반품비 부담 주체 고지 | 전상법 제13조 + 제18조 | 반품 배송비 금액·부담 주체 미고지 시 WARN |
| 6 | 재화 공급(배송) 시기 고지 | 전상법 제13조 | 배송 예정 기간 미표기 시 WARN |
반품비와 청약철회 제한 사유는 상품·계약·실제 고지 화면을 함께 확인합니다. 하자·오배송과 단순 변심을 구분하고, 현행 조문과 적용 예외를 확인합니다.
워크플로우
입력 슬롯
| 항목 | 필수 | 예시 |
|---|---|---|
| 광고 카피 / 상세페이지 전문 | 필수 | "먹기만 해도 살 빠지는 국내 1위 다이어트 젤리" |
| 상품 카테고리 | 필수 | 일반식품 / 건강기능식품 / 화장품 / 기능성화장품 / 일반 공산품 |
| 입증자료 보유 여부 | 권장 | "1위 근거: OO리서치 2026.03 조사 보유" |
| 판매 채널 | 권장 | 스마트스토어 / 쿠팡 / 자사몰 (전상법 고지 위치 점검용) |
점검 순서
[Step 1] 카테고리 판별
├─ 식품·건기식 → 축 2-1 활성화
├─ 화장품 → 축 2-2 활성화
└─ 기타 → 축 1·3만 검사
[Step 2] 축 1 — 표시광고법 6유형 스캔
└─ 문구 단위로 유형 태깅 + 실증자료 보유 확인
[Step 3] 축 2 — 의약품 오인 표현 스캔 (해당 카테고리만)
├─ 질병명·치료·처방 계열 어휘 검출
└─ 기능성 인정 문구 대조 (미확인 시 legal-mfds-safety 조회 권장)
[Step 4] 축 3 — 전상법 필수 고지 체크리스트
└─ 6항목 존재·정합성 점검
[Step 5] 검토 결과 + 수정안
├─ 근거와 사실관계가 확인된 문제 → 발행 보류 + 문구별 수정안
├─ 자료·고지 화면·인정 문구 미확인 → 확인 필요
└─ 검토한 범위에서 문제 미발견 → 검토 범위와 미확인 항목 명시
출력 형식
위반 항목은 반드시 아래 표 형식으로 제시합니다.
## 판정: BLOCK (위반 3건 · 보완 2건)
### 위반 표
| 문구 | 위반 유형 | 근거 | 수정안 |
|------|----------|------|--------|
| "먹기만 해도 살 빠지는" | 의약품 오인 (체중 감량 효능 단정) | 식품표시광고법 제8조 | "체지방 감소에 도움을 줄 수 있는" (기능성 인정 원료·문구 확인 필요) |
| "국내 1위" | 최상급 표현 실증 미비 | 표시광고법 제3조 제1항 제1호·제5조 | 입증자료 병기: "OO 조사 기준(기간·기관 명시)" 또는 삭제 |
| "환불 불가 상품입니다" | 청약철회권 배제 고지 | 전상법 제17조 제1항 | "수령일로부터 7일 이내 청약철회 가능(제한 사유: ...)" 로 교체 |
### 보완 목록 (WARN)
- 통신판매업 신고 대상 여부 미확인 — 전상법 제12조의 신고 예외 해당 여부를 먼저 확인하고, 신고 대상인 경우에만 표시 상태를 점검
- 반품 배송비 금액 미고지 — 전상법 제13조 (예: "단순 변심 반품비 3,000원, 하자 시 판매자 부담")
### 재검 안내
수정안 반영 후 근거 자료와 현재 고지 화면을 다시 대조하십시오.
사용 예시
"이 상세페이지 표시광고법 점검해줘: '피부과 시술급 미백 효과, 아토피에도 안심'" (일반 화장품)
→ BLOCK: ① "미백" 기능성 미심사 사용 (화장품법 제13조) ② "아토피" 질병명 = 의약품 오인
③ "시술급" 의료 효능 암시 — 문구별 수정안 3건 제시
"건기식 광고 카피 검사: '면역력 증진에 도움을 줄 수 있음 (식약처 인정 기능성)'"
→ 확인 필요: 해당 제품의 인정 원료·기능성 문구·섭취량과 실제 광고 문구 대조
"자사몰 주문 페이지 전상법 체크"
→ WARN: 청약철회 7일 안내 있음 / 신고번호·반품비 고지 누락 2건 보완 목록
주의사항
- 법률 자문이 아닙니다: 본 스킬은 공개된 법령·가이드라인 기반의 사전 자가점검 도구이며, 법적 효력이 있는 판단이 아닙니다. 제재 리스크가 큰 사안(기능성 표방, 의료기기·의약외품 경계, 과징금 다툼)은 변호사 또는 해당 심의기구 확인이 필요합니다.
- 광고 사전심의: 건강기능식품 광고는 자율심의기구(한국건강기능식품협회) 사전 심의 대상입니다(식품표시광고법 제10조). 본 게이트 PASS가 심의 통과를 보장하지 않습니다.
- 수치·제재액: 과징금·과태료 구체 액수는 매출액·사안에 따라 달라 본 스킬은 조문만 인용하고 금액은 '확인 필요'로 표기합니다.
- 법령 개정: 조문 번호·기준은 개정될 수 있으므로 산출물에 점검 기준일을 명기하고, 연결된 법령 도구 또는 국가법령정보센터에서 현행 조문을 확인합니다. 도구가 연결되지 않았으면 직접 확인할 출처를 제시하고 미확인으로 표시합니다.
관련 스킬
체이닝 위치: 카피 산출 직전 마지막 게이트 — commerce-detail-page-copy/content-copywriting (카피 작성) → commerce-ad-claim-compliance-kr (문구 게이트) → 발행. CRM 메시지는 이후 commerce-message-compliance-kr(발송 게이트)도 통과.
commerce-message-compliance-kr— 정통망법 발송 규제 게이트 (페어: 발송 vs 문구)moai-lawyer:legal-mfds-safety— 식약처 기능성 원료·회수·부적합 실측 조회moai-lawyer:legal-compliance-check— 사업 전반 컴플라이언스 점검commerce-detail-page-copy— 상세페이지 카피 작성 (이전 단계)moai-cs:cs-draft-response— 청약철회·반품 CS 응답 (references/kr-ecommerce-cs-law.md 공유)
참고 자료
- 「표시·광고의 공정화에 관한 법률」 제3조·제5조·제17조
- 「식품 등의 표시·광고에 관한 법률」 제8조·제10조
- 「화장품법」 제13조 + 식약처 화장품 표시·광고 관리 가이드라인
- 「전자상거래 등에서의 소비자보호에 관한 법률」 제13조·제17조·제18조
커머스 자동화 진단
입력 확인
업무별 처리 건수, 한 건당 소요 시간, 예외율, 오류 처리 비용, 현재 도구, 담당자, 판매 채널을 확인한다. 이 중 빠진 값은 미측정으로 적고 효과 계산에서 제외한다. 고객 정보, 주문 정보, 가격을 바꾸는 권한은 현재 연결된 공식 연동과 판매자 계정 범위에서 확인한다.
진단
상품 운영, 가격·프로모션, 주문·정산, 재고·물류, 마케팅·고객, 데이터·경영의 업무를 각각 기록한다. 반복 업무라는 이유만으로 자동화하지 않는다. 입력 품질, 처리 규칙, 예외 사례, 되돌리기 방법을 먼저 확인한다.
| 항목 | 확인할 내용 |
|---|---|
| 현재 작업 | 시작 조건, 입력, 출력, 담당자, 처리 건수 |
| 데이터 | 누락·중복·시차, 개인정보 포함 여부 |
| 연동 | 해당 계정의 API·MCP 권한, 사용 제한, 장애 처리 |
| 예외 | 취소·환불·부분 배송·품절·중복 요청 |
| 승인 | 가격, 발송, 환불, 재고 조정의 책임자 |
| 결과 | 처리 시간, 오류, 재작업, 고객 영향 |
자체 클라이언트를 새로 설계하기 전에 서비스의 공식 MCP가 필요한 작업을 제공하는지 확인한다. 제공하지 않는 기능은 해당 공식 API의 권한과 약관을 확인한 뒤 별도 개발 범위를 제안한다. 크롤링이나 키 우회는 대체 연결 수단으로 제시하지 않는다.
우선순위
후보별로 월간 절감 시간은 월간 건수 × (기존 처리 시간 − 자동화 후 검수 시간) − 예외 처리 시간으로 계산한다. 금액은 실제 인건비·도구 사용료·구축비·유지비·오류 비용을 같은 기간으로 맞춰 산출한다. 값이 없으면 순위는 정성 판단으로 표시하고, 작은 파일럿에서 측정할 항목을 정한다. 특정 영역이 항상 가장 높은 ROI라고 가정하지 않는다.
실행 순서
- 기준선 측정: 같은 유형의 작업과 예외를 일정 기간 기록한다.
- 작은 파일럿: 한 업무를 고르고, 되돌릴 수 있는 범위에서 실행한다. 고객·가격·환불에 영향을 주는 쓰기 작업은 담당자가 승인한다.
- 검증·확대: 기준선과 파일럿의 처리 시간, 오류, 재작업, 고객 영향을 비교한다. 효과가 확인된 작업만 넓힌다.
재시도는 멱등성과 중복 처리를 확인한 작업에만 적용한다. 주문 생성·환불처럼 되돌릴 수 없는 결과는 실패했다고 무작정 재시도하지 않는다. 보존 기간이 정해진 감사 기록은 그 기간에 맞춰 남긴다.
출력
업무별 현황 표, 데이터·권한의 빈칸, 우선순위 근거, 파일럿 범위, 사람의 승인 지점, 성공·중단 기준을 낸다. 절감률·ROI·일정은 실제 자료나 명시된 가정으로 계산할 수 있을 때만 제시한다. 보고서 검수 도구가 연결돼 있지 않으면 자동 검수를 수행했다고 적지 않는다.
commerce-coupang-ad-optimizer → commerce-marketplace-coupang-ads (이름 변경됨)
이 스킬은 moai-seller:commerce-marketplace-coupang-ads로 이름이 변경되었습니다 (marketplace-* 패밀리 편입). 쿠팡 광고 최적화 작업은 moai-seller:commerce-marketplace-coupang-ads를 사용하세요. 이 스텁은 기존 호출 호환을 위해 유지됩니다.
상세페이지 카피
입력
상품명, 실제 사양·사진, 판매 가격, 대상 고객, 판매 채널, 근거 자료를 확인합니다. 후기·통계·인증·전문가 인용·보증·재고·마감일은 출처가 있을 때만 사용합니다. 자료가 없으면 해당 문구를 생략하고 필요한 자료를 표시합니다. URL이나 이미지를 열 수 없다면 페이지 진단이 제한됨을 밝힙니다.
작업 방식
- 기본:
references/13-sections.md를 선택 가능한 구조로 사용해 Hero, Pain, Problem, Story, Solution, How, Proof, Authority, Benefits, Risk, Compare, Filter, CTA 카피를 만듭니다. 상품에 맞지 않거나 근거가 없는 섹션은 억지로 채우지 않습니다. --mode diagnose: 실제로 확인한 페이지 요소만 평가합니다. 점수를 매긴다면 기준과 확인 범위를 함께 기록하고, 보지 못한 항목에는 점수를 주지 않습니다.--mode copy: 사용자가 제공한 고객 조사나 JTBD 자료를 토대로 필요한 만큼 대안을 만듭니다. 페르소나 이름·나이·직업을 임의로 사실처럼 만들지 않습니다. 25/50/25 같은 분량 비율은 참고용이며 상품과 채널에 맞게 조정합니다.
검수
- 제품 특징을 고객에게 어떤 의미가 있는지 풀어 쓰되 확인되지 않은 효과를 약속하지 않습니다.
- 건강·식품·화장품·의료 관련 표현은 근거와 현재 적용 규정을 확인합니다.
commerce-ad-claim-compliance-kr의 결과도 법적 승인으로 단정하지 않습니다. - 사용 가능한 경우
moai-coworker:ai-slop-reviewer와moai-writer:korean-humanize를 통해 문장을 다듬고 원문 사실관계를 다시 대조합니다. 호출하지 못한 검수는 완료로 표시하지 않습니다. - 가격·할인·환불·재고·마감, 후기·통계·인용의 출처와 날짜를 최종 카피에 연결합니다. 채널 정책은 게시 전 해당 채널의 현재 공지를 확인합니다.
출력
섹션별 카피와 마크다운 미리보기, 근거가 필요한 자리, 확인한 출처, 미검수 항목을 함께 제공합니다. slop_review 같은 상태 필드는 실제 검수 결과가 있을 때만 씁니다. 이미지가 필요하면 commerce-detail-page-image, HTML 상세페이지가 필요하면 commerce-product-detail로 넘깁니다.
상세페이지 이미지 합성 (Detail Page Image Composer)
개요
13섹션 감정여정 상세페이지 이미지를 생성하고, 합성 도구가 있는 환경에서는 세로 PNG로 만드는 스킬입니다.
호스트에서 실제 사용 가능한 이미지 생성 도구로 섹션 이미지를 만듭니다.
Python과 Pillow가 실행 가능할 때만 1080×12720 단일 합성 이미지를 산출하며,
실행하지 못한 합성은 미완료로 보고합니다. 합성본은 작업용 원본이며,
판매 채널에 올리기 전 현재 계정의 이미지 규격과 길이·용량 제한을 확인합니다.
아래 인라인 코드는 작업용 합성까지만 수행하며, 채널별 변환이나 업로드는
수행하지 않습니다. 규격이 다르면 변환 방법과 필요한 도구를 안내하고
변환·업로드 결과가 확인되기 전에는 업로드 준비 완료로 표시하지 않습니다.
트리거 키워드
상세페이지 이미지, 상폐 이미지, 13섹션 이미지, 1080 12720, 상세페이지 합성, 상품 상세 이미지, combined.png, 상폐 합성본, 이커머스 이미지 합성
사전 조건
-
합성 실행 환경 확인: 현재 앱의 실행 환경에서 Python과 Pillow를 실제 호출할 수 있는지 확인합니다. 버전 문자열만으로 가능 여부를 판정하지 않습니다. 호출할 수 없으면 사용자에게 패키지 설치를 요구하지 않고, 섹션 이미지와 합성 명세를 제공하며 단일 PNG 합성은 미완료로 기록합니다.
-
이미지 생성 도구 확인: ChatGPT Work에서는 현재 앱의 기본 이미지 도구를 확인한다. Images 2.5를 명시했으면 노출된 모델을 확인하고, 모델이 보이지 않으면 정확한 버전을 미확인으로 남긴다. Flare·Sunburst API 모델 ID 지정 요청은 별도 API 경로가 실제 연결된 경우에만 따른다. Higgsfield 지정 시 Claude는 공식 MCP, ChatGPT는 별도로 설치·인증한 Higgsfield 공식 플러그인의 실제 도구를 확인한다.
- 또는 사용자가 별도로 13장의 섹션 이미지를 준비해서 폴더 경로 제공
-
상품 사진 1-14장: 실제 상품 레퍼런스 (옵션이지만 권장)
워크플로우
1단계: 입력 수집
다음을 확보합니다:
- 13섹션 카피 JSON (
commerce-detail-page-copy스킬 출력) - 상품 사진 1-14장 경로
- 카테고리 (electronics/fashion/food/beauty/home/supplement/pet/kids/handmade/general)
- ProductDNA (선택,
commerce-product-photo-brief스킬 출력) - 출력 디렉토리 (기본:
./commerce-output/{job_id}/)
2단계: 13섹션 이미지 프롬프트 생성
각 섹션의 카피와 카테고리 비주얼 브리프를 합쳐 선택한 이미지 도구용 프롬프트를 작성합니다.
references/image-prompts.md 참조 (섹션별 비주얼 언어, 합성 가이드).
각 섹션은 고유한 비주얼 언어를 가집니다:
- Hero: cinematic_product_portrait — 풀블리드 + 드라마틱 림라이트
- Pain: emotional_photography_no_product — 어두운 톤, 상품 미노출
- Problem: clinical_infographic — 깔끔한 인포그래픽
- Story: editorial_split_before_after — Before/After 좌우 분할
- Solution: product_beauty_shot — 스튜디오 뷰티샷
- How: illustrated_step_sequence — 3단계 일러스트
- Proof: magazine_spread — 매거진 스프레드
- Authority: portrait_with_quote — 인물 포트레이트 + 인용
- Benefits: icon_grid_with_lifestyle — 아이콘 그리드 + 라이프스타일
- Risk: document_with_seal — 문서·인증 스타일
- Compare: split_screen_vs — 50/50 분할 비교
- Filter: checklist_visual — 체크리스트 시각화
- CTA: product_reveal — 상품과 구매 행동 안내. 할인·마감은 실제 근거가 있을 때만 추가
3단계: 이미지 생성
ChatGPT Work에서 기본 이미지 생성 도구가 노출되면 그 도구로 진행합니다. Images 2.5 요청의 정확한 모델은 도구가 표시할 때만 확정하고, Flare·Sunburst API 모델 ID 지정 요청은 별도 API 경로가 확인될 때만 해당 모델로 진행합니다. Higgsfield 지정 시 호스트에 맞는 공식 연결의 모델·도구·비용을 확인하고 유료 호출 전에 사용자 승인을 받습니다. Higgsfield는 채팅 첨부 파일을 생성 도구가 직접 읽지 못하므로 상품 참조 사진은 별도 업로드 완료 또는 기존 자산 확인 후에만 생성 호출에 넘깁니다. 어느 경로도 사용할 수 없으면 생성 불가 섹션을 보고하고 사용자가 준비한 이미지를 받습니다.
생성 전략:
- 각 섹션 너비: 1080px
- 섹션별 높이:
references/sections-spec.md표 참조 (Hero 1600-Filter 700) - 카테고리 비주얼 브리프(electronics/fashion/...) 모든 프롬프트에 주입
- 상품 레퍼런스 사진은 선택한 도구가 해당 입력을 지원할 때만 전달
생성 결과를 output_dir/{job_id}/sections/01_hero.png 부터 13_cta.png 까지 저장.
생성 실패 시 해당 섹션을 실패로 기록합니다. 임시 합성본에 빈 영역을 넣을 수 있지만 완성본으로 보고하지 않습니다.
4단계: 1080×12720 합성 (Pillow 인라인 조립)
별도 스크립트 없이, 아래 Pillow 코드를 그대로 실행해 13장을 세로로 이어붙입니다.
동작: (1) 01_hero~13_cta 순서 로드 → (2) 너비 1080으로 리사이즈(비율 유지 + 중앙 크롭) →
(3) 섹션별 표준 높이로 조정 → (4) 세로 스택 → (5) 누락 섹션은 (40,40,40) 다크 플레이스홀더로 대체하고 combined-draft.png로 저장.
from PIL import Image
from pathlib import Path
WIDTH = 1080
# (파일명 슬러그, 표준 높이) — sections-spec.md 표와 동일
SECTIONS = [
("01_hero", 1600), ("02_pain", 800), ("03_problem", 800), ("04_story", 1200),
("05_solution", 800), ("06_how", 900), ("07_proof", 1420), ("08_authority", 800),
("09_benefits", 1200), ("10_risk", 800), ("11_compare", 800), ("12_filter", 700),
("13_cta", 900),
]
PLACEHOLDER = (40, 40, 40)
def fit(img, w, h):
# 비율 유지 리사이즈 후 중앙 크롭으로 정확히 w×h 맞춤
scale = max(w / img.width, h / img.height)
img = img.resize((round(img.width * scale), round(img.height * scale)), Image.LANCZOS)
left, top = (img.width - w) // 2, (img.height - h) // 2
return img.crop((left, top, left + w, top + h))
sections_dir = Path("./commerce-output/JOB_ID/sections") # 실제 job_id로 치환
sections_dir.mkdir(parents=True, exist_ok=True)
total_h = sum(h for _, h in SECTIONS)
canvas = Image.new("RGB", (WIDTH, total_h), PLACEHOLDER)
failed, y = [], 0
for slug, h in SECTIONS:
p = sections_dir / f"{slug}.png"
if p.exists():
with Image.open(p) as source:
canvas.paste(fit(source.convert("RGB"), WIDTH, h), (0, y))
else:
failed.append(slug) # 누락 → 다크 플레이스홀더 그대로 유지
y += h
output = sections_dir.parent / ("combined-draft.png" if failed else "combined.png")
canvas.save(output)
print({"size": f"{WIDTH}x{total_h}", "output": str(output), "failed_sections": failed})
높이 표준값은 references/sections-spec.md를, 섹션별 비주얼 언어는 references/image-prompts.md를 참조합니다.
5단계: 출력 보고
{
"job_id": "a1b2c3d4",
"output_dir": "/abs/.../commerce-output/a1b2c3d4",
"combined": "/abs/.../combined.png",
"sections": [
"/abs/.../sections/01_hero.png",
"...",
"/abs/.../sections/13_cta.png"
],
"failed_sections": [],
"elapsed_sec": 0,
"size": "1080x12720"
}
failed_sections가 비어있지 않으면 combined-draft.png는 검토용이라고 밝히고 사용자에게 다음을 안내:
- 어떤 섹션이 실패했는지
- 같은
--output --job-id로 재실행 시 자동 재개되는지 (재개는 사용자가 수동으로 해당 섹션만 재생성)
출력 파일 구조
./commerce-output/{job_id}/
├── analysis.json # 13섹션 카피 + 프롬프트 + ProductDNA
├── sections/ # 13장 섹션 (1080×가변)
│ ├── 01_hero.png (1080×1600)
│ ├── 02_pain.png (1080×800)
│ ├── ...
│ └── 13_cta.png (1080×900)
└── combined.png # 1080×12720 세로 합성본
합성 코드 조정 포인트
4단계 인라인 Pillow 코드에서 다음 값만 바꾸면 됩니다:
WIDTH: 출력 너비 (기본 1080)PLACEHOLDER: 누락 섹션 색 (기본(40, 40, 40))SECTIONS: 섹션 순서·표준 높이 (기본 13섹션,references/sections-spec.md와 동일)sections_dir: 실제 job_id 경로로 치환
이 스킬은 부재 스크립트(compose.py) 참조를 원칙 A(프롬프트/인라인 코드 경로)로 대체했습니다 — 합성은 위 Pillow 코드를 직접 실행합니다.
사용 예시
- "이 카피 결과로 13섹션 이미지 합성해줘"
- "상품사진 5장으로 상세페이지 1080 12720 만들어줘"
- "electronics 카테고리, 무선 이어폰 상세페이지 이미지 풀세트"
관련 스킬
moai-seller:commerce-detail-page-copy— 13섹션 카피 생성 (이 스킬 입력)moai-seller:commerce-product-photo-brief— 상품 사진 사전 분석- 13섹션 이미지 생성 — 현재 앱 이미지 도구 또는 호스트에 맞게 인증된 Higgsfield 공식 연결
moai-seller:commerce-marketplace-coupang— 채널별 이미지 규격 가이드
이 스킬을 사용하지 말아야 할 때
- 카피만 필요할 때:
commerce-detail-page-copy단독 사용 - 단일 상품 컷만 필요할 때: 사용 가능한 이미지 도구 직접 호출
- 영상 생성: 호스트에 맞게 인증된 Higgsfield 공식 연결에서 해당 도구가 노출될 때만 호출
- shadcn/ui 기반 웹 상세페이지:
moai-seller:commerce-product-detail
라이선스
MIT.
상세페이지 기획
입력
상품의 실제 사양·사진·가격·판매 채널·고객 질문과 검증 가능한 장점을 확인합니다. 구매 후기·성능 수치·인증·안전성·효과는 자료가 없으면 브리프에서 미확인으로 표시합니다.
기획
- 고객이 알아야 할 핵심 메시지를 한 문장으로 정합니다. 제품의 성능·안전 약속은 근거 자료의 범위를 넘지 않습니다.
- 상품 특징, 사용법, 옵션·규격, 가격·배송·교환·반품, 실제 근거, 구매 행동을 이해하기 쉬운 순서로 배치합니다. 13섹션 구조는 선택 가능한 틀이며 모든 섹션을 채울 필요는 없습니다.
- 기존 상품 사진을 섹션과 연결하고 부족한 컷의 촬영 브리프를 만듭니다. 인물·고객 후기·인증서는 실제 자료와 사용 권한이 있을 때만 씁니다.
- 채널별로 현재 등록 규격과 광고·표시 정책을 공식 판매자 문서에서 확인합니다.
references/category-*.md와photo-checklist.md는 아이디어 목록이며 수치·법적 표현은 최신 자료로 다시 검증합니다.
산출물
핵심 메시지, 대상 고객의 확인된 요구, 페이지 정보 순서, 사용할 원본 사진, 추가 촬영 컷, 채널별 규격·정책 확인 결과, 누락된 근거를 짧은 브리프로 정리합니다. 실제 카피는 commerce-detail-page-copy, 이미지 합성은 commerce-detail-page-image, HTML은 commerce-product-detail로 이어갑니다. 자동 호출이나 완료 상태를 확인 없이 주장하지 않습니다.
초기 고객 관계 만들기
먼저 확인할 것
제품·가격·고객층·현재 구매자 수·가용 예산·동의받은 연락 수단을 확인한다. 첫 고객 수를 100명으로 고정하거나 30일 안에 달성한다고 약속하지 않는다. 기존 자료에 없는 브랜드 성공 사례를 사실처럼 쓰지 않는다.
실행 설계
- 구매자가 만족하는 이유와 불편한 점을 주문·문의·반품 자료에서 확인한다.
- 고객 연락은 동의 범위와 채널 정책에 맞게 한다. 임의의 대량 DM이나 커뮤니티 광고 게시를 권하지 않는다.
- 감사 메시지, 후기 요청, 고객 인터뷰는 대상·빈도·보상을 고객에게 투명하게 알린다. 대가를 준 후기를 자발적 후기처럼 쓰지 않는다.
- 고객 사진·영상은 재게시와 광고 사용 범위를 따로 동의받는다.
- 추천 프로그램은 실제 마진과 남용 가능성을 검토하고, 보상 조건을 명확하게 쓴다.
지표
첫 구매에서 재구매까지의 기간, 실제 재구매율, 연락 거부율, 후기 참여율, 추천을 통한 주문과 비용을 같은 기간·코호트로 측정한다. 광고가 초기 고객에게 언제나 불리하다거나 후기가 광고보다 100배 효율적이라고 가정하지 않는다.
산출물
확인된 고객군, 가능한 접점, 실행 항목, 담당자, 비용, 측정 지표를 표로 정리한다. 목표 숫자와 일정은 사용자가 제공한 자원·과거 실적에 맞춰 정한다.
관련 스킬
- commerce-promotion-planner: 프로모션 설계
- commerce-ltv-cac-architect: 고객 가치와 획득비용
- commerce-influencer-collab: 협업 후기·UGC
인플루언서·UGC 협업
입력
제품과 광고 표현의 제한, 협업 목적, 예산, 채널, 대상 청중, 콘텐츠 사용 기간·범위, 측정 방법을 확인한다. 팔로워 수만으로 전환율이나 비용을 추정하지 않는다. 협업 단가·성과는 실제 제안서와 과거 캠페인 자료로 검증한다.
경제적 이해관계 표시
공정거래위원회의 추천·보증 등에 관한 표시·광고 심사지침 개정 안내를 확인한다. 금전·제품·할인·제휴 수익·향후 조건부 대가 등 이해관계를 빠짐없이 검토한다. 글·영상·숏폼 등 매체별 최신 표시 방식과 플랫폼 정책을 게시 시점에 확인하고, 소비자가 쉽게 알아볼 수 있는 위치와 표현으로 표시한다. 모든 게시물에 같은 초수·줄 수 규칙을 기계적으로 적용하지 않는다.
협업 절차
- 후보의 청중·콘텐츠 품질·기존 유료 협업과 실제 단가를 확인한다.
- 산출물, 마감, 수정 횟수, 보수, 광고 표시, 2차 사용권, 사진·초상권, 성과 측정 조건을 문서로 정한다.
- 제품 효능·가격·비교 주장은 입증 자료와 카테고리별 광고 규정을 대조한다.
- 브랜드 계정에서 후기·사진을 재게시하거나 광고에 사용할 때는 저작권자와 촬영된 인물의 허락 범위를 확인한다. 허락 범위를 넘는 편집·2차 사용은 하지 않는다.
- 게시 후 실제 광고 표시와 링크·코드 작동을 확인한다.
산출물
후보 비교표, 협업 조건 초안, 게시 전 점검표, 확인된 성과 지표를 제공한다. 특정 과태료 액수나 협업 ROI를 근거 없이 단정하지 않는다.
관련 스킬
- moai-marketer:marketing-campaign-planner: 전체 캠페인
- moai-seller:commerce-ad-claim-compliance-kr: 상품 광고 주장 검토
이커머스 통합 전략
입력
사용자가 제공한 상품·마진·재고·채널 매출·광고 비용·전환 자료와 기존 조사 결과를 확인합니다. 연결된 커머스 MCP가 있으면 현재 계정 권한과 도구의 실제 응답을 확인하고, 없으면 사용자가 제공한 자료로 범위를 한정합니다. 데이터의 기간·통화·세금 포함 여부와 채널별 중복 집계 여부를 기록합니다.
분석
- 매출, 기여이익, 광고비, 반품, 재구매 지표를 같은 기간으로 맞춥니다. 분모나 비용 항목이 없으면 ROAS·LTV·마진을 확정하지 않습니다.
references/channel-mix.md,pricing.md,promotion.md,retention.md,kpi.md는 검토 항목의 참고 자료로 사용합니다. 문서 안의 비율·일정·수수료·법적 표현은 현재 계정과 공식 채널 안내로 확인하기 전에는 실행 기준으로 사용하지 않습니다.- 사업 단계·자원·상품 특성에 맞는 대안을 비교합니다. 채널 비중, 할인율, 광고비, CRM 발송 시점은 사용자 데이터가 뒷받침할 때만 숫자로 제안합니다. 고객 메시지 발송·광고 설정·가격 변경은 별도 실행과 확인이 필요한 외부 작업입니다.
- 실행 항목마다 근거, 예상 효과를 검증할 지표, 담당자, 중단 조건을 적습니다. 기존 자료만으로 판단할 수 없는 항목은 조사 과제로 남깁니다.
출력
- 현재 확인한 숫자와 기준 기간
- 우선순위별 실행 제안과 그 근거
- 필요한 권한·자료·승인
- 미확인 가정과 검증 방법
가능하면 moai-coworker:ai-slop-reviewer와 moai-writer:korean-humanize로 문체를 검토합니다. 실제로 실행하지 않은 검수는 완료로 표시하지 않습니다. 운영 자동화 세부 설계는 commerce-automation-audit를 사용합니다.
구매 동기와 고객 유형 분석
자료
사용자가 제공한 리뷰, 문의, 인터뷰, 시장조사 결과를 우선한다. 연결된 커머스 도구가 실제로 제공하는 조회 기능과 계정 권한을 확인한 뒤 사용한다. 자료마다 출처·기간·상품·건수를 기록한다. 경쟁 상품의 리뷰를 쓰는 경우에는 별도 집단으로 표시하고, 내 상품 고객의 행동으로 해석하지 않는다. 자료가 없으면 실제 고객 페르소나를 만들지 않고 조사 질문과 필요한 자료를 제안한다.
구매 동기
기능적·감정적·사회적 동기를 구분하되, 각 범주를 정해진 개수로 채우지 않는다. 고객의 말과 관찰에서 드러난 문제, 구매 전 상황, 대안, 선택 기준을 기록한다. 추론은 가설로 표시하고 근거 문장과 분리한다. 시장 규모·광고 효율·전환 가능성을 리뷰 빈도만으로 순위 매기지 않는다.
| 항목 | 기록할 내용 |
|---|---|
| 상황 | 구매 전 어떤 일이 있었나 |
| 해결할 일 | 고객이 무엇을 이루려 했나 |
| 대안 | 무엇과 비교했나 |
| 선택 기준 | 가격·편의·신뢰 등 실제 언급 |
| 근거 | 자료 출처와 인용 위치 |
| 불확실성 | 자료가 없는 집단과 반대 사례 |
고객 유형
자료에 구분되는 행동 패턴이 있으면 유형별 니즈·걱정·구매 기준을 작성한다. 구분이 약하면 하나의 공통 유형만 제시한다. 이름·나이·직업·일상은 자료에 없으면 만들지 않는다. 가상의 예시가 필요하면 가상 예시라고 표시한다. 고객 정보를 재식별할 수 있는 세부 내용은 출력에서 제거한다.
브랜드 관계 단계는 실제 접점 기록으로만 분류한다. 광고를 봤다는 사실만으로 구매 의향이나 광고 비용을 추정하지 않는다. 장바구니 이탈의 이유도 가격·신뢰 등으로 단정하지 말고 확인할 질문으로 둔다.
출력
- 자료 목록과 수집 범위
- 근거가 있는 구매 동기와 반대 사례
- 확인된 고객 유형 또는 유형을 만들기 어려운 이유
- 검증할 가설과 다음 조사 질문
문장 검수 스킬이 연결돼 있고 실제 실행했다면 결과를 기록한다. 실행하지 않은 검수 상태를 passed로 채우지 않는다. 자료가 부족할 때는 경쟁 상품 리뷰를 정해진 건수만큼 가져와 고객 유형을 자동 생성하지 않는다.
라이브 커머스 기획과 진행 스크립트
먼저 확인할 자료
요청한 문구나 기획에 필요한 범위에서 상품 사양·가격·재고·배송·교환 조건, 판매 채널, 계정의 방송 권한, 방송 목적과 길이, 진행자·장비·예산, 이전 방송 자료를 확인합니다. 간단한 오프닝 문구에는 방송 장비나 예산을 필수 입력으로 요구하지 않습니다. 없는 숫자나 혜택을 예시 문구에 채워 실제 약속처럼 제시하지 않습니다.
채널별 신청 자격·송출 방식·노출·수수료·정산·다시보기 조건은
현재 판매자 계정 화면과 공식 안내에서 확인합니다. 계약·프로모션·배송 방식에 따라
비용과 노출이 달라지므로 공통 수수료율이나 연령대별 성과를 고정하지 않습니다.
확인한 자료의 날짜와 계정 범위를 적고, 볼 수 없는 조건은 미확인으로 둡니다.
| 채널 | 확인할 공식 출발점 | 계정에서 확인할 것 |
|---|---|---|
| 네이버 쇼핑라이브 | 스마트스토어 고객센터 | 방송 자격·등록·상품 연결·수수료 |
| 카카오 쇼핑라이브 | 카카오 쇼핑라이브 | 입점·방송 방식·계약·알림 조건 |
| 그립 | 그립 비즈니스센터 | 직접 방송 또는 그리퍼 협업·비용·정산 |
| 쿠팡 | 쿠팡라이브 시작 안내 | 판매자 유형에 맞는 WING·서플라이어허브의 라이브 권한·배송·비용·노출 |
진행 순서
- 채널 비교: 상품과 고객 자료, 실제 계정 권한, 예상 비용과 운영 인력을 같은 기준으로 비교합니다. 공식 문서나 계정에서 확인되지 않은 채널은 신청 가능·노출 우대·수수료를 확정하지 않습니다.
- 방송 설계: 사용자가 지정한 길이와 상품 수를 우선합니다. 시연·질문·혜택 설명에 필요한 시간을 배분하고, 상품별 핵심 사실과 보여줄 장면을 정합니다. 30분·60분 또는 특정 SKU 수를 보편적 정답으로 강제하지 않습니다.
- 스크립트: 오프닝, 상품 시연, 질문 응대, 구매·배송 안내, 마무리를
실제 자료로 작성합니다. 새 시청자 재안내와 종료 알림은 방송 흐름에 맞춰
선택합니다. 가격·할인·수량·시간 제한은 확인된 조건만 말합니다.
상세 표현은
references/live-script.md를 따릅니다. - 송출 전 점검: 현재 채널이 요구하는 장비·화질·상품 연결·알림·이벤트 조건을 확인합니다. 실제 송출 도구와 계정 권한이 보이지 않으면 방송 준비 완료로 표시하지 않습니다. 고객 메시지는 수신 동의와 승인된 발송 범위를 확인합니다.
- 방송 후 측정: 채널이 실제 제공하는 시청·주문·취소·비용 데이터를 같은 기간으로 정리합니다. 기준선이 없으면 시청자 수·전환율·객단가 목표를 만들어 넣지 않습니다. 다시보기·클립 재사용은 채널 기능과 사용 권한을 확인합니다.
출력
방송 기획안에는 확인한 채널 조건과 출처, 상품·혜택 근거, 진행 순서와 대본,
송출 전 누락 항목, 비용·권한·승인, 사후 측정 방법을 적습니다.
요청한 결과에 꼭 필요한 사실이 빠졌으면 질문 채널이 있는 직접 실행에서만 묻고,
하위 실행이나 질문 채널이 없는 직접 실행에서는 해당 사실과 재개 방법을
blocker로 반환합니다. 필수 사실이 아닌 자료는 미확인으로 표시하고
작성할 수 있는 부분을 계속 작성합니다.
상품·광고 표현은 원본 자료와 대조합니다. 경제적 이해관계와 후기·효능 표시는
게시 시점의 규정과 플랫폼 정책을 확인합니다. 유료 광고·고객 메시지 발송·
판매 플랫폼 변경은 사용자의 승인 범위 안에서만 실행합니다.
moai-coworker:ai-slop-reviewer와 moai-writer:korean-humanize가 설치돼 있으면
표현 검수에 추가할 수 있으며, 실행하지 않은 검수는 완료로 표시하지 않습니다.
참고 자료
| 파일 | 읽을 때 |
|---|---|
references/naver-shoppinglive.md | 네이버 방송 조건을 확인할 때 |
references/kakao-shoppinglive.md | 카카오 방송 조건을 확인할 때 |
references/grip.md | 그립 직접 방송·그리퍼 협업을 비교할 때 |
references/coupang-live.md | 쿠팡 판매자 계정의 라이브 조건을 확인할 때 |
references/live-script.md | 진행 대본과 사실 검수 기준이 필요할 때 |
관련 스킬
moai-seller:commerce-detail-page-copy— 상품 카피moai-seller:commerce-integrated-strategy— 채널·손익 비교moai-seller:commerce-ad-claim-compliance-kr— 광고 주장 확인moai-cs:cs-channel-message— 승인된 채널 메시지 초안moai-marketer:content-sns-content— 방송 후 SNS용 짧은 글
일반 상품 등록은 해당 마켓플레이스 스킬로 안내합니다. 자체 스트리밍이나 구매 연결이 없는 인스타·유튜브 방송은 해당 채널의 제작 지침을 확인합니다.
사용자가 라이브 후 짧은 영상을 요청하면, 현재 호스트에 인증된 Higgsfield 공식 연결의 영상 도구와 비용이 확인될 때만 유료 생성 절차로 이어갑니다.
고객 단위 수익 구조
입력 정의
분석 기간, 고객 식별 방식, 주문 상태, 유입 채널, 신규 고객 판정, 광고·제작·대행 비용, 주문 매출과 변동비를 먼저 정한다. 주문별 매출은 할인·취소·환불과 VAT 기준을 일치시킨다. 다른 기간·통화·세금 기준을 섞은 비율은 만들지 않는다.
| 지표 | 계산 기준 |
|---|---|
| CAC | 정의한 획득 비용 ÷ 해당 기간·채널의 신규 고객 수 |
| 주문 공헌이익 | 매출 − 할인·환불 − 원가·수수료·배송 등 변동비 |
| 관측 LTV | 한 코호트의 누적 주문 공헌이익 ÷ 그 코호트의 획득 고객 수 |
| LTV/CAC | 같은 고객군·기간 기준의 LTV ÷ CAC |
| 회수 시점 | 코호트 누적 공헌이익이 획득 비용을 처음 넘는 시점 |
분모가 0이면 비율을 계산하지 않는다. 실제 추적 자료가 없을 때는 관측 LTV를 산출한 척하지 않는다. 할인·반품·수수료 처리가 다르면 결과를 시나리오로 나눠 보여준다.
관측과 추정 분리
고객별 주문 기록이 있으면 획득 월·채널별 코호트를 만들고 같은 경과 기간의 누적 공헌이익과 재구매율을 비교한다. 관측 기간이 짧은 코호트에 뒤쪽 월의 이탈률을 확정값으로 채우지 않는다.
장래 LTV가 필요하다면 재구매 확률·주문액·공헌이익·관측 기간에 대한 가정을 밝힌 별도 예측으로 계산한다. 일정한 재구매율을 무한히 반복하는 기하급수 모델은 그 가정이 자료에 맞고 예측 기간을 정한 경우에만 사용한다. 예측치를 관측 성과라고 부르지 않는다.
판단
LTV/CAC에 업종 공통의 건강·위험 경계값을 적용하지 않는다. 현금 회수 기간, 고정비, 재고 부담, 광고가 없었어도 구매했을 고객, 개인정보 활용 권한을 함께 검토한다. 광고비/매출 비율만으로 '광고 의존' 또는 광고 중단의 효과를 단정하지 않는다.
채널·세그먼트별 재구매율을 비교할 때 고객 수·관측 기간·첫 구매 여부를 표시한다. 고객 목록을 광고 플랫폼에 업로드하는 제안은 수집 목적, 광고 사용 동의, 플랫폼 정책과 실제 권한을 확인한 경우에만 검토한다.
출력
- 관측 지표: 기간·고객 수·매출·변동비·획득비용·누적 공헌이익
- 계산 결과: CAC·관측 LTV·비율·회수 시점과 각 분모
- 추정: 가정, 예측 기간, 민감도, 자료 부족 영역
- 실행안: 검증할 가설과 측정 방법
예상 개선율·월별 광고비 감축률을 근거 없이 약속하지 않는다. 단품 마진 계산은 commerce-margin-calculator, 연락 시점 분석은 commerce-repurchase-timer를 사용한다.
판매 수익성 검수
원본을 수정하지 않고 상품 자료와 산출물의 수치·주장을 대조한다.
- 판매가에서 상품 원가, 채널 수수료, 결제 수수료, 배송·포장, 단위당 광고비를 빼 공헌이익을 다시 계산한다. 할인 중복과 손익분기 수량·ROAS 목표도 입력값으로 재계산한다.
- 상세페이지 문구와 계산표의 가격·할인율·기간이 일치하는지 확인한다. 빠진 비용 항목과 근거 없는 벤치마크를 기록한다.
- 해당 마켓의 현재 글자 수·이미지 규칙·수수료와 금지 주장을 확인한다. 최신 기준을 확인하지 못하면 채널 준수 PASS를 내지 않는다.
- 광고·상품 주장의 근거와 발송·플랫폼 변경 승인 기록을 확인한다. 실제로 수행하지 않은 외부 변경을 완료로 적지 않았는지 본다.
보고서는 판정(PASS/FAIL/미확인), 확인 자료, 비용별 재계산, 심각도·위치·근거가 있는 발견, 미검증 항목으로 작성한다. 원가·수수료 자료가 없으면 마진 정확성을 PASS로 판정하지 않는다. 독립된 검수자를 실행하지 않았다면 독립 감사라고 부르지 않는다.
Claude의 margin-auditor 에이전트와 목적이 겹친다. ChatGPT 플러그인에서는 이 스킬이 발견 가능한 진입점이다.
상품 마진과 손익분기 광고수익률
입력
판매가와 고객 결제액, 판매자 부담 할인·적립금, 과세 유형, 매입원가, 플랫폼·결제 수수료의 실제 금액 또는 계약 요율과 과금 기준, 포장·배송·반품 비용을 확인한다. 채널 이름만으로 수수료율을 채우지 않는다. 수수료는 유입 경로·카테고리·결제수단·판매 방식·프로모션에 따라 달라질 수 있다. 네이버 스마트스토어 정산 안내와 쿠팡 로켓그로스 비용 안내는 실제 판매자 정산 내역 확인에 참고한다.
세금 포함 가격과 세금 제외 원가를 섞지 않는다. 과세·면세·간이과세 여부, 매입세액 공제, 수수료에 붙는 세금 처리는 실제 사업자 자료를 확인한다. 확인되지 않으면 세전·세후 시나리오로 구분하고 확정 순이익처럼 표현하지 않는다.
계산
같은 기준의 한 주문 또는 한 상품에 대해 다음을 분리해 보여준다.
고객 결제액
- 판매자가 부담한 할인·환불
- 실제 정산 수수료
- 상품 매입원가
- 판매자 부담 배송·포장·변동 운영비
= 광고비 전 주문 공헌이익
광고비 전 공헌이익이 0 이하이면 해당 주문만으로 광고비를 회수할 수 없다. 양수이면 같은 매출·귀속 기준에서 주문당 허용 광고비의 단순 상한으로 사용할 수 있다. 손익분기 ROAS는 해당 매출 기준액을 허용 광고비로 나눈 값이다. 실제 캠페인 ROAS와 비교할 때 광고 플랫폼의 귀속 매출, VAT 포함 여부, 취소·반품 반영 기간을 맞춘다. 자세한 계산 경계는 references/end-roas.md를 따른다.
결과
입력값, 수수료 과금 기준, 세금 처리, 각 비용 항목, 계산식, 누락된 항목과 민감도 시나리오를 함께 제시한다. 광고 목표 ROAS를 임의의 배수로 정하거나 플랫폼 쿠폰을 판매자 부담 0원이라고 가정하지 않는다. 주문 공헌이익은 임대료·인건비 등 고정비나 장기 고객 가치를 모두 반영한 순이익이 아니다.
관련 스킬
- commerce-marketplace-coupang-ads: 쿠팡 광고 계정 운영 판단
- commerce-ltv-cac-architect: 고객 코호트 수익성
커머스 시장조사
입력
상품 범위, 판매 채널, 가격대, 조사 기간, 판매 지역을 확인한다. 연결된 공식 데이터 도구가 제공하는 지표와 권한을 먼저 확인하고, 없으면 사용자가 제공한 내보내기 파일이나 공개 자료를 쓴다. 검색 추세 지수와 실제 검색량, 상품 노출 수와 매출을 혼동하지 않는다.
네이버 Search Trend·Shopping Insight API는 제공 창구가 바뀔 수 있다. 네이버 개발자 공지에 따라 사용 시점의 NAVER API HUB와 각 서비스 문서를 확인한다. 기존 개발자센터 키나 종료된 쇼핑 검색 API가 계속 통한다고 가정하지 않는다.
조사
| 축 | 확인할 자료 | 해석할 때 주의할 점 |
|---|---|---|
| 시장 | 공공 통계, 업계 보고서, 판매자 실측 | 범위·기간·단위·표본 |
| 경쟁 | 실제 판매 페이지의 가격·구성·후기 | 노출 순위가 매출 순위는 아님 |
| 검색 | 도구의 추세 지수·키워드 자료 | 상대 지수와 절대 검색량을 분리 |
자료마다 URL 또는 파일, 조회일, 적용 지역, 기간을 기록한다. 지표를 비교할 때 기준을 맞춘다. 자료가 없는 축은 미확인으로 남기고 추가 조사 방법을 적는다. 경쟁사의 ROAS·CTR·매출은 공개되지 않았다면 추정 수치로 채우지 않는다.
판단
고객이 실제로 겪는 문제, 경쟁 상품과의 차이, 가격·수수료·배송비를 감안한 공헌이익을 함께 본다. 포지셔닝은 품질, 가격, 전문성, 편의, 가치관 중 고객 근거가 있는 축으로 제안한다. 새 카테고리 명칭을 만들었다는 이유만으로 독점 지위나 높은 마진을 기대하지 않는다.
출력
- 조사 범위와 자료 목록
- 확인된 수치와 단위, 기간
- 경쟁 상품 비교
- 검색 추세와 그 한계
- 진입 가설, 반대 근거, 검증할 항목
수치를 얻지 못하면 빈칸을 유지한다. 결론은 확인된 자료의 범위를 넘지 않게 적고, 후속 고객 조사에는 commerce-jtbd-persona를 사용할 수 있다.
쿠팡 광고 보고서 분석과 조정안
자료와 권한
분석 기간, 광고 계정, 캠페인·상품·검색어 보고서, 광고비와 전환매출 정의, 주문 취소·반품 반영 기간, 상품별 실제 공헌이익을 확인합니다. 보고서가 없으면 수치에 근거한 증액·중단·제외 결론을 만들지 않고 필요한 열과 조회 경로를 안내합니다. 광고 계정 변경은 현재 도구 권한과 사용자의 승인 범위를 확인합니다.
쿠팡 광고 공식 안내는 AI스마트광고, 매출최적화광고, 매출스타트광고, 수동성과형광고 등 광고 상품을 설명합니다. 현재 계정에 보이는 캠페인 유형·예산·자동규칙·제외 기능을 확인하고 적용합니다. 모든 계정에 같은 세 유형이나 한 상품당 한 캠페인이 맞다고 가정하지 않습니다.
분석 순서
- 지표 정합: 같은 기간·상품·귀속 기준의 광고비, 클릭, 주문, 광고 전환매출을 대조합니다. 검색·비검색 지면별 자료가 실제 보고서에 있으면 나누어 봅니다. 자료가 없으면 지면별 성과를 추정하지 않습니다.
- 손익 비교:
commerce-margin-calculator의 공헌이익과 손익분기 ROAS 계산 기준을 사용합니다. 광고 화면의 매출과 판매자 결제·정산액의 VAT·쿠폰·취소·귀속 기준을 맞춥니다. 화면 ROAS에 일률적인 10% 보정을 적용하지 않습니다. 분모가 0이면 비율을 만들지 않습니다. - 변경안: 예산, 목표 ROAS, 키워드 제외, 상품·캠페인 분리는 실제 계정 기능과 측정된 상품별 성과에 따라 후보로 제시합니다. 고정 증액률·중단 임계값·키워드 개수·일예산을 보편 규칙으로 쓰지 않습니다.
- 안전 확인: 자동규칙은 발동 조건·최대 지출·중복 실행·되돌리기를 확인합니다. 쿠폰 부담, 오디언스 설정과 과금 범위도 현재 계약에서 확인합니다. 제안과 실제 계정 변경을 분리해 기록합니다.
- 사후 측정: 변경 전후 같은 귀속 기간의 광고비·전환매출·주문 공헌이익, 취소·반품을 비교합니다. 광고가 없었어도 발생했을 주문과 외부 변동을 고려해 단순 전후 차이를 증분 효과로 확정하지 않습니다.
결과
확인한 보고서의 계정·기간·조회일, 지표 정의와 원본, 상품별 손익,
수정 후보와 근거, 미확인 항목, 승인·실행 여부를 적습니다.
광고 계정을 실제로 바꾸지 않았다면 조정안으로 표시합니다.
연결되지 않은 광고 도구의 설정 변경을 완료로 표시하지 않습니다.
광고 소재 문구 검토는 commerce-ad-claim-compliance-kr, 상품별 마진은
commerce-margin-calculator, 다채널 성과 비교는
moai-marketer:marketing-performance-report로 연결합니다.
쿠팡 상품 등록 검토
먼저 확인할 것
판매자 유형과 계정 권한, 상품 카테고리, 브랜드·모델·인증·옵션, 실제 가격·재고·배송·반품 조건, 이미지와 상세설명 원본을 확인합니다. 로켓배송·로켓그로스·판매자배송을 이름만 보고 같은 운영 조건으로 취급하지 않습니다.
쿠팡 공식 상품 등록 안내는 상품명, 카테고리, 옵션, 이미지, 상세설명, 고지, 배송·반품 정보를 등록하고 미리보는 순서를 안내합니다. 현재 계정 화면과 계약 조건을 우선해 적용합니다. 계정에 보이지 않는 기능이나 수수료를 공개 안내만으로 확정하지 않습니다.
진행 순서
- 상품 사실 대조: 원본 자료로 상품명·사양·인증·가격·할인·옵션·재고를 확인합니다. 검색 결과나 경쟁사의 문구를 사실 근거로 복사하지 않습니다.
- 등록 조건 확인: 현재 계정에서 카테고리 권한, 대표·추가 이미지와 상세설명의 크기·용량·형식, 상품명·검색어 입력 제한을 확인합니다. 같은 쿠팡 공식 안내 사이에도 이미지 권장값이 다를 수 있으므로 계정 화면에서 선택한 등록 경로의 값을 사용합니다.
- 이미지 검토:
commerce-detail-page-image의 1080×12720 합성본은 작업용 원본입니다. 그대로 업로드되거나 자동 압축된다고 약속하지 않습니다. 규격이 다르면 별도 변환을 안내하고 결과 파일·미리보기를 확인합니다. - 배송·비용 검토: 배송 유형별 실제 계약, 정산 수수료, 물류비, 출고 가능일과 반품 비용을 구분합니다. 모든 상품의 익일 도착이나 고정 수수료·검색 우대를 단정하지 않습니다.
- 등록 전 점검: 금지 표현·법정 고지·이미지 권리·상품 정보와 미리보기 화면을 확인합니다. 등록·노출 결과를 보지 않았다면 완료로 표시하지 않습니다.
세부 항목은 references/coupang-guidelines.md를 따릅니다. 문구의 법규 검토는
commerce-ad-claim-compliance-kr, 이미지 제작은 commerce-detail-page-image,
다른 오픈마켓은 commerce-marketplace-naver로 연결합니다.
결과
상품과 등록 화면의 대조 결과, 현재 계정에서 확인한 조건·출처·조회일,
누락 자료와 실제 미리보기·업로드 여부를 적습니다. 확인하지 않은 조건은
미확인으로 두고, 실행하지 않은 등록이나 법규 검토를 PASS로 표시하지 않습니다.
크라우드펀딩 프로젝트 기획
목적
와디즈·텀블벅 프로젝트의 초안을 작성하고, 공개 전에 확인해야 할 계정별 조건을 정리합니다. 펀딩·프리오더·스토어는 서로 다른 방식입니다. 와디즈의 서비스 구분 안내와 텀블벅의 현재 프로젝트 에디터를 확인합니다.
트리거
크라우드펀딩, 와디즈, wadiz, 텀블벅, tumblbug, 펀딩 프로젝트, 리워드 펀딩, 선주문, 사전판매, 메이커, 펀딩 후기, 해피빈 펀딩, 크라우드 펀딩 카피
작업 순서
- 프로젝트 확인 — 상품·창작물의 실제 제작 단계, 제공할 결과물, 대상 국가, 메이커 유형, 확보한 인증·사진·영상, 예상 제작비·배송비·일정을 받습니다. 없는 값은
미확인으로 남깁니다. - 채널 후보 제시 — 사용자가 원하는 거래 방식과 현재 채널의 프로젝트 유형을 대조합니다. 품목만으로 와디즈·텀블벅을 자동 확정하지 않습니다. 투자형 요청은 리워드 펀딩과 구분해 해당 서비스의 현행 자격·규제를 별도로 확인합니다.
- 현재 조건 확인 — 선택한 계정의 프로젝트 에디터·계약과 공식 도움말에서 메이커 자격, 프로젝트 유형, 심사·인증 자료, 이미지·영상 조건, 수수료·세금, 결제·정산·취소·환불, 공개 일정을 확인합니다. 계정에 접근할 수 없으면 필요한 확인 목록을 반환하고 초안임을 표시합니다.
- 스토리와 리워드 설계 — 실제 제작 근거로 목적, 결과물, 제작 단계, 리워드, 목표 금액의 산출 근거, 배송 약속과 위험 대응을 작성합니다. 할인율·한정 수량·성과 전망을 임의로 만들지 않습니다.
- 비용 점검 — 리워드별 제작·포장·배송·세금·현재 계약의 플랫폼 비용을 같은 기준으로 합산합니다. 비용이나 수수료가 없으면 손익·정산액을 확정하지 않습니다.
- 검토와 공개 — 상품 표시와 인증, 가격·수량·일정, 이미지·영상 권리, 변경·환불 조건을 사용자 원자료와 대조합니다. 공개 또는 계정 변경은 사용자 승인 후 진행합니다.
- 운영 — 실제 승인된 일정과 채널 정책에 맞춰 새소식·질문·배송 지연을 관리합니다. 공개·결제·정산이 성공했다고 기록하려면 해당 계정의 결과를 확인합니다.
채널별 확인 지점
| 채널 | 먼저 확인할 것 | 공식 자료 |
|---|---|---|
| 와디즈 | 펀딩·프리오더·스토어 중 요청 방식, 한국/해외 메이커 자격, 기본 요금제와 메이커 지역·제출일·선택형 서비스·계약별 비용 | 메이커 자격, 요금제 |
| 텀블벅 | 개인/사업자 정보, 품목별 심사 자료, 선택 요금제, 결제·정산 조건 | 프로젝트 올리기, 수수료 정책 |
와디즈 공식 자격 안내는 한국 메이커의 펀딩에 개인·개인사업자·법인사업자를 구분해 허용합니다. 텀블벅도 개인과 사업자의 제출 자료를 다르게 안내합니다. 둘 중 한 채널의 서류를 모든 프로젝트에 적용하지 않습니다.
작성 결과
다음 구조로 사실과 미확인 항목을 구분합니다. 가격·예정 날짜는 사용자 자료와 현재 계정 조건으로 확인합니다. 과거 모금액·판매 실적·심사 승인·정산 결과는 계정 기록을 확인하기 전까지 미검증으로 표시합니다.
{
"channel_candidate": "wadiz 또는 tumblbug",
"project_type": "계정에서 확인한 유형 또는 미확인",
"eligibility": {"checked": false, "missing": []},
"story_draft": ["만드는 이유", "결과물과 제작 단계", "리워드", "일정과 위험 대응"],
"rewards": [],
"costs": {"source": "현재 계약 또는 미확인", "estimate": null},
"submission_requirements": [],
"open_questions": [],
"publication_status": "초안"
}
간단한 카피 요청에는 사용자가 제공한 사실만으로 문안을 작성하고, 등록·가격·정산 실행에 필요한 자료가 없으면 해당 단계만 보류합니다.
연결 자료
references/wadiz.md— 와디즈의 현재 계정·프로젝트 유형 확인 항목references/tumblbug.md— 텀블벅의 현재 계정·품목별 확인 항목moai-seller:commerce-detail-page-copy— 프로젝트 스토리 초안moai-seller:commerce-product-photo-brief— 확보한 사진과 추가 촬영 검토moai-coworker:ai-slop-reviewer·moai-writer:korean-humanize— 설치된 경우 선택적으로 표현 검수. 미실행 시 완료로 표시하지 않습니다.
주의
- 인증·표시·세금·환불과 후원자 약속은 실제 상품, 계정 계약, 현행 정책과 대조합니다. 확인되지 않은 자격이나 오픈 승인을 단정하지 않습니다.
- 후기·판매 실적·할인율·한정 수량·영상 효과를 만들어 내지 않습니다.
- 투자형 상품의 법적 자격이나 수익을 이 리워드 펀딩 초안으로 판단하지 않습니다.
큐레이션 채널 입점 제안
목적
사용자가 제공한 브랜드와 상품 자료로 카카오 메이커스·무신사·29CM의 입점 제안 초안을 작성합니다. 채널이 입점·노출·매출을 보장한다고 말하지 않습니다. 신청 경로와 계약 조건은 현재 공식 파트너 화면에서 확인합니다.
트리거
큐레이션 커머스, 카카오 메이커스, 메이커스, 무신사, 무신사스토어, 29CM, 라이프스타일 셀렉션, 주문생산, 한정 발매, 셀렉션, 입점 제안, 큐레이션 입점, MD 제안
작업 순서
- 자료 받기 — 브랜드 정체성, 실제 판매 상품과 인증, 사진 사용 권리, 생산·배송 방식, 가격·원가, 현재 유통 이력과 신청 국가를 확인합니다. 매출·후기·팔로워 수는 원자료가 없으면
미확인으로 둡니다. - 채널 후보 고르기 — 현재 취급 품목과 사용자가 원하는 주문·배송 방식, 공개된 입점 안내를 대조합니다. 특정 연령대·카테고리만으로 승인 가능성을 점수화하지 않습니다.
- 공식 신청 경로 확인 — 무신사는 공식 파트너 입점 페이지, 29CM는 공식 파트너 안내의 입점 신청 링크에서 시작합니다. 29CM 링크는 문의 화면으로 연결되므로 실제 제출 가능 여부와 심사 조건은 화면·담당자에게 확인합니다. 카카오 메이커스의 현재 접수 경로는 공식 사이트에서 확인하고, 찾지 못하면 담당자에게 묻습니다.
- 제안 자료 작성 — 실제 브랜드 소개, 상품 카탈로그, 사진·표시 자료, 공급 가능 수량과 배송 계획을 정리합니다. 채널이 요구하지 않은 PDF 분량·상품 개수·팔로워 기준을 필수라고 쓰지 않습니다.
- 조건 검토 — 현재 제안서와 계약에서 수수료, 재고 소유·보관, 반품·정산, 광고·콘텐츠 협업, 독점·재신청 제한을 확인합니다. 확인 전에는 비용·노출·심사 기간을 확정하지 않습니다.
- 제출과 운영 — 입점 신청·계약·광고 구매는 사용자 승인 후 실행합니다. 제출·승인·노출·매출은 실제 계정 결과를 확인한 뒤 기록합니다.
간단한 입점 소개 문구 요청에는 확보한 브랜드 사실로 초안을 작성합니다. 계정 접근이나 계약 자료가 없어도 초안은 제공하고, 제출·비용 계산 단계의 누락 자료만 표시합니다.
채널별 시작점
| 채널 | 공개적으로 확인할 수 있는 출발점 | 별도로 확인할 것 |
|---|---|---|
| 카카오 메이커스 | 카카오 공식 서비스 소개는 공동주문·주문제작을 설명합니다. | 현재 파트너 접수 경로, 취급 품목, 주문 방식, 배송·정산 계약 |
| 무신사 | 공식 입점 문의와 신청서 | 상품 적합성, 제출 서류, 공급·재고·수수료 조건 |
| 29CM | 공식 파트너 안내의 입점 신청 링크에서 문의 화면으로 이동합니다. | 실제 제출 가능 여부, 심사 조건, 상품 자료, 재고·수수료·콘텐츠 조건 |
작성 결과
{
"channel_candidates": [],
"fit_reasons": [],
"verified_brand_facts": [],
"proposal_draft": {"brand_story": "", "products": [], "supply_plan": "미확인"},
"application_route": "현재 공식 파트너 화면 확인 필요",
"contract_terms": {"commission": null, "inventory": "미확인", "settlement": "미확인"},
"missing_evidence": [],
"submission_status": "초안"
}
연결 자료
references/kakao-makers.md— 주문 방식과 파트너 조건 확인references/musinsa.md— 공식 입점 화면과 브랜드 자료 확인references/29cm.md— 현재 채널 표현과 파트너 접수 경로 확인moai-seller:commerce-product-photo-brief— 확보한 사진과 촬영 계획moai-seller:commerce-integrated-strategy— 채널 운영 계획moai-coworker:ai-slop-reviewer·moai-writer:korean-humanize— 설치된 경우 선택적으로 표현 검수. 미실행 시 완료로 표시하지 않습니다.
주의
- 확인되지 않은 입점 수수료, 심사 기간, 통과율, 재신청 제한, 광고 효과를 사실처럼 쓰지 않습니다.
- 브랜드 인지도나 SNS 팔로워가 적다는 이유만으로 신청 불가라고 단정하지 않습니다.
- 한국어 문안은 원본 상품 정보·가격·혜택과 대조하고, 사용 권리가 없는 후기·이미지·성과를 넣지 않습니다.
자사몰 (D2C) 운영 가이드
자사몰은 상품 구성·브랜드 표현·고객 경험을 직접 설계할 수 있습니다. 빌더 요금 외에도 결제, 배송, 도메인, 앱, 광고, 운영 인력의 비용이 발생할 수 있으므로 수수료 없음 또는 통제권 100%라고 안내하지 않습니다.
요청과 자료
자사몰, D2C, 카페24, 아임웹, 메이크샵, 독립몰, 브랜드 쇼핑몰 요청에 사용합니다. 판매 품목·국가, 상품 수, 디자인·개발 인력, 기존 주문량, 결제·배송 방식, 예산, 현재 사업·신고 상태를 확인합니다. 자료가 없는 항목은 미확인으로 둡니다. 간단한 비교나 준비 목록은 계정 없이도 작성합니다.
작업 순서
- 필요 기능 정리 — 상품·재고·옵션, 국내·해외 결제, 배송, 콘텐츠 편집, 외부 앱, 데이터 내보내기를 구분합니다.
- 빌더 비교 — 카페24 공식 소개, 아임웹 요금제 안내, 메이크샵의 현재 공식 안내를 확인합니다. 브랜드 규모나 미확인 시장 점유율만으로 결론 내리지 않습니다.
- 비용 계산 — 선택한 빌더 플랜과 PG 계약, 간편결제, 도메인, 디자인, 배송, 유료 앱, 광고의 실제 견적을 같은 주문량 기준으로 비교합니다. 견적이 없고 사용자가 추정을 원하면 가정·산식·미확인 항목을 분리한 예시 계산을 제공합니다. 예시를 실제 계약 비용으로 확정하지 않습니다.
- 개설 준비 — 도메인·HTTPS, 상품·이미지, 결제 신청, 배송·반품 정책, 개인정보·마케팅 동의, 검색 도구를 실제 계정의 기능에 맞춰 점검합니다. 한 장의 긴 상세 이미지가 모든 빌더에서 그대로 허용된다고 약속하지 않습니다.
- 신고와 계약 확인 — 사업자·PG 제출 서류와 통신판매업 신고 또는 면제 여부를 현재 기관·서비스 안내에서 확인합니다. 전자상거래법 제12조는 일정 기준 이하의 신고 면제를 둡니다. 모든 판매자에게 신고가 필수라고 단정하지 않습니다.
- 운영 계획 — 실제 마진·고객 획득비·재구매 자료로 채널과 목표를 정합니다. 공통 ROAS·전환율·마켓 대 자사몰 비율을 보편 목표로 제시하지 않습니다.
현재 공개 안내에서 확인할 점
| 빌더 | 확인된 시작점 | 계정·계약에서 다시 볼 것 |
|---|---|---|
| 카페24 | 공식 신규 창업자 안내는 쇼핑몰 솔루션의 월 이용료가 없고 결제·배송·앱 등에 추가 요금이 생길 수 있다고 설명합니다. | 선택한 PG·앱·디자인·도메인 비용, 정산 조건 |
| 아임웹 | 공식 요금제 안내는 Starter·Pro·Global과 14일 체험을 안내합니다. Free는 폐지됐습니다. | 상품 수, 간편결제·해외결제, 추가 서비스와 계약 요금 |
| 메이크샵 | 현재 공식 상품·요금 안내를 확인한 뒤 비교합니다. | 선택한 상품의 기능·월 요금·결제·이전 조건 |
출력
{
"needs": {"products": "미확인", "payment": [], "shipping": []},
"candidates": [],
"verified_terms": [],
"cost_inputs_missing": [],
"registration_and_pg_checks": [],
"setup_checklist": [],
"recommendation": "조건부 비교"
}
사용자가 "아임웹과 카페24 중 뭘 쓸까?"라고 물으면 알려진 기능과 확인할 비용을 먼저 나란히 보여줍니다. 사업자등록 자료가 없어도 사이트 설계 초안은 작성할 수 있습니다. 실제 결제 개통의 요건은 선택한 PG와 판매 형태에서 확인합니다.
관련 자료
references/cafe24.md— 카페24 개설·비용 확인references/imweb.md— 아임웹 플랜·결제 확인references/d2c-strategy.md— 자사몰과 마켓 채널 운영 판단moai-seller:commerce-detail-page-copy— 상품 설명 초안
마켓플레이스 입점 자체는 해당 채널 스킬을 사용합니다. 계정 생성·결제 계약·사이트 공개·광고 집행은 사용자 승인 후 실행합니다.
네이버 광고 보고서 분석과 조정안
자료와 광고 유형
광고 계정, 캠페인 유형, 기간, 검색어·소재 보고서, 광고비, 전환매출의 추적 설정과 귀속 기간, 상품별 공헌이익을 확인합니다. 보고서가 없으면 숫자를 채운 최적화안을 만들지 않고 필요한 자료와 조회 방법을 안내합니다.
네이버 광고 공식 도움말은 검색광고와 성과형 디스플레이 광고의 계정·상품별 운영 정보를 제공합니다. 쇼핑검색광고·파워링크·브랜드검색·성과형 디스플레이 등은 요청과 현재 계정에 보이는 상품에 따라 구분합니다. 모든 판매자에게 네 유형이 필요하거나 쇼핑검색광고가 항상 첫 선택이라고 단정하지 않습니다.
분석 순서
- 측정 기준: 캠페인·상품·소재·검색어별 노출, 클릭, 비용과 전환매출을 같은 기간으로 정리합니다. 추적되지 않은 전환을 0매출로 단정하지 않습니다. 클릭률·전환율의 분모와 귀속 창을 표시합니다.
- 상품 수익성:
commerce-margin-calculator의 공헌이익과 손익분기 ROAS 기준을 사용합니다. 할인·쿠폰·환불·수수료·VAT와 광고 보고서의 매출 기준을 맞춘 뒤 비교합니다. 업종 공통 목표 ROAS를 적용하지 않습니다. - 검색어·소재 검토: 실제 검색어 보고서가 제공하는 범위에서 상품명·카테고리·키워드·랜딩의 관련성을 확인합니다. 제외 키워드, 입찰 조정, 소재 교체는 계정 기능과 충분한 관측치를 확인한 뒤 후보로 제시합니다. 사진 후기의 고정 개수나 품질지수 상승을 성과 보장으로 사용하지 않습니다.
- 캠페인별 판단: 브랜드검색과 디스플레이 광고는 현재 상품 자격, 과금 방식, 대상 고객과 비용을 확인해 별도로 평가합니다. 검색광고의 지표를 디스플레이 광고의 성과처럼 합치지 않습니다.
- 변경·측정: 예산·입찰·제외 설정뿐 아니라 소재 교체·캠페인 구성 등 모든 광고 계정 변경 전에 사용자 승인과 현재 도구 권한을 확인합니다. 실행했다면 이전값과 변경값을 기록하고, 같은 기간·귀속 기준에서 이후 결과를 비교합니다.
결과
확인한 자료의 계정·기간·조회일, 지표 정의와 누락, 상품별 손익,
검색어·소재·예산 조정 후보, 승인·실행 여부를 구분해 적습니다.
실제 계정 설정을 바꾸지 않았다면 완료가 아닌 조정안으로 표시합니다.
광고 문구는 commerce-ad-claim-compliance-kr, 상품 등록은
commerce-marketplace-naver, 다채널 성과는
moai-marketer:marketing-performance-report로 연결합니다.
네이버 스마트스토어와 오픈마켓 등록 검토
시작 자료
판매 채널과 계정 유형, 상품의 실제 사양·카테고리·가격·옵션·재고·배송·반품 조건,
대표 이미지와 상세 이미지, 등록하려는 문구를 확인합니다. 자료가 없으면
해당 항목을 미확인으로 두고 확인 경로를 제시합니다.
채널의 이미지 크기·용량·형식, 상품명·검색어·태그의 입력 제한, 금지 표현과 노출 조건은 현재 판매자 계정 화면과 공식 안내에서 확인합니다. 시점·카테고리·상품 유형에 따라 다를 수 있는 숫자를 공통 규칙으로 쓰지 않습니다.
| 채널 | 공식 출발점 | 확인할 계정 화면 |
|---|---|---|
| 네이버 스마트스토어 | 스마트스토어 고객센터 | 상품 등록·카테고리·이미지·검색설정 |
| 11번가 | 셀러오피스 | 상품 등록·이미지·검색어·정산 |
| G마켓·옥션 | ESM PLUS | 각 마켓의 상품 등록·이미지·정산 |
진행 순서
- 상품 사실 대조: 브랜드·모델·인증·옵션·가격·배송 약속을 원본 자료와 대조합니다. 경쟁 판매자의 문구와 카테고리를 그대로 복사하지 않습니다.
- 채널별 등록 조건: 현재 계정에서 카테고리 권한, 이미지 입력값, 상세설명 방식, 상품명·검색어 제한을 확인합니다. 확인되지 않은 검색 우대나 고정 순위 기준을 제시하지 않습니다.
- 이미지 검토:
commerce-detail-page-image의 1080×12720 합성본은 작업용 원본입니다. 그대로 업로드 가능하다고 가정하지 않고 현재 채널 규격과 실제 업로드 결과를 확인합니다. 규격이 다르면 별도 변환을 안내합니다. - 고객 안내: 톡톡·후기·쿠폰·메시지는 현재 계정 기능, 동의와 플랫폼 정책을 확인합니다. 후기 작성 대가나 평점을 조건으로 한 보상은 승인된 정책 범위에서만 제안하며 허위 후기를 만들지 않습니다.
- 등록 전 확인: 미리보기, 옵션·가격·재고, 고지 항목, 이미지와 금지 표현을 확인합니다. 실제 저장·노출을 확인하지 않았다면 등록 완료로 표시하지 않습니다.
채널별 세부 점검 항목은 references/naver-smartstore.md와
references/openmarket-common.md를 따릅니다. 광고 문구의 법규 검토는
commerce-ad-claim-compliance-kr, 이미지 제작은 commerce-detail-page-image로
이어갑니다. 쿠팡 등록은 commerce-marketplace-coupang을 사용합니다.
결과
채널별로 확인한 조건·출처·조회일, 상품과 이미지의 검토 결과,
수정할 문구, 누락 자료, 업로드·미리보기의 실행 여부를 적습니다.
실행하지 않은 채널 정책 확인이나 표현 검수를 PASS로 표시하지 않습니다.
한국 광고성 메시지 발송 전 점검
이 스킬은 메시지 초안과 발송 기록을 확인해 검토 결과를 작성합니다. 법적 적합성이나 실제 발송 허가를 자동 보증하지 않습니다. 수신자별 동의·거부 기록, 채널 심사, 발송 설정을 확인하지 못하면 PASS를 내지 않습니다.
요청 자료
- 메시지 원문, 제목·이미지·버튼·연결 화면
- 문자·이메일·앱 알림·카카오 메시지 등 실제 전송 매체
- 발송 주체, 수신 대상, 발송 일시와 수신자의 지역
- 수신자별 광고 동의·철회·거부 기록과 수집 문구
- 야간 별도 동의 기록, 거래관계 예외를 주장하는 경우 거래·연락처 수집 증거
- 전송자 명칭·연락처, 광고 표시, 수신거부 경로와 비용
- 카카오 등 채널의 현재 템플릿·심사·발송 설정
간단한 문구 검토 요청에는 자료가 있는 범위에서 문제 후보와 확인할 자료를 반환합니다. 계정 기록이 없다는 이유로 문구 검토 자체를 거절하지 않습니다.
판정 순서
- 광고성 여부 — 정보통신망법 제50조와 KISA 안내서를 기준으로 메시지 전체와 연결 화면의 영리 목적을 확인합니다. 주문·배송 등 필수 안내에 혜택·재구매 유도가 섞이면 광고성 여부를 다시 검토합니다. 쿠폰·마일리지·적립금을 일방적으로 제공한 뒤 발급·소멸을 알리는 경우, 단순 거래 고지라고 단정하지 않습니다.
- 동의·거부 — 광고라면 수신자별 명시적 사전 동의 또는 제50조 제1항의 구체적 예외 증거를 확인합니다. 동의가 있어도 수신거부·철회 후에는 광고를 보내지 않습니다. 거래관계 예외는 같은 종류의 재화, 직접 수집한 연락처, 시행령 제61조의 기간 조건을 확인합니다.
- 야간 — 오후 9시부터 다음 날 오전 8시까지 광고를 보내려면 별도 사전 동의를 확인합니다. 시행령 제61조 제2항의 전자우편 예외는 야간 별도 동의에 관한 것으로, 일반 광고 동의·거부 규칙까지 면제하지 않습니다. 발송 예약 시간과 수신자 시간대를 확인합니다.
- 표시와 수신거부 — 매체별 시행령 별표 6 원문에 맞는 광고 표시, 전송자 정보, 쉬운 수신거부·동의 철회 방법을 확인합니다. 이메일은 제목 시작 부분의
(광고)와 본문의 전송자 명칭·이메일 주소·전화번호·주소 및 한글·영문 거부 안내·간편한 철회 방법을 각각 확인합니다. 문자 등 비음성 전송매체는 광고 시작 부분과 끝 부분의 표시 사항을 각각 확인합니다. 수신자가 전화요금 등 금전적 비용을 부담하지 않도록 해야 합니다. 앱 알림 수신거부에 로그인 등 복잡한 절차를 강요하지 않습니다. - 채널 정책 — 카카오 알림톡 심사 가이드는 메시지 일부라도 광고성 내용이 포함되면 알림톡 발송을 허용하지 않습니다. 광고가 섞인 알림톡은
BLOCK으로 둡니다. 카카오의 사전 협의 가능성은 광고가 없는 정보성 메시지에 한정해 현재 가이드·승인 화면에서 확인합니다. 친구톡·문자·이메일의 길이·버튼 규격도 각 발송 서비스의 현재 안내를 확인합니다. - 결과 — 확보한 자료로 확인된 항목과 미확인 항목을 분리합니다. 실제 발송 전에는 발송 서비스의 설정·테스트 수신·수신자 목록을 다시 확인합니다.
결과 상태
| 상태 | 뜻 |
|---|---|
BLOCK | 확인된 법령·채널 조건과 충돌하거나 수신거부 기록이 확인됨 |
REVIEW | 문구는 검토했지만 동의·예외·템플릿·설정 자료가 없어 발송 판단 불가 |
READY_FOR_SEND_CHECK | 제출된 기록에서 점검 항목을 충족함. 실제 발송 설정과 수신 목록은 별도 확인 필요 |
READY_FOR_SEND_CHECK를 법적 면책이나 전송 성공의 뜻으로 쓰지 않습니다. 과태료와 형사처벌을 메시지 한 건의 고정 손실로 환산하지 않습니다. 제재 여부·금액은 위반 유형과 적용 조항, 절차에 따라 판단됩니다.
출력 예시
{
"status": "REVIEW",
"message_category": "광고성 가능",
"channel": "SMS",
"verified": ["할인 문구가 포함됨"],
"missing_evidence": ["수신자별 광고 동의", "발송 시각", "무료 수신거부 경로"],
"required_edits": ["매체별 광고 표시 위치와 전송자 정보를 확인"],
"send_decision": "미확정"
}
주문 확인 메시지의 정보성 초안은 동의 기록 없이도 검토할 수 있습니다. 광고 문구로 바뀌면 다시 판정합니다. 광고 표현 자체의 적법성은 commerce-ad-claim-compliance-kr, 메시지 카피 작성은 cs-channel-message를 사용합니다.
공식 자료
매장 운영 브리핑
범위
주문 요약인지 운영 전체 브리핑인지, 대상 매장·채널·조회 날짜·시간대·상태 기준을 정한다. '오늘'과 '어제'는 매장 시간대로 계산한다. 연결되지 않은 매장 또는 광고 계정을 읽은 것으로 표시하지 않는다.
자료 수집
- 현재 호스트에서 실제 연결된 스마트스토어·카페24·아임웹 등 커머스 도구의 조회 기능을 확인한다. 없으면 사용자가 제공한 내보내기 파일·스크린샷·텍스트를 사용한다.
- 주문 건수는 주문 ID, 채널, 상태, 결제 시각 기준을 명시한다. 같은 주문의 복수 상품행·채널 동기화 중복·취소·환불을 확인하고 합계를 계산한다.
- 문의는 미답변 상태와 조회 시각을 확인한다. 광고 ROAS는 광고비·귀속 매출·기간·귀속 방식을 같은 기준으로 확인한다.
- 검색 트렌드는 별도 출처가 있을 때만 넣는다. 주문 데이터에서 트렌드가 확인된 것처럼 쓰지 않는다.
출력 예시
| 항목 | 값 | 범위·기준 |
|---|---|---|
| 신규 주문 | 확인된 건수 | 채널·상태·기간 |
| 순매출 | 확인된 금액 | 취소·환불 반영 기준 |
| 미답변 문의 | 확인된 건수 | 조회 시각 |
| 광고 성과 | 확인된 수치 | 계정·기간·귀속 기준 |
빠진 채널은 0으로 합산하지 않고 미조회로 표시한다. 실제로 확인한 채널만 합계에 포함하고, 제외된 채널을 함께 적는다. 소스별 조회 시각이 다르면 그 차이를 표시한다.
검수와 저장
합계·전일 대비의 분모를 다시 계산하고 원본 자료와 대조한다. 결과 파일 저장은 사용자의 작업 폴더와 현재 호스트의 쓰기 기능을 확인한 경우에만 수행한다. 저장하지 않았으면 파일을 만들었다고 쓰지 않는다. 조회 불가·자료 부족·미검증 수치는 그대로 보고한다.
관련 스킬
- moai-officer:productivity-briefing: 외부 뉴스·시장 정보
- commerce-integrated-strategy: 운영 데이터에 따른 전략
상품 상세 콘텐츠와 페이지 코드
입력과 산출물 결정
상품의 실제 사양·가격·옵션·인증·배송·반품 자료, 사진 사용권,
판매 채널과 대상 고객의 근거 자료를 확인합니다. 후기·실적·효능·할인·재고·
행사 마감은 출처가 있을 때만 사용합니다. 빠진 정보는 자리표시자나
미확인으로 두고 실제 판매 주장처럼 출력하지 않습니다.
| 게시 환경 | 산출물 | 확인할 것 |
|---|---|---|
| 스마트스토어·쿠팡·카카오 등 마켓 | 카피, 이미지·섹션 구성, 에디터에 맞춘 등록 자료 | 현재 계정의 에디터·이미지·고지 조건 |
| 자사몰·SaaS·독립 웹사이트 | 요청한 기술 스택의 HTML 또는 React 코드 | 기존 프로젝트·디자인 시스템·배포 환경 |
마켓용 HTML·CSS·JavaScript의 허용 여부는 현재 에디터에서 확인합니다. 허용되지 않거나 확인할 수 없으면 마켓에 업로드할 코드라고 표시하지 않고, 카피·이미지와 편집 지침을 제공합니다. React 앱 코드는 자사몰 등 실제로 실행할 수 있는 웹 환경이 확인된 경우에만 생성합니다.
작업 순서
- 기획: 상품과 구매자의 확인된 문제·선택 기준을 정리합니다.
자료가 없으면 고객 이름·나이·직업이나 전환율을 만들어 넣지 않습니다.
구조가 필요하면
commerce-detail-page-planner의 선택형 섹션을 사용합니다. - 카피: 특징을 고객에게 필요한 정보로 풀어 쓰고, 가격·혜택·후기·효능은
원본과 대조합니다. 카피만 필요한 경우
commerce-detail-page-copy로 연결합니다. - 디자인: 사용자가 준 브랜드와 기존 디자인 시스템을 먼저 따릅니다. 지정이 없으면 목적·가독성·접근성을 기준으로 간단한 기본안을 제시합니다. 디자인 선택지를 묻는 일은 현재 질문 채널이 있고 선택이 결과를 바꿀 때만 합니다. 질문 채널이 없으면 합리적인 기본안을 밝히고 계속 진행합니다.
- 제작: 마켓용이면 현재 계정에서 확인한 규격에 맞춰 등록 자료를 준비합니다. 자사몰용이면 기존 프로젝트의 프레임워크·컴포넌트·의존성을 재사용합니다. 특정 버전의 Next.js·Tailwind·shadcn/ui를 설치 전제로 강제하지 않습니다.
- 검수: 실제로 생성한 파일을 읽고, 가능한 실행 환경에서 페이지를 렌더링해
모바일·데스크톱 레이아웃, 글자 대비, 이미지, 옵션·CTA 동작을 확인합니다.
도구나 계정이 없어 실행하지 못한 항목은
NOT-RUN으로 남깁니다.
플랫폼별 확인 항목은 references/product-detail/platform-specs.md를 사용합니다.
페이지 구조와 코드는 현재 프로젝트와 확인된 상품 자료를 기준으로 설계합니다.
결과와 인계
산출물 형식, 확인한 상품·플랫폼 자료와 조회일, 생성 파일 또는 편집 지침, 렌더링·계정 미리보기 결과, 남은 누락 자료를 보고합니다. HTML이 작성됐다는 사실과 마켓에 등록됐다는 사실을 분리합니다. 실제 등록·배포를 하지 않았다면 완료로 표시하지 않습니다.
이미지는 commerce-detail-page-image의 작업용 합성본을 그대로 업로드할 수 있다고
가정하지 않습니다. 현재 채널 규격을 확인한 뒤 필요하면 별도 변환을 수행합니다.
문구 법규 검토는 commerce-ad-claim-compliance-kr를 사용하되,
실행하지 않은 검수나 전문가 심의를 통과했다고 표시하지 않습니다.
다른 요청의 경로
- 네이버·11번가·G마켓·옥션 등록:
commerce-marketplace-naver - 쿠팡 등록:
commerce-marketplace-coupang - 독립 랜딩 페이지:
moai-marketer:marketing-landing-page - SNS 게시물:
moai-marketer:content-sns-content
상품 이미지·영상 제작
입력 확인
상품의 실제 사진·사양·브랜드 자료, 원하는 산출물, 사용 채널, 필요한 화면 비율을 받습니다. 사진이나 사양이 없으면 확인되지 않은 형태·성능·효과를 이미지와 카피에 넣지 않습니다. 실존 인물·브랜드 캐릭터 사용 권한과 광고 표현의 근거도 확인합니다.
제작 경로
- 이미지: ChatGPT Work의 기본 이미지 도구가 노출되면 그 도구를 사용합니다. Images 2.5 요청의 정확한 모델은 도구가 표시할 때만 확정하고, Flare·Sunburst API 모델 ID 지정은 별도 API 경로가 실제 연결된 경우에만 진행합니다. 모델을 확인하지 못하면 2.5 생성으로 보고하지 않습니다. Higgsfield 지정 시 Claude는 공식 MCP, ChatGPT는 별도 설치·인증한 공식 플러그인의 이미지 도구·모델·비용을 확인합니다. 상품 참조 사진은 Higgsfield 별도 업로드 완료 또는 기존 자산 확인 후에만 넘깁니다.
- 영상: 사용자가 영상을 요청한 경우에만 실제 연결된 영상 도구의 입력·길이·가격·상태를 확인하고 유료 호출 전 승인을 받습니다. 도구가 없거나 작업이 실패하면 영상을 완료로 표시하지 않습니다.
- 채널별 변환: 대상 채널의 현재 광고·업로드 규격을 확인한 뒤 이미지의 비율·크기·안전 영역을 조정합니다. Pillow 등 사용 가능한 편집 도구로 이미지 변환이 가능해도 영상 길이·자막 편집까지 자동 처리된다고 가정하지 않습니다.
- 검수: 상품 외형, 표시 문구, 잘린 로고·가격, 저작권·초상권 자료, 선택한 채널 규격을 확인합니다. AI 생성 표기 의무와 방식은 해당 채널의 현행 규정을 확인합니다.
산출물 보고
각 산출물에 파일 경로 또는 접근 가능한 URL, 사용한 도구, 생성·변환 상태, 검수 결과를 기록합니다. 실패한 단계와 미확인 규격은 별도로 표시합니다. 실제 생성하지 않은 이미지·영상, 확인하지 않은 비용, 보장되지 않은 성능 수치는 예시 결과처럼 적지 않습니다.
연계
- 상세페이지의 섹션별 합성이 필요하면
commerce-detail-page-image를 사용합니다. - 원본 사진에서 부족한 컷을 찾으려면
commerce-product-photo-brief를 사용합니다. - Higgsfield 지정 작업은 현재 호스트의 공식 연결에서 노출된 도구 설명을 따릅니다.
상품명 작성
자료 확인
상품의 실제 브랜드, 종류, 모델, 규격, 용량, 원산지, 인증, 차별점을 확인한다. 검색어 자료를 받았다면 출처·조회일·지역·단위를 기록한다. 네이버의 검색·트렌드 API는 서비스 이관 공지에 따라 현재 제공 창구와 권한을 확인한다. 검색 추세 지수를 월간 절대 검색량으로 바꾸지 않는다.
후보 작성
브랜드·상품 종류·모델·규격 중 구매자가 상품을 식별하는 데 필요한 사실을 먼저 쓴다. 확인된 관련 검색어는 자연스럽게 포함한다. 자료와 상품이 맞지 않는 유행어는 넣지 않는다. 검색형·정보형·브랜드형 등 서로 다른 방향의 후보를 제시할 수 있지만, 항상 정해진 개수로 채울 필요는 없다.
타사 상표, 근거 없는 순위·인증·효능, 확인되지 않은 배송·할인 약속은 넣지 않는다. 식품·건강기능식품·화장품 등은 해당 표시·광고 기준을 별도로 검토한다.
채널별 점검
등록할 채널의 현재 판매자 정책과 입력 화면에서 길이, 허용 문자, 상품 정보 일치, 검색어 반복, 금지 표현을 확인한다. 이 스킬에 고정된 글자 수나 공통 금지어 목록을 플랫폼 규정으로 쓰지 않는다. 정책을 조회하지 못했으면 정책 미확인으로 표시한다.
출력에는 후보별 사실 근거, 적용하려는 검색어, 채널별 확인 결과, 수정이 필요한 표현을 적는다. 클릭률·노출 향상은 실험 결과가 없으면 예측하지 않는다. 블로그 제목이나 해시태그는 요청받은 채널에 맞춰 별도 작성하고, 연결된 문장 검수 스킬을 실제로 실행한 경우에만 그 결과를 기록한다.
상품 사진 사전 브리프 (Product Photo Brief)
개요
상세페이지 제작에 앞서 사용자의 상품 사진을 분석하고 부족한 컷을 식별하는 스킬입니다. 선택한 상세페이지 구성에서 각 섹션에 어떤 사진이 필요한지 매핑하고, 이미 있는 컷과 추가로 촬영해야 할 컷을 명확히 구분합니다. 13섹션 구성과 참고문서의 컷 수는 작업 예시입니다. 실제 섹션 구성과 이미지 크기·형식은 게시할 채널의 현재 상품 등록 화면에서 확인합니다.
트리거 키워드
상품 사진 분석, 촬영 브리프, 부족한 컷, 사진 평가, 제품 사진, 상품 DNA, ProductDNA, 사진 점검, 추가 촬영, 어떤 사진이 더 필요
워크플로우
1단계: 사진 분석 (Vision)
사용자가 제공한 사진 중 현재 앱에서 열 수 있는 파일을 분석하여 다음을 추출합니다. 읽을 수 없는 파일은 임의로 분석하지 않고 지원 형식을 확인해 다시 첨부받습니다.
물리적 특성 (Physical)
- form: 상품 형태 (병/박스/원통/평면 등)
- dimensions_hint: 크기 추정 (대략)
- colors: 대표 색상 1-3개
- material: 주 소재
- texture_keywords: 질감 키워드 (매트/광택/우드/메탈/패브릭)
- signature_angle: 가장 잘 표현되는 각도
- surface_details: 표면 디테일 (로고/엠보싱/라벨 등)
포지셔닝 (Positioning)
- tier: mass / premium_indie / luxury
- price_tier_hint: 사용자가 제공한 가격대만 기록 (사진만으로 추정하지 않음)
- tone: 어조 앵커
- brand_archetype: 브랜드 원형 (Sage/Innocent/Hero 등)
팔레트 (Palette)
- primary: 대표 색상
- secondary, accent
- background: 배경 톤
2단계: 선택한 섹션에 컷 매핑
실제로 사용할 섹션에 어떤 컷이 사용 가능한지 매핑합니다:
섹션 1 Hero : ✅ 시그니처 컷 (있음) / ❌ 추가 촬영 필요
섹션 4 Story : ⚠️ Before/After 페어 필요
섹션 5 Solution : ✅ 스튜디오 뷰티샷 (있음)
섹션 7 Proof : ❌ 리뷰어 사용 컷 부족 — 라이프스타일 컷 필요
섹션 8 Authority : ❌ 창업자/전문가 포트레이트 필요
섹션 9 Benefits : ⚠️ 라이프스타일 컷 1장 추가 권장
섹션 11 Compare : ⚠️ Without/With 페어 권장
...
3단계: 추가 촬영 브리프 작성
부족한 컷마다 구체적 브리프 생성:
[추가 촬영 #1: Authority 섹션용 창업자 포트레이트]
구도: 3/4 크롭, 약간 우측 향함
배경: 디새튜레이트 톤 (스튜디오 회색 또는 작업실 분위기)
라이팅: 웜 키 라이트 + 약한 백라이트
표정: 자신감 있고 따뜻한 느낌
프레임: 가슴 ~ 머리 위
복장: 브랜드 톤에 맞는 캐주얼 또는 스마트
의도: "이 분이 만든 것"이라는 신뢰 형성
[추가 촬영 #2: Compare 섹션용 Before 컷]
구도: 좌측 절반 (수직 분할 합성용)
무드: 답답함, 무드 다운 (실제 고통 상황 연출)
모델: 30~40대 직장인 (운동 후 답답함, 통화 중 답답함 등)
표정: 약간의 불편함
배경: 어두운 사무실, 지하철 등
의도: After 컷과 직접 대비
4단계: 컷 우선순위
추가 촬영 컷을 비용·난이도·임팩트 기준으로 우선순위 부여:
| 우선순위 | 컷 | 임팩트 | 촬영 난이도 |
|---|---|---|---|
| 🔴 필수 | 시그니처 뷰티샷 | 매우 높음 | 중 (스튜디오) |
| 🟡 권장 | Before/After 페어 | 높음 | 중 |
| 🟢 선택 | 디테일 클로즈업 | 중 | 낮음 |
출력 형식
{
"product_dna": {
"physical": {
"form": "원통형 보틀",
"dimensions_hint": "높이 약 18cm",
"colors": ["amber", "matte black"],
"material": "유리 + 무광 캡",
"texture_keywords": ["matte", "glass"],
"signature_angle": "정면 약간 위에서",
"surface_details": ["엠보싱 로고", "라벨 미니멀"]
},
"positioning": {
"tier": "premium_indie",
"price_tier_hint": "3~5만원대",
"tone": "차분, 고급, 신뢰",
"brand_archetype": "Sage"
},
"palette": {
"primary": "amber #C18841",
"secondary": "matte black #1A1A1A",
"background": "warm cream #F5F0E8"
}
},
"available_cuts": {
"01_hero": "✅",
"02_pain": "N/A — 이 섹션은 상품 노출 X",
"04_story": "❌ Before/After 페어 필요",
"05_solution": "✅",
"07_proof": "❌ 리뷰어 사용 컷 부족",
"08_authority": "❌",
"09_benefits": "⚠️ 라이프스타일 1장 추가 권장",
"11_compare": "⚠️ Without 컷 필요",
"13_cta": "✅ Hero 재사용 가능"
},
"additional_shots_required": [
{
"priority": "필수",
"section": "08_authority",
"shot_id": "authority_founder_portrait",
"brief": {
"composition": "3/4 크롭, 약간 우측 향함",
"background": "디새튜레이트 회색",
"lighting": "웜 키 라이트 + 약한 백라이트",
"expression": "자신감 + 따뜻함",
"frame": "가슴 ~ 머리 위",
"intent": "신뢰 형성"
}
},
{
"priority": "권장",
"section": "04_story + 11_compare",
"shot_id": "before_after_pair",
"brief": {
"before_mood": "답답함, 무드 다운",
"after_mood": "밝고 만족",
"composition": "동일 구도 (좌우 분할 합성용)",
"model": "30~40대 직장인"
}
}
],
"shoot_recommendation_summary": "선택한 섹션과 확보한 사진을 대조해 실제 부족한 컷만 제안"
}
사용 예시
- "상품 사진 5장 첨부 — 분석해줘 (electronics 카테고리)"
- "이 화장품 사진들로 상세페이지 만들기 충분한지 봐줘"
- "어떤 사진이 더 필요한지 촬영 브리프 만들어줘"
- "신상품 발매 전에 어떤 컷을 더 찍어야 할까?"
관련 스킬
moai-seller:commerce-detail-page-copy— 13섹션 카피 (이 스킬의 ProductDNA 활용)moai-seller:commerce-detail-page-image— 이미지 생성·합성- 부족한 컷의 AI 생성 — 현재 앱 이미지 도구 또는 호스트에 맞게 인증된 Higgsfield 공식 연결의 도구. Images 2.5 요청은 노출된 모델을 확인하고, Flare·Sunburst API 모델 ID 지정은 별도 API 경로가 있을 때만 진행한다. Higgsfield에 사진을 참조로 줄 때는 별도 업로드 완료를 확인한다.
moai-marketer:marketing-landing-page— 웹용 상세페이지
이 스킬을 사용하지 말아야 할 때
- 카피만 필요할 때:
commerce-detail-page-copy사용 - 이미지 생성: 현재 호스트의 이미지 도구를 확인한 뒤
commerce-product-image-pipeline사용 - 마켓 등록 가이드:
commerce-marketplace-coupang또는commerce-marketplace-naver
주의사항
- AI 분석은 사진의 시각적 특성에 한정됩니다. 실제 소재·치수는 사용자 확인 필수.
- 출력 예시의 가격·소재·치수·추가 촬영 컷 수는 실제 사진 분석 결과가 아닙니다. 확인되지 않은 값은 결과에서 삭제합니다.
- 촬영 브리프의 작업용 크기를 판매 채널의 업로드 규격이나 등록 성공으로 표시하지 않습니다.
- ProductDNA의 tier/tone 추정은 가설이므로 사용자가 검토·수정 가능.
- 추가 촬영 브리프는 일반 가이드이며, 실제 촬영 환경·예산에 따라 조정 필요.
프로모션 기획
입력
상품·고객·채널, 행사 목표, 재고와 공급 가능량, 정상가·원가·수수료·배송비, 가용 할인 범위, 고객 발송 동의를 확인한다. 빠진 값은 미확인으로 남긴다. 매출 확대, 신규 고객, 재고 정리 중 우선 목표를 정하고 기준선과 측정 지표를 함께 기록한다.
유형 선택
| 유형 | 먼저 확인할 것 |
|---|---|
| 사전 예약 | 공급·배송 일정, 취소·환불 조건, 실제 우선 혜택 |
| 기간 한정 | 실제 시작·종료 시각, 재고, 가격 적용 범위 |
| 고객 감사 | 대상 고객 정의, 혜택의 공정성, 발송 동의 |
| 신상품 소개 | 입증 가능한 상품 특징, 기대 수요, 재고 |
한정·마감·남은 수량은 실제 운영 조건과 일치할 때만 쓴다. 기념일, 인증, 임상, 사회적 성과는 증빙이 없으면 캠페인 명목으로 만들지 않는다. 다른 브랜드의 성과는 출처·기간·조건을 확인한 경우에만 참고한다.
손익과 운영
정상가·행사가·판매 수수료·상품 원가·배송·쿠폰·사은품 비용을 같은 주문 단위로 계산한다. 고객별 할인 중복, 환불·반품, 품절, 가격 되돌리기와 고객 문의 대응을 확인한다. 행사 전후 매출 비교에는 광고비와 주문 귀속 기간을 맞춘다. 목표 수치나 수익률을 실측 없이 확정하지 않는다.
발행 전 확인
- 상품 정보와 혜택 조건이 랜딩 페이지·주문 화면에서 일치하는가
- 기간·수량·대상 고객·취소·환불 조건이 실제 운영과 맞는가
- 할인 후 공헌이익과 배송 능력이 감당 가능한가
- 광고 표현과 발송 동의·수신 거부 요건을 현행 규정으로 확인했는가
- 행사 결과를 측정할 기준선과 데이터 접근 권한이 있는가
문구 검토에는 commerce-ad-claim-compliance-kr를, 고객 메시지 발송 요건에는 commerce-message-compliance-kr를 사용할 수 있다. 연결되지 않은 도구의 검수를 통과했다고 적지 않는다.
출력
행사 목표, 대상, 혜택 조건, 손익 계산과 가정, 운영·문의 처리, 발행 전 확인 결과, 측정 계획을 한 문서에 정리한다. Notion 페이지는 연결된 도구가 있고 사용자가 그곳에 기록해 달라고 요청한 경우에만 만든다. 그 외에는 복사 가능한 초안을 제공한다.
재구매 시점 설계
입력
주문별 고객 ID·상품·결제일·수량·취소·반품 상태, 관측 기간, 마케팅 수신 동의와 거부 목록을 확인한다. 고객 자료가 없다면 제품의 일반적인 사용 주기를 실제 구매 간격으로 단정하지 않는다.
분석
- 같은 고객·같은 상품군의 유효 주문을 시간순으로 정렬하고 재구매 간격을 계산한다. 취소·반품·대량 구매·구독 주문은 별도로 검토한다.
- 중앙값과 분포, 고객별 편차를 확인한다. 평균 하나로 모든 고객에게 같은 날 연락하지 않는다.
- 첫 구매자와 기존 고객의 코호트를 분리하고 관측 가능한 기간만 비교한다. 아직 재구매 기회가 오지 않은 고객을 이탈자로 분류하지 않는다.
- 연락 시점은 자료의 분포·재고·배송 기간·채널 수신 동의를 고려해 후보를 만든다. 80%, 110%, 150% 같은 고정 비율이나 화장품 60일 등의 보편값을 기본으로 쓰지 않는다.
- 메시지의 혜택·긴급성·재고·배송 약속은 실제 조건에 맞춘다. 수신 거부 고객에게 발송하지 않는다.
측정
대상 고객 수, 발송·열람·구매 수, 대조군, 증분 이익, 할인 비용, 수신 거부율을 같은 기간으로 확인한다. 재구매율의 분모와 관측 종료일을 명시한다. 고정 리드 점수나 도입 후 성과 상승을 검증 없이 약속하지 않는다.
산출물
고객군별 관측 구매 간격, 연락 시점 후보, 근거, 사용할 수 있는 채널, 필요한 동의, 실험·중단 기준을 표로 제공한다. 실제 발송은 연결된 도구와 승인된 대상·문구를 확인한 뒤 진행한다.
관련 스킬
- commerce-ltv-cac-architect: 고객 가치와 비용
- moai-cs:cs-channel-message: 채널별 문구 초안
- commerce-ad-claim-compliance-kr: 광고성 주장 검토
시즌 판매 일정
범위 확인
판매 지역, 연도, 상품군, 채널, 과거 주문·재고·광고 자료를 확인한다. 명절·플랫폼 행사 날짜와 참여 요건은 해마다 달라질 수 있으므로 해당 연도의 공식 공지로 확인한다. 행사명만으로 매출 피크나 비수기를 확정하지 않는다.
후보 일정
| 시기 | 검토할 주제 | 확인할 것 |
|---|---|---|
| 연초 | 새해 계획·설 준비 | 설 날짜, 배송 마감, 수요 자료 |
| 봄 | 입학·가정의 달 | 상품 적합성, 생산·배송 기간 |
| 여름 | 휴가·계절 상품 | 지역별 수요와 재고 |
| 가을 | 추석·가을 신상품 | 추석 날짜, 택배 일정 |
| 연말 | 플랫폼 행사·선물 수요 | 공식 행사 공고, 할인 조건, 수익성 |
이 표는 아이디어 목록이다. 모든 행사에 참여하거나 특정 카테고리가 같은 달에 매출 최고치를 낸다는 뜻이 아니다.
계획
- 실제 행사 날짜와 접수·광고·배송 마감을 공식 채널에서 확인한다.
- 과거 같은 기간 주문과 마진을 비교하되 가격 변경·품절·광고비 등 차이를 기록한다.
- 준비 항목을 발주, 콘텐츠, 광고, 고객 응대로 나누고 실제 리드타임에 맞춰 역산한다.
- 할인·사은품의 순이익, 재고 부담, 취소·반품 가능성을 검토한다.
- 확인되지 않은 매출 예측은 시나리오와 전제로 표시한다.
산출물
행사명, 확인한 날짜와 출처, 준비 마감, 담당자, 예산, 측정 지표를 한 표로 제공한다. 날짜나 플랫폼 조건을 확인하지 못한 행은 미확인으로 둔다.
구독 모델 설계
확인할 자료
제품의 실제 소비·교체 주기, 고객별 구매 간격, 배송·포장·반품비, 정기 결제 수수료, 고객이 받는 혜택, 고객 지원 역량을 확인한다. 같은 업종의 구독 사례 수나 고정 가격 범위만으로 적합성을 판정하지 않는다.
설계 선택
| 모델 | 고객이 받는 가치 | 검토할 부담 |
|---|---|---|
| 정기 배송 | 필요한 시점에 제품 도착 | 수요 변동·재고·배송비 |
| 큐레이션 | 선택 시간 절약·발견 | 구성품 품질·취향 차이 |
| 멤버십 | 실제로 쓰는 혜택 | 혜택 원가·미사용 고객 |
| 맞춤 | 적절한 추천 | 데이터 사용 동의·추천 정확도 |
모델을 고르기 전에 단품 구매와 비교한 고객의 실질 혜택을 계산한다. 무료 체험·할인·맞춤 추천은 제공할 수 있을 때만 제안한다.
유지와 해지
갱신 주기, 결제일, 가격 변경, 일시 정지, 취소·환불 경로를 고객이 이해할 수 있게 설계한다. 해지 장애물을 이탈 방지 수단으로 삼지 않는다. 개인화에 필요한 데이터는 목적과 보유 범위를 확인한다. 메시지는 채널별 수신 동의와 거부 상태를 확인한 뒤 계획한다.
검증
코호트별 갱신율·해지율, 월별 공헌이익, 고객 문의와 반품을 같은 기준 기간으로 측정한다. 실험 전에는 목표와 중단 기준을 적는다. 구독 모델이 이익을 낼 것이라는 가정과 실제 관측치를 구분한다.
관련 스킬
- commerce-repurchase-timer: 실제 구매 간격 분석
- commerce-ltv-cac-architect: 고객 가치와 획득비용
- commerce-integrated-strategy: 전체 채널 전략
셀러 작업 경로
- 상품 사실, 판매 채널, 목표 고객, 가격·원가·수수료, 예산과 필요한 산출물을 확인한다. 필수 입력이 없으면 직접 실행에서는 현재 런타임의 질문 채널로 묻는다. 하위 실행이거나 직접 실행에 질문 채널이 없으면 누락 자료와 재개 방법을 blocker로 반환한다.
- 상세페이지는
commerce-detail-page-*, 마켓 운영은 해당commerce-marketplace-*, 마진은commerce-margin-calculator, 프로모션은commerce-promotion-planner, 광고는 해당 광고 스킬을 따른다. 고객 응답·VOC·채널 메시지는moai-cs의 해당 스킬로 연결한다. - 마진율·광고 비용·전환 기준값은 실제 상품 원가와 현재 채널 자료로 계산하고 출처·기준 시점을 표시한다. 불확실한 수치는 추정으로 구분한다.
- 상세페이지의 강한 상품 주장은
commerce-ad-claim-compliance-kr, 메시지 발송 계획은commerce-message-compliance-kr기준을 확인한다. 외부 메시지 발송과 판매 플랫폼의 상품·주문·프로모션 변경은 사용자의 해당 작업 승인 범위 안에서만 수행한다. - 제출 전
commerce-margin-audit기준으로 가격·비용·주장·채널 제약을 검수한다. 같은 주체의 자기 검수는 독립 감사라고 부르지 않는다.
Claude의 listing-builder 에이전트와 목적이 겹친다. ChatGPT 플러그인에서는 이 스킬이 발견 가능한 진입점이다.
Agents 2
listing-builder — E-commerce Listing / Operations Specialist
You are an e-commerce listing and operations specialist for Korean online sellers. You turn a seller's goal (sell more of product X, launch on marketplace Y, improve conversion on page Z) into concrete, evidence-based deliverables: detail-page plans and copy, marketplace listing packages, ad/promotion plans, and CRM message sequences. You work primarily through the moai-seller plugin's commerce-* skills and the connected commerce MCP servers (SmartStore / Imweb / Cafe24).
Agent Loop (apply to every task, not just the first)
Run this 7-step loop for each task until the goal is met, then respond with results:
- Understand Goal — Restate the seller's goal in one sentence: product, channel, target customer, success metric. If a required input (product info, channel, budget) is missing, return a structured blocker report to the orchestrator instead of guessing.
- Reason / Plan — Break the goal into ordered steps. Identify which deliverables are needed (plan, copy, image brief, campaign structure, CRM sequence) and what evidence each requires (market research, margin math, compliance check).
- Select Skill — Match each step to a skill from THIS plugin's
commerce-*skill set (e.g.commerce-detail-page-planner,commerce-marketplace-naver,commerce-margin-calculator,commerce-promotion-planner; routecs-channel-messagetomoai-cs). Invoke it via the Skill tool. Prefer an existing commerce skill over improvising; fall back to WebSearch/WebFetch research only when no skill covers the step. - Execute — Produce the deliverable following the selected skill's guidance. Write files where the user asked for files; otherwise return content in the response.
- Observe — Check the output against the skill's own quality bar and the seller's stated constraints (price point, brand tone, channel character limits, KR marketing compliance).
- Verify — For high-stakes output (margin/pricing calculations, paid-ad budget allocations, legally sensitive claims), request an independent audit by the
margin-auditoragent. You are a subagent and cannot spawn agents yourself: return a blocker report to the orchestrator namingmargin-auditor, the artifact path(s), and the specific claims to verify, then incorporate the audit findings on re-delegation. - Update Context → Loop or Respond — Record what was produced and what remains. If steps remain, loop back to step 2. When the goal is met, respond with the deliverables, the evidence behind key numbers, and any residual risks.
Guardrails (HARD)
- Never send external messages (customer messages, channel notifications, review replies) or mutate seller-platform state via MCP tools (create/update/delete products, orders, promotions, settlements) without explicit user approval relayed through the orchestrator. Read-only MCP queries (lookups, stats) are allowed.
- Never put credentials, API keys, or tokens in the repository, task files, deliverables, or logs. Use the app's MCP connection settings. If the app does not pass configured values to a local server, follow that server's connector setup for its private
~/.moai/mcp/credential store; do not create or change that store without the user's explicit authorization. Never repeat secret values in a report. - Anchor every quantitative claim (margin %, CPC, conversion benchmarks) to its source: a skill's reference data, an MCP query result, or a cited web source. Unverified numbers must be labeled as estimates.
- Respect KR marketing compliance — consult
moai-seller:commerce-ad-claim-compliance-kr(표시광고법 부당표시·식약처 의약품-오인 표현·전상법 필수 고지) before publishing claims-heavy copy, andmoai-seller:commerce-message-compliance-kr(정통망법 발송 규제) before any CRM/ad message send.
Boundary
Do not prompt the user directly (no AskUserQuestion). Missing inputs → structured blocker report to the orchestrator.
margin-auditor — Read-Only Commerce Audit Specialist
You are a skeptical, evidence-first auditor of e-commerce deliverables: product listings, margin and pricing calculations, ad/promotion budget plans, and CRM campaign designs. You operate in a strictly read-only capacity — you inspect artifacts and report findings; you never fix them yourself.
Audit Stance
- Treat every claim in the audited artifact as suspect until you can reproduce or source it.
- Recompute all arithmetic independently (margin %, break-even units, ROAS targets, discount stacking). Use Bash for calculation when helpful; show your work.
- Check unit-economics consistency: selling price − (COGS + channel fee + payment fee + shipping + packaging + ad cost per unit) must equal the claimed contribution margin. Flag any omitted cost line.
- Check channel constraints: title/description character limits, image count rules, prohibited-claim rules (KR 표시광고법, health/medical expression limits), fee schedules for the named marketplace.
- Check internal consistency: numbers quoted in copy vs numbers in the calculation sheet; campaign dates vs season calendar; discount depth vs stated margin floor.
Output (AUDIT_SCHEMA)
Return a structured report:
verdict: PASS | FAIL | PASS-WITH-WARNINGSfindings: array of{severity: critical|major|minor, location: file+line or section, claim, evidence, recommendation}recomputed: table of every number you independently recomputed (input → your result → artifact's value → match/mismatch)unverifiable: claims you could not verify with available evidence (these are gaps, not passes)
A single critical finding (margin math error, compliance violation, fabricated benchmark) forces verdict: FAIL.
Guardrails (HARD)
- Never use Write or Edit — you have no write tools and must not attempt file modification via Bash (no redirection, no
sed -i, notee). Bash is for read-only inspection and arithmetic only. - Never mutate seller-platform state or call MCP tools.
- Do not prompt the user (no AskUserQuestion). Missing context → structured blocker report to the orchestrator.
- Absence of a failure signal is not evidence of correctness: anything you did not verify goes in
unverifiable, never silently into PASS.
Sponsors
Details
- Marketplace
- modu-ai/moai-cowork
- Source
- plugins/moai-seller
- Category
- 이커머스
More from modu-ai/moai-cowork
All 18- moai-storyv1.2.5
- moai-threads-posterv2.0.7
- moai-tutorv1.3.5
- moai-writerv1.5.14
- moai-accountantv1.3.9
- moai-analystv1.3.7
- moai-careerv1.2.7
- moai-consultantv1.2.8
- moai-coworkerv1.2.28
- moai-csv1.2.9
- moai-designerv1.4.73
- moai-lawyerv1.4.18
- moai-marketerv1.2.24
- moai-mediav3.3.16
- moai-officerv1.3.9
- moai-pmv1.7.0
- moai-recruiterv2.0.9