토스쇼핑 위탁판매 자동화 레시피: 도매 상품 고르기, 마진 계산, 등록, 발주

이런 사람에게 맞아요

• 상품 비교와 가격 계산을 좋아하는 사람
• 하루 한 번 주문과 문의를 볼 수 있는 사람
• 사업자등록과 통신판매업 신고를 할 수 있는 사람

돈이 들어오는 길

• 토스쇼핑 판매 수수료는 기본 8%(부가세 별도)이고 배송비, 결제에는 결제 수수료가 따로 붙어요. 정산은 구매확정 뒤 2영업일. 출처
• 첫 입점 뒤 30일은 판매 수수료가 0원이고, 광고(CPC)를 건 상품은 판매 수수료가 면제돼요. 출처

준비물

• 사업자등록, 통신판매업 신고
• 토스쇼핑 비즈니스 회원, 상점, 토스페이 신청
• 도매처 계정(도매꾹, 도매매 등)과 그 상품의 위탁 판매, 이미지 사용 허용 여부
• 입점 담당에게 확인할 것 두 가지: 위탁 상품 판매가 되는지, 판매자용 API(상품 등록, 주문 조회)를 쓸 수 있는지와 조건

자동화 순서

AI 자동으로 돌리는 칸 직접 내가 하는 칸

1. AI도매처에서 내 분야 후보 상품과 공급가를 모아요.
2. AI시중 최저가와 비교해 판매 수수료(8%와 그 부가세), 배송비, 결제 수수료, 쿠폰을 뺀 마진을 계산하고, 내가 정한 마진 하한보다 낮은 건 숨겨요.
3. AI판매 제한 상품(인증 필요, 건강기능식품 등)을 먼저 걸러요.
4. AI카테고리, 상품 정보 고시, 옵션, 썸네일로 등록 초안과 검토표를 만들어요.
5. 직접검토표를 보고 올릴 상품만 승인해요.
6. AI주문을 읽어 도매처 발주서와 송장 입력 목록을 만들어요. 실제 발주 버튼은 내가 켤 때만.
7. AI도매처 재고와 가격이 바뀌면 품절, 가격을 맞추고 매일 보고서를 남겨요.

Claude Code, Codex에게 넘길 구축 지시문

Claude Code나 Codex를 빈 폴더에서 열고 그대로 붙여 넣으세요. 공통 원칙(게시는 기본 꺼짐, 내가 승인한 것만, 키는 .env에만)이 함께 들어 있어요.

너는 내 컴퓨터에서 일하는 자동화 개발자야. 코딩을 모르는 내가 "토스쇼핑 위탁판매" 부업을 굴릴 수 있게 작업 폴더를 만들어 줘.
만들 것: 도매 위탁 상품의 후보 수집, 마진 계산, 등록 초안, 주문-발주 목록, 품절 동기화를 돌리는 자동화(기본은 연습 모드)

공통 원칙(꼭 지켜):
1. 시작하기 전에 나에게 질문을 3~5개만 해(주제, 계정 상태, 하루에 쓸 시간, 쓸 수 있는 돈). 답을 config.yaml 에 적고 시작해.
2. 지금 열린 폴더를 작업 폴더로 쓰고 그 밖은 건드리지 마(권장 위치는 ~/side-hustle/<부업 이름>, 거기서 너를 열었다고 봐). 안에 CLAUDE.md 와 AGENTS.md(같은 규칙 요약), config.yaml, .env.example, scripts/, queue/(만든 것), approved/(내가 승인한 것), done/(처리 기록), logs/, reports/ 를 만들어.
3. 스크립트는 Python 하나로 짜고 설치 명령은 README 에 적어. 매일 도는 스크립트가 글이나 대본을 쓸 때 AI를 어떻게 부를지(Claude나 OpenAI API 키, 또는 claude -p 같은 비대화 실행) 나에게 고르게 하고, 하루 비용 상한을 config 에 둬. 키가 없으면 그 단계는 내가 대화창에서 하도록 할 일 목록으로 남겨.
4. 같은 항목을 두 번 내보내지 않게 해. 항목마다 고유 id 를 주고 done/ 에 처리 기록을 남기고, 실행이 겹치지 않게 잠금 파일을 써. 응답이 애매하게 끊기면 다시 보내기 전에 먼저 조회해서 이미 처리됐는지 확인해.
5. 바깥으로 나가는 동작(게시, 예약, DM, 등록, 발주, 메시지)은 전부 기본 꺼짐이야. config 에 enabled: false, daily_limit: 0 으로 두고 내가 직접 바꿀 때만 켜.
6. 내가 approved/ 로 옮긴 것만 바깥으로 내보내. 첫 실행은 무조건 연습 모드로 끝까지 돌려 결과를 보여 줘.
7. 공식 API나 공식 화면 기능만 써. 로그인 우회, 캡차 풀기, 여러 계정 돌리기, 조회수나 팔로워 조작, 남의 게시물 자동 반응은 만들지 마.
8. API 키와 토큰은 .env 에만 두고, 화면에 출력하거나 커밋하지 마. 키가 없으면 그 단계는 건너뛰고 파일까지만 만들어.
9. 실행할 때마다 logs/ 에 한 줄(무엇을 했고 몇 건, 실패면 이유와 다음에 할 일)을 남겨.
10. 사실, 숫자, 가격에는 출처와 날짜를 달고 확실하지 않으면 "확인 필요"라고 써. 내 경험이 들어갈 자리는 [내 경험]으로 비워 둬.
11. 성과는 올린 지 24시간, 72시간, 7일 뒤 숫자를 reports/ 에 쌓고, 매주 잘된 것 1개, 안된 것 1개, 다음 주 바꿀 것 1개를 써.
12. 다 만들면 README.md 에 "매일 할 일 3줄"과 맥(launchd 또는 cron), 윈도우(작업 스케줄러) 자동 실행 거는 법을 클릭 순서로 적어 줘.

내가 준비해 줄 것(없으면 물어보고, 없는 채로 할 수 있는 데까지만):
- 다룰 상품군과 가격대
- 도매처 상품 목록(CSV 또는 API 키)
- 토스쇼핑 판매자 API를 받았으면 그 키와 문서(없으면 등록 초안 파일과 주문 CSV 정리까지만)
- 내 마진 하한(반품, 문의에 드는 시간까지 생각해 정하기)

만들 부품:
- scripts/source: 도매처 상품과 공급가, 배송비, 재고를 표로
- scripts/margin: 판매가 - 공급가 - 배송비 - 판매 수수료(8%에 부가세 10%를 더해 8.8%) - 결제 수수료(config) - 판매자 부담 쿠폰 = 예상 정산 마진. 마진 하한 아래는 제외. 세금 계산용 이익과는 따로 적기
- scripts/filter: 판매 제한 키워드와 인증 필요 품목 걸러 내기
- scripts/listing: 카테고리, 고시 정보, 옵션, 상품명(짧고 정확하게), 썸네일 초안 + 검토표
- scripts/register: approved/ 상품만 등록(config의 mode=practice 기본, live 이고 API 키가 있을 때만 실제 호출, 하루 금액과 건수 상한). API가 없으면 판매자센터에 옮겨 적기 좋은 표로
- scripts/orders: 새 주문 → 도매처 발주서와 송장 입력 목록(실제 발주는 order.enabled 일 때만)
- scripts/sync: 재고, 가격 변동 반영과 일일 보고

이 채널만의 규칙:
- 연습 모드가 기본이야. live 로 바꾸는 건 내가 config에서 직접 한다.
- 도매처가 위탁 판매를 허용하지 않는 상품, 상품 이미지 사용을 막은 상품은 올리지 마.
- 실패 응답이 200으로 와도 본문의 오류를 확인하고 멈춰.
- 온라인으로 계속 팔려면 보통 사업자등록과 통신판매업 신고가 필요해요(거래 규모가 작으면 신고가 면제되는 기준이 있어요). 내 경우는 관할 구청이나 국세청 126에 물어보세요. (출처: https://www.gov.kr)
- 토스쇼핑은 상품을 검수한 뒤 노출해요. 위탁 상품이 되는지, 판매 제한 품목이 무엇인지는 입점 담당이나 판매자 문서로 먼저 확인하세요. (출처: https://toss.im/business/shopping)
- 구매자는 보통 7일 안에 청약철회를 할 수 있어요. 위탁이라도 반품과 환불 책임은 판매자에게 있어요. (출처: https://www.law.go.kr/법령/전자상거래등에서의소비자보호에관한법률)

자동화 순서([사람]은 내가 직접 하는 칸이야. 그 칸은 자동으로 하지 말고 내가 할 일 목록으로 남겨):
1. 도매처에서 내 분야 후보 상품과 공급가를 모아요.
2. 시중 최저가와 비교해 판매 수수료(8%와 그 부가세), 배송비, 결제 수수료, 쿠폰을 뺀 마진을 계산하고, 내가 정한 마진 하한보다 낮은 건 숨겨요.
3. 판매 제한 상품(인증 필요, 건강기능식품 등)을 먼저 걸러요.
4. 카테고리, 상품 정보 고시, 옵션, 썸네일로 등록 초안과 검토표를 만들어요.
5. [사람] 검토표를 보고 올릴 상품만 승인해요.
6. 주문을 읽어 도매처 발주서와 송장 입력 목록을 만들어요. 실제 발주 버튼은 내가 켤 때만.
7. 도매처 재고와 가격이 바뀌면 품절, 가격을 맞추고 매일 보고서를 남겨요.

매일, 매주 돌리는 법

• 아침: 새 주문 발주 목록 확인 후 발주 켜기(10분)
• 자동: 품절, 가격 동기화와 보고서
• 주 1회: 안 팔리는 상품 내리고 후보 다시 뽑기

막히면 여기부터

• 검수 반려: 카테고리와 고시 정보가 맞는지 먼저 봐요. 승인 뒤엔 바꾸기 어려운 칸이 있어요.
• API가 거절: 받은 문서의 인증 방식(키, 허용 IP 등)대로 호출했는지 확인해요.
• 도매처 품절인데 주문이 왔다: 바로 구매자에게 알리고 취소해요. sync 주기를 짧게 바꿔요.

30일 계획

1. 1주: 사업자, 통신판매업 준비, 후보 50개와 마진표
2. 2주: 연습 모드 등록 초안 10개 다듬기, 다 되면 입점 신청
3. 3주: 입점되면 10개 실제 등록(첫 30일 수수료 0원 기간을 상품이 준비된 뒤에 쓰기)
4. 4주: 팔린 상품군으로 좁히고 광고는 전환이 보일 때 소액으로