대기목록

주소 넣기

기다리는 상품 0

폰에서 보내기

아이폰 · 아이패드 — 단축어 만들기 (한 번만)

단축어 앱 열기 → 오른쪽 위 +
맨 위 단축어 이름을 일구대에 담기 로
ⓘ(정보) → 공유 시트에 표시 켜기 → 받는 항목을 URL 과 텍스트만 남기기
동작 추가 → URL 콘텐츠 가져오기 를 넣고, 주소에 아래를 넣습니다
그 동작을 펼쳐서 방식 = POST
헤더 추가 — 이 서버는 비밀번호가 없어 헤더를 건너뜁니다
본문 요청 = JSON, 필드 두 개
- url (텍스트) → 값에 단축어 입력(마법봉 변수)
- title (텍스트) → 값에 단축어 입력 의 이름
완료. 이제 사파리에서 상품 페이지 → 공유 → 일구대에 담기

아마존 앱의 공유는 amzn.asia/… 짧은 주소를 줍니다. 그래도 담기지만 상품코드를 몰라 "주소 확인 필요" 로 표시됩니다 — 사파리에서 열어 공유하면 정확합니다.

안드로이드 — 홈 화면에 추가

크롬에서 이 사이트를 열고 → 메뉴 → 홈 화면에 추가
상품 페이지에서 공유 → 목록에 일구대 가 생깁니다

안드로이드 크롬은 공유 시트를 웹앱이 직접 받을 수 있어 단축어가 필요 없습니다. (아이폰 사파리는 이 기능을 지원하지 않아 단축어를 씁니다.)

어느 폰이든 — 주소 복사해서 붙여넣기

상품 주소를 복사한 뒤 이 화면 맨 위 "주소 넣기" 칸에 붙여넣으면 됩니다. 만들 것도 설치할 것도 없습니다.

개발 공부

지금 쓰는 기능이 어떤 서비스로 어떻게 돌아가는지, 새로 생긴 기능은 무엇인지 적어 두는 곳입니다.

한눈에 보기 — 상품 하나가 올라가기까지

담기 — 크롬에서 아마존·라쿠텐·라쿠텐 패션·ZOZO 상품 페이지를 열고 확장프로그램(파란 버튼·사이드 패널)을 누르면, 확장프로그램이 그 페이지에 이미 들어 있는 데이터(상품명·가격·옵션·재고·사진)를 읽습니다.
저장 — 읽은 내용을 서버(고정 IP 서버, Vultr)에 보내고, 서버는 DB(Neon)에 적어 둡니다. 사진은 1000×1000 으로 맞춰 같은 DB 에 들어갑니다.
다듬기 — 상품명·설명·카테고리·옵션·태그는 AI(Claude)가 한국 쇼핑몰 말로 바꿉니다. 사진의 일본어는 AI 지우개(Replicate)로 지웁니다.
올리기 — 서버가 네이버 커머스API 로 스마트스토어에 등록·수정합니다. 네이버는 미리 등록한 IP 에서 온 요청만 받아서 고정 IP 서버가 필요합니다.
보기 — 이 화면(웹 앱)은 서버가 보내 주는 페이지이고, 주문·판매 데이터도 커머스API 로 받아 소싱 분석에 씁니다.

쓰는 서비스 — 이름 · 하는 일 · 비용

서비스	이 프로그램에서 하는 일	비용 · 한도	키·설정 위치
Vultr (고정 IP 서버)	프로그램이 실제로 도는 컴퓨터(서울). 주소 158-247-196-241.sslip.io. IP 가 바뀌지 않아 네이버 API 를 부를 수 있다. GitHub 에 새 코드가 올라가면 5분 안에 스스로 받아 다시 켠다	월 $5	서버 안 .env (DB 주소·로그인 비밀번호)
Neon (DB)	상품·설정·사진·주문·가져온 상품이 저장되는 데이터베이스(PostgreSQL)	무료 0.5GB	DATABASE_URL
Vercel	예비 웹 주소(japan-selling.vercel.app). 지금은 들어오면 고정 IP 서버로 넘긴다. 상품 사진 주소도 여기서 나간다	무료 (하루 배포 100번)	Vercel 대시보드
GitHub	코드 보관·기록. 여기에 올리면(push) Vultr·Vercel 이 새 코드로 바뀐다. 작업 기록은 CLAUDE.md	무료	koreaj-sw/JAPAN-SELLING
네이버 커머스API	스마트스토어 상품 등록·수정·삭제·품절, 상품 목록·상세 가져오기, 주문(판매 데이터), 태그사전, 주소록, 카탈로그(카테고리 추천)	무료 (호출 IP 3개까지 등록)	기본 설정 → API 연결
네이버 검색광고 API	키워드 월간 검색수 — 태그·상품명 고를 때 참고	무료	기본 설정 → API 연결
Claude API (Anthropic)	AI 상품명·직역·설명·카테고리·옵션 한국어·태그, 확장프로그램의 일본 검색어	쓴 만큼 (상품 1개 약 50원, 사이드바에 이번 주 사용액)	기본 설정 → API 연결
Replicate (LaMa · Bria Eraser)	AI 지우개 — 사진에서 칠한 곳(글자·스티커·사물)을 주변에 맞게 새로 채운다. 빠름(LaMa)·고품질(Bria) 중 고른다	쓴 만큼 (LaMa 한 번 약 1원, Bria 는 더 비쌈) · 선불 크레딧 $5	기본 설정 → API 연결
크롬 확장프로그램 (일구대 담기)	상품 페이지 읽기·담기, 사이드 패널(일본 검색어·네이버 상품명 모으기). 웹 앱 "상품 수집" 에서 내려받는다	무료	패널 아래 "설정"
Fixie	예전에 쓰던 고정 IP 중계 — 한도가 차서 고정 IP 서버로 바꿨다(2026-09-26)	안 씀	—

기능 — 어디서 · 무엇으로

기능	어디서	해 주는 것	한 줄 설명
상품 담기	크롬 확장프로그램	확장프로그램 → 서버 → DB	아마존·라쿠텐·라쿠텐 패션·ZOZO 페이지의 상품명·가격·옵션·재고·사진을 읽어 수집상품으로
일본 검색어 만들기	사이드 패널	Claude	한국어 상품명 → 브랜드+모델명+모델넘버 일본 검색어 1개, 아마존·라쿠텐·구글JP 로 바로 검색
네이버 상품명 모으기	사이드 패널	확장프로그램 (+ Claude)	스마트스토어 목록 화면의 상품명을 모으고(AI 없음), 원하면 한꺼번에 일본 검색어로
AI 일괄	수집상품	Claude	상품명 → 설명 → 카테고리 → 옵션 → 태그를 차례로, 2개씩 동시에 (오른쪽 아래 대기열)
원본 상품명 직역	편집 화면 기본 정보	Claude	일본어 원문을 한국어로 그대로 옮겨 원본 상품명 아래에
태그	편집 화면 기본 정보	검색광고 API · 커머스API 태그사전 · Claude	검색수·태그사전으로 규칙 태그, AI 태그는 거절된 말 사전을 피한다
사진 편집 · AI 지우개	편집 화면 상품이미지·상세페이지	브라우저 캔버스 · Replicate	자르기·가리기·글자·1000×1000, AI 지우개는 칠한 곳만 새로 채움
판매가 계산	편집 화면 판매가	프로그램 계산 (AI 아님)	원가(엔)×환율+배송비+마진+수수료, 옵션가·기준 조합, 마진 0원 판매가
등록 · 수정 업로드	편집 화면 업로드 메뉴	네이버 커머스API	시험 등록(전시 안 함)·바로 등록·수정 업로드, 거절되면 이유를 배워 다시
네이버 전체	등록상품 → 네이버 전체	네이버 커머스API	스마트스토어 상품 전부 목록, 가격·재고·옵션·품절·삭제
가져온 상품	가져온 상품 메뉴	네이버 커머스API · 서버 백그라운드	기존 스마트스토어 상품을 고칠 수 있게 들여옴, 원본(아마존·라쿠텐) 연결, 다 되면 등록상품에 합치기
소싱 분석	소싱 분석 메뉴	커머스API 주문 · 검색광고 API	판매 현황·키워드 경쟁·확장 후보

용어 — 한 줄씩

API: 프로그램끼리 주고받는 창구. "상품 등록해 줘" 같은 요청을 정해진 모양으로 보내면 결과를 돌려준다
API 키 · 토큰: 그 창구를 쓸 수 있다는 비밀번호. 남에게 보이면 안 된다 (이 프로그램은 화면에 다시 보여 주지 않는다)
서버: 늘 켜져 있으면서 요청을 받아 일을 하는 컴퓨터 (여기서는 Vultr)
DB (데이터베이스): 데이터를 표 모양으로 오래 저장하는 곳 (여기서는 Neon)
고정 IP: 바뀌지 않는 인터넷 주소. 네이버가 "이 주소에서 온 요청만 받는다" 고 정해 두어 필요하다
배포 · push: 고친 코드를 GitHub 에 올리는 것(push) → 서버가 새 코드로 바뀌는 것(배포)
커밋: 코드를 고친 한 묶음과 그 이유를 적은 기록
확장프로그램: 크롬에 붙이는 작은 프로그램. 내가 연 페이지를 읽을 수 있다
백그라운드 작업: 화면과 상관없이 서버가 뒤에서 오래 하는 일 (예: 상품 8천 개 가져오기)
인페인팅: 사진에서 지운 자리를 주변에 맞게 AI 가 새로 그려 채우는 것 (AI 지우개)

기록 — 새로 생긴 기능 (최근 것이 위)

2026-09-26 요도바시(yodobashi.com) 상품 담기 — 확장프로그램 v0.34.0
2026-09-26 수집상품을 다른 스토어로 옮기기 — 일괄 작업 "다른 스토어로 옮기기" (불스레저 → 어니스트불 등, 판매가는 받는 스토어 설정으로)
2026-09-26 수집상품 보류함 — 재고가 적어 올리기 애매한 상품을 "보류" 로 옮겨 목록에서 빼 두기 (지우지 않으니 다시 담기도 막힘, "보류" 칩에서 보고 풀기)
2026-09-26 목록 "전부 담기" 창에서 이미 담은 상품을 주소만으로 바로 골라 빼기 — 안 담은 것만 담기 (확장프로그램 v0.33.0)
2026-09-26 여러 스토어 — 들어올 때 스토어 선택(어니스트불·불스레저…), 상품·기본 설정(API 키)·판매 분석이 스토어마다 따로 · 확장프로그램도 "담을 스토어" 고르기 (v0.32.0)
2026-09-26 소싱 분석 "검색광고" 탭 — 광고한 상품·키워드의 노출·클릭·광고비·전환·ROAS (네이버 검색광고 API) · 판매 현황에 주문 유입 경로별 표
2026-09-26 배대지 배송비 점검 — 사양의 무게로 배대지(패밀리) 요금을 계산해 지금 해외배송비와 다르면 "배송비 확인" 표시, 판매가 탭에서 한 번에 바꾸기·무게 직접 넣기
2026-09-26 라쿠텐 북스 수집 — 책·게임·DVD 상품 페이지에서 담기, 책이면 ISBN·출판사·저자까지 (확장프로그램 v0.31.0)
2026-09-26 아마존은 옵션·재고·가격을 전부 담고, 다시 담기는 주소의 ASIN 으로 판별 (확장프로그램 v0.30.0)
2026-09-26 라쿠텐 목록 "전부 담기" — 검색·가게 목록 오른쪽 아래 단추 → 떠 있는 상품을 체크해 하나씩 차례로 담기(사이 2초, 멈추기·이어서 담기) (확장프로그램 v0.29.0)
2026-09-26 목록 화면에서 한 상품씩 담기 — 라쿠텐 검색·아마존 목록에서 상품 사진에 마우스를 올리면 가운데 "일구대 담기" (확장프로그램 v0.28.0)
2026-09-26 사진 주소로 넣기·바꾸기 (워터마크 없는 다른 판매처 사진으로) · AI 지우개 최고품질(FLUX Fill)
2026-09-26 AI 지우개 품질 — 칠한 곳을 조금 넓혀 테두리 안 남게, 모델 고르기(빠름 LaMa · 고품질 Bria Eraser)
2026-09-26 판매가 끝자리 800원으로 (판매가 설정 단추)
2026-09-26 옵션 — 그룹 이름 옵션1·옵션2, 원본 옵션으로 되돌리기, 원본 옵션·재고 다시 가져오기 (확장프로그램 v0.27.0)
2026-09-26 사진 편집기 단축키(E·C·M·T·R·S·I) · 가리기 미리보기·사각형 옮기기·크기 · 스포이드 · AI 지우개 원형 붓
2026-09-26 옵션 값은 일본어만 한국어로(영문·숫자 그대로) · 전각 숫자 반각으로
2026-09-26 개발 공부 메뉴 — 이 페이지
2026-09-26 AI 지우개 — 편집기에서 칠한 곳을 Replicate LaMa 로 지움
2026-09-26 라쿠텐 패션 · ZOZOTOWN 담기 (확장프로그램 v0.26.0)
2026-09-26 가져온 상품 메뉴 — 스마트스토어 상품 전부를 고칠 수 있게 들여오기, 수정 업로드는 상품명·가격·이미지·상세만
2026-09-26 원본 연결 · 연결X 표시 — 가져온 상품에 아마존·라쿠텐 원본 주소 달기
2026-09-26 원본 상품명 직역 · 마진 0원 판매가 · 거절된 태그 사전을 AI 태그에도
2026-09-26 확장프로그램 사이드 패널 — 일본 검색어(최고의 1개), 네이버 상품명 모으기, 구글JP 링크
2026-09-26 고정 IP 서버(Vultr)로 옮김 · Vercel 로 들어오면 넘김
2026-09-26 네이버 전체 상품 관리 (가격·재고·옵션·품절·삭제)

새 기능이 생길 때마다 위 "기능" 표와 이 기록에 한 줄씩 더합니다. 자세한 개발 기록은 GitHub 의 CLAUDE.md 에 있습니다.

기본 설정

판매가

환율 (1엔)

원

마진

해외배송비 (배대지)

원

스마트스토어 수수료

판매가 단위 (올림)

원

판매가에 관세·부가세 반영

반영 방식 관세율 품목(HS코드)별

면세 기준

달러

달러 환율 면세 기준 계산용

원

배송·반품

택배사 배송비 유형 기본배송비

원

배송비 결제방식 조건부 무료 기준금액

원

수량별 부과 기준 몇 개마다

개

반품배송비 (편도)

원

교환배송비 (왕복)

원

재고수량

개

제주 추가 배송비

원

제주 외 도서산간 추가 배송비

원

출고지 · 반품지 판매자센터 주소록에서 고릅니다 (API 등록)

출고지 반품·교환지

커머스API 는 배송비 템플릿을 지원하지 않아, 위 칸 값과 출고지·반품지가 그대로 올라갑니다.

구매대행은 출고지가 해외(일본)여야 합니다. 판매자센터에서 해외 출고지를 만든 뒤 "네이버에서 출고지·반품지 가져오기"로 고르세요.

상품 정보·A/S

원산지 수입사 상품상태 A/S 전화번호

A/S 안내 판매자 특이사항

보유한 영업 등록 등록했으면 체크 (그 품목 경고가 꺼집니다)

화장품책임판매업 (화장품) 수입식품등 인터넷 구매대행업 (식품·건강기능식품·식기류)

업로드 설정

표기

관부가세 미성년자 구매

리뷰 포인트 0 이면 안 줌

텍스트 리뷰

원

포토·동영상 리뷰

원

한달사용 텍스트 리뷰

원

한달사용 포토·동영상 리뷰

원

알림받기 동의 고객 리뷰

원

네이버가 거절한 태그 낱말 등록 때 거절되면 저절로 더해집니다 · 이 낱말이 든 태그는 "거절됨" 으로 표시하고 자동 태그에서 뺍니다

낱말 (쉼표나 줄바꿈으로 구분)

상세페이지 공통

공통 이미지에 이미 들어 있는 고지 이미지로 넣어 둔 고지는 체크

해외구매대행 안내 배송 소요 기간 관부가세 안내 반품·교환 제한 안내 개인통관고유부호 안내

상단 문구 하단 문구

상단 공통 이미지 문구보다 위

인터넷 주소로 넣기 (줄마다 하나)

하단 공통 이미지 문구보다 아래

인터넷 주소로 넣기 (줄마다 하나)

상세페이지이미지 장수 상품이미지 앞에서부터

장

API 연결

스마트스토어 커머스API 미설정

키 발급: 커머스API센터

Client ID Client Secret

고정 IP 중계 주소 (Fixie) 웹(Vercel)에서 등록하려면 필요합니다. 만드는 법은 아래 "IP 오류가 날 때".

IP 오류가 날 때 ("호출이 허용되지 않은 IP")

커머스API센터는 애플리케이션에 적은 API호출 IP 에서 온 요청만 받습니다. 웹 주소(Vercel)에서 누르면 네이버를 부르는 것은 Vercel 서버인데, 이 서버는 부를 때마다 IP 가 바뀌어 등록할 수 없습니다.

① 고정 IP 중계 (추천 · 웹에서 그대로) — 네이버로 가는 요청만 Fixie 를 거쳐 늘 같은 IP 2개로 나가게 합니다. 처음 한 번만 하면 그다음부터는 웹에서 등록 단추만 누르면 됩니다.

usefixie.com 가입 → 무료 등급(Tricycle)으로 프록시 만들기 (지역은 US·EU 중 아무거나)
Fixie 화면의 Proxy URL(http://fixie:…@….usefixie.com:80)을 통째로 복사해 위 "고정 IP 중계 주소" 에 붙여 넣기
Fixie 화면의 Outbound IPs 2개를 커머스API센터 애플리케이션 "API호출 IP" 에 적기 (최대 3개까지 적을 수 있어 1칸이 남습니다)
연결 확인 → "커머스API 에 연결됐습니다 (고정 IP 중계를 거쳐)" 가 나오면 끝

무료 등급 한도는 한 달에 요청 500번 · 100MB 입니다. 상품 1개 등록에 요청 2번(상품이미지·상품) + 한 번 누를 때마다 토큰 1번이고, 대표이미지·상품이미지 10장(1000×1000)이 약 1~1.5MB 라 용량이 먼저 차서 한 달 70개 안팎까지 올릴 수 있습니다. 75% 가 되면 Fixie 가 메일을 보내고, 다 쓰면 등록이 "중계가 거절했습니다(407)" 로 실패합니다 — 다음 달에 풀리거나 유료 등급으로 올리면 됩니다.

② 내 PC 에서 켜기 (예비) — 중계 없이 집 IP 로 부릅니다. 집 IP 가 바뀌면 다시 적어야 합니다.

PC 의 프로그램 폴더를 최신으로 받기 (git pull, 또는 GitHub 에서 ZIP) — 폴더에 시작.bat 이 있어야 합니다
시작.bat 더블클릭 → DATABASE_URL> 에 주소를 붙여 넣고 Enter (Vercel → Settings → Environment Variables, 가려져 있으면 Neon 콘솔 → Connect). 연결을 확인한 뒤에만 .env 에 저장합니다
브라우저가 열리면 여기서 연결 확인 → "이번에 부른 IP" 를 "API호출 IP" 에 적기

그다음부터는 시작.bat 더블클릭 → 열린 화면에서 등록. 검은 창을 닫으면 꺼집니다. PC 에서 켤 때도 위 중계 주소가 저장돼 있으면 중계를 거칩니다.

네이버 검색광고 API (AI 상품명 키워드) 미설정

키 발급: 네이버 검색광고 → 광고 시스템 → 도구 → API 사용 관리 (무료 · 광고비 없이 가입만)

고객 ID (CUSTOMER_ID) 액세스라이선스 비밀키

상품을 새로 담을 때 태그 10개 자동으로 넣기 (요금 없음 · 이 API 가 없으면 낱말 사전으로)

AI 지우개 (Replicate) 미설정

사진 편집기 "AI 지우개" — 칠한 곳(일본어 글자·스티커·사물)을 주변에 맞게 지웁니다. 토큰 발급: Replicate → API tokens (결제 수단 등록 필요 · 한 번 약 1원)

API 토큰

Claude API (AI 번역·설명·카테고리) 미설정

키 발급: Anthropic 콘솔

API 키 기본 모델 카테고리·옵션 번역·태그

상품명 모델 비우면 기본 모델 설명 모델 비우면 기본 모델

상품명·설명은 외래어 표기(타월·제트스트림)와 규칙을 잘 지키는 Sonnet 을 권합니다 — 상품 1개에 약 50원(Haiku 는 약 25원).

주간 한도 (달러) 넘으면 빨갛게 알리기만 하고 막지는 않습니다 · 0 = 없음

이번 주 Claude API 사용액읽는 중…

월요일 00시부터 이 프로그램이 부른 AI 비용을 더한 값입니다 (Anthropic 콘솔의 청구 금액과 몇 % 차이가 날 수 있습니다). 남은 크레딧은 "바로가기 → Claude API 결제" 에서 봅니다.

상품을 새로 담을 때 AI로 상품명·설명·카테고리·옵션 한국어(남은 칸) 자동 지정 (재수집·이미 담은 상품은 건드리지 않습니다. 옵션 한국어는 사전으로 먼저 채우고 남은 칸만 AI 에게 묻습니다. 카테고리는 확신이 없으면 비워 둡니다. 담을 때마다 비용이 듭니다)

연결 상태

백업 · 되살리기

이미지 파일은 들어가지 않습니다 (주소만).

19일구대

가져온 상품