moai-commerce — 한국 이커머스 풀스택 30 스킬

한국 이커머스 운영의 전 사이클을 한 플러그인에 담은 30개 스킬 묶음입니다. 시장조사부터 고객 분석·상품명·상세페이지·채널 메시지·통합 전략·광고 최적화·마진/LTV 설계·자동화 진단·법규 준수·프로모션·재구매·이미지 파이프라인·리뷰 통합·VOC·구독·인플루언서·식약처 안전까지 자연어 한 줄 입력으로 자동 체인 호출됩니다.

moai-commerce는 월 매출 100만-10억 규모의 스마트스토어·자사몰·오픈마켓 셀러가 실제로 마주치는 작업을 다룹니다.

moai-commerce를 한마디로 비유하면 주방장 30명이 있는 대형 키친입니다. 주방장마다 담당이 다릅니다. 시장조사 담당은 재료 시세를 조사하고, 카피라이터 담당은 상세페이지 문구를 쓰고, 디자이너 담당은 이미지를 합성하고, 회계 담당은 마진과 광고 수익을 계산하고, 법규 담당은 광고성 메시지 과태료를 피해줍니다. 손님인 사용자가 “무선 이어폰 상세페이지 만들어줘"라고 주문하면, 주방장 30명이 알아서 분업해 한 그릇(완성된 상세페이지 PNG, 또는 아침 브리핑 한 줄)을 내놓습니다. 스킬 30개가 각자의 일만 담당한 뒤 결과를 조립해 하나의 산출물로 완성하는 구조, 이것이 바로 이 플러그인의 본질입니다.

이 키친에서 자주 등장하는 전문 용어를 미리 한 줄씩 풀어두겠습니다. JTBD(Job To Be Done)는 “고객이 이 상품을 통해 해결하려는 일"을 뜻합니다. 무선 이어폰을 사는 진짜 이유가 ‘블루투스 칩 성능’이 아니라 ‘출퇴근 지하철에서 소음을 차단하고 싶다’는 일(Job)이라는 식으로 고객의 목적을 읽는 방법입니다. ROAS(Return On Ad Spend)는 “광고에 1만 원을 썼을 때 매출이 몇 배로 돌아오는지"를 나타내는 비율로, ROAS 400%면 1만 원 쓰고 4만 원 매출이 났다는 뜻입니다. CAC와 LTV는 한 쌍입니다. CAC(Customer Acquisition Cost)는 “고객 한 명을 데려오는 데 든 비용"이고, LTV(Lifetime Value)는 “그 고객이 브랜드를 떠나기 전까지 평생 써주는 매출"입니다. CAC가 1만 원인데 LTV가 3만 원이면 3배가 되니 건강한 사업이고, 반대면 광고를 멈추는 순간 매출이 사라지는 위험한 구조입니다.

아래 다이어그램은 대표적인 주문 하나가 키친 안에서 어떻게 흘러가는지 보여줍니다. 시장조사 담당이 먼저 재료를 점검하고, 고객 분석 담당이 누가 먹을지 정한 뒤, 카피·이미지·마진·법규 담당이 차례로 결과를 이어받아 마지막에 한 그릇(산출물)으로 조립됩니다.

flowchart LR
    subgraph Research["① 시장·고객 (재료 점검)"]
        R1["commerce-market-research"]
        R2["commerce-jtbd-persona"]
    end

    subgraph Build["② 상품 만들기 (조리)"]
        B1["commerce-product-naming"]
        B2["detail-page-copy"]
        B3["detail-page-image"]
    end

    subgraph Ops["③ 수익·법규 (검수·정산)"]
        O1["commerce-margin-calculator"]
        O2["commerce-marketing-compliance-kr"]
    end

    subgraph Output["④ 산출물 (한 그릇)"]
        OUT["상세페이지 PNG
아침 브리핑 1줄
광고 최적화안"]
    end

    Research --> Build --> Ops --> Output

    style Research fill:#eaeaea,stroke:#6e6e6e,color:#09110f
    style Build fill:#fbf0dc,stroke:#c47b2a,color:#09110f
    style Ops fill:#e6f0ef,stroke:#144a46,color:#09110f
    style Output fill:#d6ebe7,stroke:#1c7c70,color:#09110f

• 상세페이지 자동화: 13섹션 감정여정 카피(Hero→Pain→Problem→Story→Solution→How→Proof→Authority→Benefits→Risk→Compare→Filter→CTA) + 1080×12720 단일 PNG 자동 합성. --mode diagnose(7단계 진단 점수) / --mode copy(페르소나 2세트, 비율 25/50/25 강제)
• 시장·고객·전략 분석: 시장조사 4 MCP, JTBD 9 + 페르소나 3, 상품명 3안+검증, NCM 메시지 15종, 통합 전략 1장
• 운영 데이터 통합: commerce-morning-brief(어제 주문·신규 문의·트렌드·ROAS 4영역 1줄 통합)
• 5개 판매 채널 가이드: 쿠팡·네이버 스마트스토어/11번가/G마켓/옥션, 카페24/아임웹/메이크샵 자사몰, 와디즈/텀블벅 크라우드펀딩, 카카오 메이커스/무신사/29CM 큐레이션, 네이버/카카오/그립/쿠팡 라이브 커머스
• 광고·수익 구조: 쿠팡 광고 풀세트 최적화, 마진·엔드 ROAS 자동 계산, CAC→LTV 6대 지표 설계, 광고 의존도 30%→11-15% 6개월 로드맵
• CRM·법규·재구매: 정통망법 광고/정보성 메시지 자동 게이트(과태료 회피), 앱 푸시 4원칙, 재구매 골든타임 3구간
• D2C 풀스택: 멀티채널 리뷰 통합 분석, VOC 5단계 우선순위, 구독 4 모델, 인플루언서 5 티어, 충성 100명 부트스트랩, 시즌 캘린더 30+ 이벤트
• 상품 사진·이미지 파이프라인: ProductDNA 추출, 추가 촬영 브리프, 캐릭터 일관성 → 이미지 생성 → 영상 생성 → 채널 규격 변환 4단계 오케스트레이터(Higgsfield MCP 기반)
• 식약처 안전: 의약품·식품 통합 조회 (e약은요·건강기능식품 인정현황·검사부적합·회수)

이미지 생성은 moai-media:higgsfield-image(Higgsfield MCP — Soul·Nano Banana·GPT Image 계열)로 위임하고, 외부 도구에서 직접 생성할 때는 moai-media:gpt-image-2-prompt·moai-media:gemini-3-image-prompt 프롬프트 빌더를 활용합니다. 합성은 Pillow 기반 자체 스크립트로 처리하므로 외부 패키지 설치가 필요 없습니다. 모든 텍스트 산출물은 ai-slop-reviewer로 자동 체이닝됩니다.

commerce-automation-audit와 commerce-integrated-strategy가 공통으로 따르는 핵심 원칙입니다. HITL(Human-in-the-Loop)은 “사람이 루프 안에 있는 자동화"라는 뜻으로, 기계가 다 처리하고 끝내는 게 아니라 반드시 사람이 중간에 끼어든다는 의미입니다.

구체적인 규칙은 두 줄입니다. 첫째, 반복되는 업무의 80%는 AI가 자동으로 초안을 만듭니다. 예를 들어 하루 100건 들어오는 주문 확인·고객 문의 답변·광고 카피 초안 같은 작업은 기계가 빠르게 처리합니다. 그중 고난도 창의 작업(브랜드 스토리, 핵심 협상, 전략 판단) 20%는 사람이 직접 손으로 합니다.

둘째, 여기가 핵심인데 — 자동으로 만든 결과물은 사람이 직접 한 20%보다 10배 더 꼼꼼하게 검수합니다. 왜 그럴까요? AI가 빠르게 뽑은 답변은 양불량이 섞여 있기 때문입니다. 사람이 직접 쓴 글은 자기가 쓴 만큼 어디가 약한지 알지만, 기계가 만든 80건은 “다 됐겠지” 하고 넘기면 오류가 고스란히 고객에게 갑니다. 그래서 자동화 비율이 높을수록 검수 강도를 역으로 높이는 것입니다. 실제로는 “AI가 10초 만에 만든 상세페이지 초안을 사람이 10배의 시간과 꼼꼼함으로 사실 확인·법규·톤앤매너를 점검한다"는 흐름입니다. 즉 자동화는 ‘시간 절약’이 목표가 아니라 ‘검수에 쏟을 시간을 만드는’ 도구입니다.

flowchart TD
    IN["반복 업무 100건
(주문·문의·카피 초안 등)"]

    subgraph AUTO["자동화 영역 — AI가 담당 (80%)"]
        AI["AI 초안 자동 생성
(80건 = 80%)"]
        GATE{"사람 검수 게이트
(HITL)"}
        DEEP["★ 10배 검수
자동 산출물을 안 한 20% 대비
10배 꼼꼼히 확인"]
    end

    subgraph MANUAL["수동 처리 영역 — 사람 직접 (20%)"]
        DIRECT["고난도·창의 작업
사람이 직접 (20건 = 20%)"]
        REVIEW["표준 검수
(1배 기준선)"]
    end

    OUT["최종 산출
승인 / 반려 후 반영"]

    IN -->|"분류"| AI
    AI --> GATE
    IN -.->|"고난도 20%"| DIRECT
    DIRECT -->|"1배 검수"| REVIEW
    GATE ==>|"예: 자동 산출물"| DEEP
    DEEP ==>|"10배 검수 완료"| OUT
    REVIEW -->|"표준 검수 완료"| OUT

flowchart TB
    Detail[detail-page-copy
+ detail-page-image] --> Adapt{채널별 적용}
    Adapt -->|오픈마켓| OpenMarket[marketplace-coupang
marketplace-naver]
    Adapt -->|자사몰| D2C[marketplace-d2c
cafe24·imweb·메이크샵]
    Adapt -->|선주문| Funding[marketplace-crowdfunding
와디즈·텀블벅]
    Adapt -->|큐레이션| Curation[marketplace-curation
카카오메이커스·무신사·29CM]
    Adapt -->|라이브| Live[live-commerce
네이버·카카오·그립·쿠팡]
    OpenMarket --> Marketing[commerce-strategy
+ commerce-copywriting]
    D2C --> Marketing
    Funding --> Marketing
    Curation --> Marketing
    Live --> Marketing

상세페이지 풀 자동화 (시장 분석 → 카피 → 합성 이미지)

commerce-market-research → commerce-jtbd-persona(persona) → commerce-product-naming
→ detail-page-copy(diagnose) → detail-page-copy(copy) → detail-page-image
→ marketplace-coupang(또는 naver) → ai-slop-reviewer

광고 운영 최적화 (쿠팡 + 마진 + 자동화 진단)

commerce-margin-calculator → coupang-ad-optimizer → commerce-automation-audit
→ commerce-ltv-cac-architect → commerce-integrated-strategy

자사몰 신규 런칭

commerce-strategy → detail-page-copy → detail-page-image → marketplace-d2c
→ commerce-copywriting → ai-slop-reviewer

크라우드펀딩 신상품 사전판매

product-photo-brief → marketplace-crowdfunding → detail-page-copy → ai-slop-reviewer

라이브 방송 1회분

live-commerce → commerce-copywriting(라이브 카피) → ai-slop-reviewer

CRM 발송 게이트 (법규 준수)

commerce-push-planner → commerce-marketing-compliance-kr → (PASS 시 발송)

리뷰·VOC 통합 액션

commerce-review-aggregator → commerce-voc-triage → commerce-promotion-planner

옵션을 매번 직접 작성할 필요 없습니다. 짧은 한 줄로 요청하면 시스템이 카테고리·가격대·USP·채널 등을 인터뷰로 수집합니다. (사용 패턴 가이드 참조)

> 무선 이어폰 상세페이지 만들어줘

→ 시스템 인터뷰: 카테고리·가격대·USP·주요 채널 → 자동 체인 (detail-page-copy → detail-page-image → marketplace-coupang → ai-slop-reviewer)

> 쿠팡 광고 최적화 진단해줘

→ 시스템 인터뷰: 월매출·광고비·핵심 SKU → commerce-margin-calculator → coupang-ad-optimizer → commerce-ltv-cac-architect 자동 체인

> 와디즈에 사전판매할 휴대용 커피머신 프로젝트 페이지 기획해줘

→ 시스템 인터뷰: 목표 금액·펀딩 기간·리워드 단계 → product-photo-brief → marketplace-crowdfunding → detail-page-copy 자동 체인

> 우리 브랜드 충성 고객 100명 만드는 전략 짜줘

→ 시스템 인터뷰: 카테고리·현재 LTV·예산 → commerce-early-fan-builder → commerce-subscription-strategist → commerce-push-planner 자동 체인

식품의약품안전처(MFDS) 공식 OpenAPI를 통해 의약품과 식품의 안전 정보를 통합 조회합니다. 헬스/F&B 커머스 상품 검수, 회수·부적합 이력 점검, 소비자 안전 안내에 활용합니다. 의약품 mfds-drug-safety와 식품 mfds-food-safety를 한 스킬로 통합했습니다.

사용자가 증상·복용/섭취 상황을 말하면 반드시 인터뷰로 먼저 되묻고, 다음 red flag 발견 시 API 조회보다 즉시 119·응급실·의료진 안내가 우선합니다.

• 호흡곤란, 의식저하, 입술·혀 붓기, 심한 발진
• 혈변, 심한 탈수, 심한 복통/고열, 지속되는 구토/흉통

본 스킬은 진단·처방·복용 지시를 하지 않습니다. 공식 문서에 있는 효능·주의·상호작용·기능성 문구만 근거로 요약합니다.

서비스 코드는 NomaDamas k-skill 명세 기준입니다. 식약처 통합 진입점은 식의약 데이터 포털 (data.mfds.go.kr) 이며, 식품안전나라 OpenAPI는 foodsafetykorea.go.kr/apiMain.do 에서 발급받습니다.

• 사용자 측 API 키 불필요 — NomaDamas hosted 프록시가 DATA_GO_KR_API_KEY, FOODSAFETYKOREA_API_KEY 보유
• self-host가 필요하면 KSKILL_PROXY_BASE_URL 환경변수로 대체

본 스킬은 NomaDamas/k-skill (MIT) 의 mfds-drug-safety와 mfds-food-safety를 통합 포팅했습니다. 공식 데이터 출처:

• 식품의약품안전처
• 식품안전나라 OpenAPI
• 공공데이터포털

• moai-content — 블로그·뉴스레터 결합 콘텐츠 마케팅
• moai-media — 추가 이미지·영상·음성 생성
• moai-marketing — SEO 감사·캠페인 기획·성과 보고
• moai-business — 사업계획서·시장조사·재무모델

• modu-ai/cowork-plugins README
• moai-commerce 디렉터리
• 채널별 공식 가이드: 쿠팡 셀러센터, 네이버 스마트스토어 센터, 카페24 매뉴얼, 와디즈 메이커 가이드, 무신사 셀러 정책 등
• NomaDamas/k-skill — MIT — mfds-drug-safety, mfds-food-safety 원본 (v2.0.0, 통합)
• 식의약 데이터 포털 (data.mfds.go.kr) — 식약처 OpenAPI 통합 진입점
• 식품안전나라 OpenAPI (foodsafetykorea.go.kr/apiMain.do) — 키 발급
• 공공데이터포털 (data.go.kr) — e약은요·안전상비의약품·부적합 식품 API