도매꾹 상품을 쇼피·Qoo10에 자동 등록하는 AI 에이전트
왜 만들었나
쇼피는 이미지·영상·속성·사이즈차트·상세설명이 충실한 상품을 검색과 추천에 더 노출합니다. 이 항목들이 비어 있으면 상품 품질 점검에서 '개선 필요'로 남고, 노출 기회를 잃습니다. Qoo10 재팬은 일본어 상세페이지가 필요하고, 효능 과장 표현이 있으면 薬機法(의약품 의료기기 등법) 위반으로 등록이 반려됩니다.
쇼피가 상품 품질 점검에서 보는 항목과, 월드메이트가 등록할 때 채우는 방식 (wmagent.kr)
도매꾹에서 공급받은 상품이나 스마트스토어·쿠팡·카페24에서 판매 중인 내 상품을 해외 마켓에 올리려면, 판매자가 직접 이 모든 항목을 준비해야 했습니다. 월드메이트(wmagent.kr)는 이 과정을 자동화하는 AI 에이전트로, 예주아가 직접 개발·운영하고 있습니다.
월드메이트(wmagent.kr) — 도매꾹 상품과 내 상품을 쇼피·Qoo10에 함께 올립니다
어떻게 동작하나
1. 상품 가져오기
도매꾹에서 담은 상품이나 스마트스토어·쿠팡·카페24에서 판매 중인 내 상품을 API로 가져옵니다. 각 채널은 조회만 하므로 원본 상품에 영향을 주지 않습니다.
도매꾹을 둘러보다가 바로 담을 수도 있습니다. 전용 크롬 확장 프로그램을 설치하면 도매꾹 상품 상세 페이지 오른쪽 아래에 "앱에 담기" 버튼이 생기고, 누르면 그 상품이 월드메이트의 수집 상품에 담깁니다. 확장 프로그램은 화면을 긁지 않고 상품 주소만 보내며, 실제 상품 정보는 서버가 도매꾹 공식 Open API로 가져옵니다(셀러 본인의 API 키 사용). 여러 상품을 한꺼번에 담을 때는 월드메이트 화면의 도매꾹 검색을 씁니다.
2. 사실 시트
상세페이지 이미지와 상품정보에서 소재·치수·특징을 읽어 정리합니다. 상세설명·속성·사이즈차트는 사실 시트 안에서만 만들고, 근거가 없는 항목은 비워둡니다.
예를 들어 "S925 실버 진주 8mm 귀걸이" 상품이라면, 소재는 S925, 진주 지름은 8mm, 고리 지름은 12.5mm처럼 확인된 내용만 정리합니다.
상세페이지에서 읽은 사실만 시트로 정리하고, 그 범위 안에서 상세·속성·사이즈 차트를 채웁니다
3. 사진 보강
상세페이지에서 실사진을 추출하고, 흰 배경 컷·정보 카드·작은 이미지 확대를 거쳐 갤러리 9장을 만듭니다. 모든 이미지는 1:1 비율, 1024px 이상으로 맞춥니다.
AI 이미지나 영상은 원본과 색·모양을 대조해 다르면 버리고, 사용한 크레딧을 환불합니다.
4. 상품 영상
슬라이드 영상과 AI 착용 장면 영상을 생성합니다.
5. 쇼피 글로벌 상품 등록
쇼피 글로벌 상품으로 API 등록하면 SG·MY·PH·TH·TW·BR·MX 등 국가별 상점에 현지어로 퍼집니다. 쇼피 자동번역 상품명의 오역이나 효능 표현을 현지 검색어로 점검해 수정합니다.
6. Qoo10 재팬 등록
일본어 제목·기획형 상세(비교표·스펙·FAQ)·薬機法 표현 점검을 거쳐 상품을 준비합니다. 원가·배송비·수수료·마진율을 고려해 엔화 판매가를 계산하고, QSM API로 등록합니다. 쇼피용 이미지와 영상을 재사용합니다.
Qoo10 재팬용 일본어 상세와 薬機法 표현 점검 예시 (wmagent.kr)
7. 등록 후 관리
상품 수정 사항을 반영하고, 도매꾹에서 품절이나 원가 상승이 발생하면 메일로 알립니다. 이 경우 쇼피 재고를 0으로, Qoo10은 판매중지 상태로 자동 변경합니다. 새 주문이 들어오면 메일로 알리고, 출고 목록을 제공합니다. 시장가 비교 기능도 제공합니다.
기술 구성
월드메이트는 웹 앱 하나가 화면, 마켓 연동, AI 작업, 정기 감시를 모두 처리하는 구조로, AWS 서울 리전에서 운영합니다.
| 구분 | 사용 기술 |
|---|---|
| 백엔드 | Node.js + TypeScript, Express, tRPC(입력 검증 zod) |
| 프론트엔드 | React + Vite, Tailwind CSS, Radix UI(shadcn), TanStack Query |
| 데이터베이스 | MariaDB + Drizzle ORM |
| 이미지·영상 처리 | Python(rembg 배경 제거, PIL 정보 카드·사이즈표·자막), ffmpeg(이미지 확대·영상 렌더) |
| 인프라 | AWS 서울 리전(서버, S3 이미지 저장소, CloudFront), PM2 무중단 재시작, 직전 버전으로 즉시 되돌릴 수 있는 배포 |
| 작업 처리 | 별도 큐 서버 없이 DB 테이블을 작업 큐로 사용(이미지 보완·영상 생성·시장가 확인 등), 주문 동기화 15/60분·품절 감시 6시간 주기 작업 |
작업마다 맞는 AI를 나눠 씁니다
모든 AI 호출은 자체 AI 게이트웨이 한 곳을 거쳐 원가를 기록하고, 장애가 나면 다른 모델로 자동 대체합니다.
| 작업 | 모델 / 방식 |
|---|---|
| 상품명·옵션 번역, 쇼피 영어 상세·속성, Qoo10 카테고리 분류 | OpenAI GPT 경량 모델 |
| 사실 시트 추출(상세 이미지 판독), 생성 이미지 검수, 국가별 상품명 점검 | Google Gemini Flash |
| Qoo10 일본어 상세 기획·카피 | Anthropic Claude Sonnet 계열(일본어 카피 품질 때문에 선택, HTML 조립은 코드가 담당) |
| 상품 이미지 생성 | Google Gemini 이미지 모델 |
| 프리미엄 상품 영상 | AWS Bedrock Amazon Nova Reel |
| 기본 영상, 이미지 확대, 정보 카드 | AI 없이 ffmpeg·PIL로 처리 |
연동하는 외부 API는 쇼피 Open Platform, Qoo10 QSM, 도매꾹 Open API, 네이버 커머스API, 쿠팡 Wing, 카페24 Admin API입니다. 다른 쇼핑몰 연동은 상품을 가져오기만 하고 아무것도 바꾸지 않습니다.
요금
크레딧제로 운영됩니다. AI 이미지·영상 생성, 시장가 확인 기능만 크레딧을 차감하고, 번역이나 카테고리 분류는 차감하지 않습니다. 14일 무료 체험 시 500 크레딧을 제공합니다.
| 요금제 | 월 요금 (VAT 별도) | 월 등록 한도 | 매달 크레딧 |
|---|---|---|---|
| Free | 무료 (14일 체험) | 체험 누적 3개 | 500 (체험) |
| Basic | 39,000원 | 500개 | 2,000 |
| Premium | 99,000원 | 3,000개 | 8,000 |
크레딧이 모자라면 충전할 수 있고, 충전 크레딧은 1년간 유효합니다(1,000 크레딧 10,000원 · 5,000 크레딧 45,000원 · 10,000 크레딧 85,000원 · 20,000 크레딧 160,000원). 차감 예시는 AI 생성 이미지 40, 기본 영상 100, 프리미엄 영상 900 크레딧입니다. 카드 등록 없이 체험을 시작할 수 있고, 최신 요금은 wmagent.kr에서 확인할 수 있습니다.
기술적으로 공들인 부분
AI가 지어내지 못하게 막기
- 사실 시트 범위 제한: 상세 이미지에 적혀 있거나 보이는 것만 뽑고, 효능·인증·수상·순위 같은 항목은 코드가 한 번 더 버립니다. Qoo10 상세는 소구점마다 근거가 된 사실 시트 문구를 함께 내게 하고, 근거가 없으면 그 소구점을 뺍니다.
- 원본 대조 검수: AI가 만든 이미지를 원본 사진과 함께 다시 AI에 보여 같은 상품인지, 없던 물건이 생겼는지, 글자가 깨졌는지 판정받고 통과한 것만 씁니다. 떨어지면 사유를 넣어 한 번 더 만들고, 그래도 떨어지면 크레딧을 돌려줍니다.
- 라벨이 중요한 상품은 다시 그리지 않기: 화장품처럼 라벨이 중요한 상품은 실물 사진을 오려 AI가 그린 빈 배경 위에 얹습니다. 이미지 AI가 작은 라벨 글자를 깨뜨리는 것이 검수 탈락의 대부분을 차지했기 때문입니다. 브랜드 상품은 AI 이미지를 아예 만들지 않습니다.
쇼피 국가 상점마다 "진짜 올라갔는지" 확인하기
쇼피가 추천하는 1순위 카테고리가 일부 국가 상점에는 없는 경우가 있습니다(예: 귀걸이 카테고리가 말레이시아·브라질 상점에 없음). 그래서 연결된 국가 상점에 가장 많이 있는 후보를 고르고, 없는 나라는 그 상점의 추천 카테고리로 바꿔 발행합니다. 발행 결과도 직접 확인해서 실제로 올라간 상점만 성공으로 셉니다.
일본 시장 규칙 맞추기
일본어 상세의 모든 문장에 薬機法 치환표(美白→透明感 등)를 적용하고, 본문에 한글이 섞이면 다시 쓰게 합니다. 옵션 가격은 판매가와 같은 수수료·환율로 엔화 환산해 10엔 단위로 맞추고, Qoo10의 "옵션가는 판매가의 ±50% 이내" 규칙에 맞게 조정합니다. 환율은 하루 단위로 갱신하고 비정상 값은 버립니다.
영상에서도 비슷한 일이 있었습니다. 영상 AI가 시간이 지날수록 상품 색을 바꿔 그리는 경향이 있어(은색 고리가 4초 이후 금색으로 바뀜), 앞 3.5초만 쓰고 그 구간의 금속 색까지 따로 검사합니다.
개발 과정
git 기록 기준으로 2026년 9월 9일부터 10월 15일까지 약 5주 동안 161개의 커밋으로 지금의 모습이 됐습니다. 쇼피·Qoo10 기본 등록 기능은 그 이전에 만들어 둔 상태에서 시작했습니다.
| 날짜 | 내용 |
|---|---|
| 9월 9일 | git 기록 시작 (쇼피 엑셀·글로벌 API 등록, Qoo10 기본 모듈) |
| 9월 21일 | 자격증명 암호화, 도매꾹 품절 감시와 Qoo10 자동 판매중지, 환율 자동 갱신 |
| 9월 22일 | 3천 줄짜리 서버 라우터를 도메인별 14개 모듈로 분리 |
| 10월 10일 | SaaS 전환: 크레딧, 결제, 작업 큐, 원가 기록, 관리자 기능 |
| 10월 11~12일 | 상품 영상 생성(기본 + 프리미엄), 사이즈표 자동 생성, 국가별 상품명, 기획형 일본어 상세 |
| 10월 13일 | 출시 전 보안·결제 점검, 실측 원가 기반 크레딧 단가, 도매꾹 없이 내 상품 직접 등록 |
| 10월 15일 | 스마트스토어·쿠팡·카페24 상품 가져오기, 출고 목록, AI 도움말 챗봇 |
기억에 남는 버그
- 쇼피 발행 "허위 성공": 실제로는 한 곳에도 올라가지 않은 상품이 "8개국 발행"으로 보였습니다. 비동기 발행을 짧게만 기다리고 '처리 중'을 성공으로 센 것이 원인이었습니다. 결과를 충분히 확인하고 확정된 성공만 세도록 고쳤습니다.
- 토큰 갱신 후 주문 조회 끊김: 머천트 토큰을 갱신하면 상점 주문 동기화가 끊겼습니다. 상점과 머천트가 토큰 하나를 같이 쓰고 있었기 때문입니다. 토큰을 따로 받아 저장하고, 한쪽 갱신이 실패해도 다른 쪽은 계속 돌게 분리했습니다.
비슷한 고민이 있다면
해외 마켓 진출을 고민하지만 상세페이지 준비, 다국어 번역, 법규 점검이 부담스럽다면 월드메이트를 체험해 보세요. 14일 무료 체험으로 도매꾹 상품이나 내 상품을 쇼피·Qoo10에 올려볼 수 있습니다.
댓글
댓글 쓰기