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

API

프로그램끼리 주고받는 창구. "상품 등록해 줘" 같은 요청을 정해진 모양으로 보내면 결과를 돌려준다

API 키 · 토큰

그 창구를 쓸 수 있다는 비밀번호. 남에게 보이면 안 된다 (이 프로그램은 화면에 다시 보여 주지 않는다)

서버

늘 켜져 있으면서 요청을 받아 일을 하는 컴퓨터 (여기서는 Vultr)

DB (데이터베이스)

데이터를 표 모양으로 오래 저장하는 곳 (여기서는 Neon)

고정 IP

바뀌지 않는 인터넷 주소. 네이버가 "이 주소에서 온 요청만 받는다" 고 정해 두어 필요하다

배포 · push

고친 코드를 GitHub 에 올리는 것(push) → 서버가 새 코드로 바뀌는 것(배포)

커밋

코드를 고친 한 묶음과 그 이유를 적은 기록

확장프로그램

크롬에 붙이는 작은 프로그램. 내가 연 페이지를 읽을 수 있다

백그라운드 작업

화면과 상관없이 서버가 뒤에서 오래 하는 일 (예: 상품 8천 개 가져오기)

인페인팅

사진에서 지운 자리를 주변에 맞게 AI 가 새로 그려 채우는 것 (AI 지우개)

• 2026-10-10 방문자 수 — 상세페이지 끝에 보이지 않는 문단(방문 픽셀)을 붙여, 손님이 상세페이지를 열면 우리 서버(ilgudae.com)가 셉니다(30분 안 다시 연 것·로봇은 안 셈, PC/모바일). 등록상품·가져온 상품 줄에 "👤 n"(최근 14일), 등록상품 "방문자" 칩(많은 순). 올리거나 수정 업로드할 때 붙고, 이미 올라간 상품은 등록상품 "방문 픽셀 바꾸기"(윈들리 픽셀 → 우리 것, 상품명·가격은 그대로)로 한꺼번에. 도메인 ilgudae.com 도 이날 연결
• 2026-10-10 다른 계정도 스토어 관리에서 자기 스토어를 1개 만들 수 있다 — 만들면 그 계정에 바로 배정되고 기본 설정 → API 연결로 안내. 스토어가 없는 계정은 스토어 관리 화면만 열린다.
• 2026-10-10 왼쪽 메뉴 "스토어 관리"(관리자만) — 스토어 표(이름 바꾸기·들어갈 수 있는 계정·AI 이번 주 사용액·들어가기)·스토어 추가·계정 관리를 한 곳에. 스토어 선택 창의 "+ 스토어 추가" 와 기본 설정의 "계정" 탭은 여기로 옮겼다.
• 2026-10-10 계정 — 다른 사람과 같이 쓰되 서로 안 보이게. 로그인에 "이름" 칸(관리자는 비움), 기본 설정 → "계정" 탭(관리자만)에서 계정을 만들고 들어갈 스토어를 정한다. 상품·주문·설정·커머스API 키·Claude 키·AI 사용액이 스토어 단위로 따로이고, 사진 저장소·거절 태그 사전·키워드 검색수만 함께 쓴다. 확장프로그램 v0.44.1.
• 2026-10-10 수동 추가 서랍 손질 — 아마존·라쿠텐이 아닌 어느 쇼핑몰 주소든 "기타 쇼핑몰" 로 담긴다(뱃지는 그 사이트 이름, 상품코드 ETC-…). 사진 파일 올리기·끌어다 놓기, 재고·품절·일본 내 배송비·사양 칸, 추가하면 바로 "편집 열기". 기타 쇼핑몰 사진도 1000×1000 맞추기가 된다.
• 2026-10-07 확장프로그램 v0.44.0 — 라쿠텐 상품의 드롭다운 고르기 칸(샤프트/플렉스·로프트각·그립처럼 가격·재고가 안 바뀌는 선택지)도 옵션으로 담는다. 옵션 탭에 "고르기 칸" 표시. 조합이 500개를 넘으면 등록이 막히니 쓸 그룹·값만 남긴다.
• 2026-10-06 등록상품 "수정 업로드 대기" 칩 — 앱에서 고쳤는데 스마트스토어엔 아직 안 올린 상품(이번엔 클로드가 상품명을 고친 불스레저 118개)을 모아 전체 선택 → 수정 업로드. 올라가면 저절로 빠진다.
• 2026-10-05 확장프로그램 v0.43.0 — 요도바시 목록(카테고리·검색 결과)에서도 "⬇ 일구대 전부 담기" 와 사진 위 "일구대 담기". 라쿠텐·아마존 목록과 같은 창으로 하나씩 2초 간격으로 담는다.
• 2026-10-08 AI 가 카테고리를 비우는 것은 대개 AI 탓이 아니라 그 앞 규칙 후보 30개에 맞는 잎이 없어서다 — 아마존 공업용 계측기 칸이 사전에 없어 냉매 누출 감지기 후보가 가습기·후방감지기였다. 사전에 計測器·テスター 를 더하고, 측정 문맥이 있으면 "기타측정기" 를 후보에 넣는다.
• 2026-10-08 업로드 대기열 판에 "멈추기" — 지금 올리는 상품까지만 올리고 나머지는 "멈춤" 으로 남긴다(실패가 아니라 다시 고르면 됨). 네이버에 보내는 중인 상품을 중간에 끊으면 네이버에만 생기고 앱에 저장이 안 되므로 상품 사이에서만 멈춘다.
• 2026-10-08 수집처 품절(재고 0) 상품을 새로 등록하면 네이버가 "재고 1개 이상" 으로 거절한다 — 재고 1로 올린 뒤 곧바로 판매 상태를 품절로 바꾼다. 재입고되면 원본 새로고침 → 편집 화면 "판매중으로" → 수정 업로드.
• 2026-10-08 주문 관리 줄마다 "⧉ 장부" 단추 — 그 주문 하나의 장부용 17칸(결제일자~실수수료율)을 복사한다. 샵마인 양식 왼쪽 상자·기본 보기 메모 칸·펼친 상세에.
• 2026-10-08 일괄 작업·등록상품에 "끝자리 800원만" 단추 — 마진·배송비는 그대로 두고 판매가 끝자리만 …800원(내림) 규칙으로. 원가가 없는 상품은 직접 판매가를 내린다.
• 2026-10-05 등록상품에도 "원가 판매 + 800원" 단추 — 고른 등록상품을 마진 0%·끝자리 800원으로 바꾸고, 끝나면 바로 수정 업로드할지 묻는다.
• 2026-10-05 전체 점검 — 사고(스마트스토어 160개 삭제) 뒤 고르기·삭제·등록·일괄 작업·편집 화면·확장프로그램을 훑어 "화면에 보이는 것과 실제로 처리되는 것이 다른 곳"·"옛 값으로 덮어쓰는 곳"·"품절인데 재고가 올라가는 곳" 을 고쳤다. 확장프로그램 v0.42.1.
• 2026-10-05 배송비 추천을 PF 물류 가격표(PIEX) 기준으로 — 판매가 탭 "배대지 배송비", "배송비 확인" 표시, AI 일괄 배송비 단계가 모두 PF 요금으로 계산한다. 송장 전송 기본 택배사도 팬스타국제특송(PIEX).
• 2026-10-05 삭제 — 여러 개를 지울 때 네이버가 "요청이 많다"(429)며 막으면 쉬었다 다시 보내고, 그래도 못 지운 상품은 앱에 남긴다. 등록상품 → 네이버 전체 → "앱에 없음" 으로 스마트스토어에만 남은 상품을 찾아 지울 수 있다.
• 2026-10-05 등록상품 — 카테고리로 보기. 검색칸 옆에서 카테고리를 고르면 그 카테고리 상품만 보인다 (지금 등록상품에 있는 카테고리만, 상품 많은 순).
• 2026-10-05 확장프로그램 v0.42.0 — 사이드 패널 "상품 담기" 에 "상품명 복사 · 옵션 복사 · 전부 복사" 단추. 지금 보는 상품 페이지의 원문(일본어) 상품명과 옵션(옵션명: 값, 값)을 담지 않고도 클립보드로.
• 2026-10-04 상품 랭킹에서 고른 상품을 스마트스토어에서 삭제 — 앱의 등록상품·가져온 상품에서도 함께 지운다 (되돌릴 수 없어 두 번 묻는다).
• 2026-10-04 소싱 분석 → 상품 랭킹 "클릭 많은데 안 팔림" — 광고 클릭은 많은데 한 번도 안 팔린 상품을 클릭 많은 순으로. 1년치(검색광고는 한 번에 92일까지라 나눠 받아 더함)로 보면 된다.
• 2026-10-04 확장프로그램 v0.41.1 — 목록 담기·원본 새로고침이 광고 많은 가게 페이지에서 "30초 안에 뜨지 않았습니다" 로 실패하던 것. 페이지가 다 뜨기를 기다리지 않고 상품 정보가 읽히는 순간 담는다.
• 2026-10-04 확장프로그램 v0.41.0 — 아마존 검색 결과 화면에도 "⬇ 일구대 전부 담기" 단추. 라쿠텐 목록과 같은 창(고르기·안 담은 것만·멈추기)으로 하나씩 2초 간격으로 담는다. 광고(스폰서) 상품은 "광고" 표시.
• 2026-10-04 주문 관리 "엑셀로 받기" — 샵마인 양식 보기에서 샵마인 "통합주문관리 검색결과" 와 같은 엑셀(55칸, 클레임사유 포함)을 바로 내려받는다. "이 탭" 또는 "모든 탭". 엑셀 파일은 바깥 프로그램 없이 브라우저가 직접 만든다. 구매자 개인정보가 들어가니 다 쓰면 지울 것.
• 2026-10-02 전체 점검 — 화면: 상품 랭킹 표·주문 표가 카드 안에 들어오게, 사이드바 아래쪽 잘림, 도구줄 높이 맞춤, 떠 있는 판과 알림 겹침, 좁은 화면 메뉴·바로가기 상자, 흐린 글자 대비. 코드: 판매가 다시 계산이 상품을 통째로 덮어쓰던 것(바뀐 판매가만 저장), 새로고침해도 서버가 하던 업로드를 끝내고 꺼지게, 단위가격이 길이·샘플 용량을 읽던 것, 가져온 상품 편집 화면의 옛 값, "재패니즈" 가 "재패요구" 로 바뀌던 것.
• 2026-10-02 소싱 분석 → 판매 현황 "상품별" 표를 많이 팔린 순으로, 줄마다 "상세 고치기" 단추 — 팔린 상품부터 상세페이지 탭을 새 탭으로 열어 다듬는다. 받아 둔 주문 전체(2026-02-24~)가 대상.
• 2026-10-02 주문 관리에서 바로 원본 연결 — 샵마인 양식 왼쪽 상자의 소싱상품 칸이 "연결X" 대신 "연결" 단추. 누르고 아마존·라쿠텐 상품 주소를 붙여 넣으면 그 상품에 원본이 이어지고(가져온 상품은 등록상품으로 옮겨짐) 단추가 "라쿠텐 ↗" 처럼 바뀐다. 이미 연결된 상품은 옆의 "수정" 으로 주소를 바꾼다.
• 2026-10-02 주문 관리 샵마인 양식을 샵마인 화면과 다시 맞춤 — 배송비에 제주·도서산간 추가배송비를 더하고(전에 받은 주문은 "최근 7일 다시" 로 새로 받아야 반영), 순서를 샵마인처럼 먼저 수집된 주문이 위로. 칸 구성(54칸)은 그대로.
• 2026-10-01 광고 ON/OFF — 소싱 분석 → 상품 랭킹에서 상품마다 쇼핑검색광고를 켜고 끈다(네이버 검색광고 API). "끄기 후보"(클릭은 있는데 전환 0, 광고비 기준 이상)·"효율 낮음"·"꺼진 광고" 로 걸러 체크한 것을 한꺼번에 끌 수 있다. 입찰가·광고그룹은 그대로.
• 2026-10-01 주문 관리 "주문 취소" — 샵마인 양식의 신규주문·배송준비중 탭에서 주문을 체크하고 사유(품절·배송 지연·손님 요청)를 골라 취소한다(커머스API). 손님에게 환불되고 되돌릴 수 없어 확인창을 거친다. 발송한 뒤의 반품은 판매자센터에서.
• 2026-10-01 "품절로" 단추 — 등록상품·가져온 상품 목록에서 고른 상품의 스마트스토어 재고를 0 으로(커머스API, 가격·상세는 그대로). 품절로 바꾼 상품은 수정 업로드해도 품절 그대로이고, 편집 화면 "판매중으로" 를 누르면 재고가 돌아온다. 오늘출발 상품은 재고 0 일 때 일반배송으로 바뀐다(네이버 규칙).
• 2026-09-30 주문 관리에서 발주확인·송장 전송 — 샵마인 양식의 신규주문·배송준비중 탭에서 택배사(기본 로토스)를 고르고 노란 칸에 송장번호를 넣어(여러 줄 붙여넣기 가능) "송장 전송". 확인창을 거쳐 커머스API 로 보내고, 발주확인을 안 한 주문은 발주확인부터 한다. 보내면 배송중이 되고 손님에게 알림이 간다.
• 2026-09-30 등록상품·가져온 상품 목록의 원본 링크("라쿠텐 ↗" 글자)를 단추로 — 주문 관리 바로가기 상자와 같은 모양, 초록 N 아이콘 옆 한 줄에.
• 2026-09-30 주문 관리 샵마인 양식 왼쪽 바로가기 상자에 "✎ 수정" 단추 — 그 주문의 상품을 일구대 편집 화면으로 새 탭에서 바로 연다(주문 목록은 그대로). 이 프로그램에 없는 상품은 "—".
• 2026-09-29 서버가 새 버전으로 다시 켜질 때 하던 업로드·AI 요청을 끝내고 꺼지게 — 전에는 그 순간 올리던 상품이 끊겼다. 꺼지는 중에 들어온 요청은 "1분 뒤 다시" 로 돌려보내고, 끊긴 "업로드 중" 표시는 켜질 때 지운다.
• 2026-09-29 상품명 학습은 확인한 뒤에 — 다른 AI 의 수정 지시를 그대로 받지 않고 스토어 기존 상품·주문, 네이버 월간 검색수, 공식몰로 확인. 정글목(머렐정글목 1,040 · 정글모크 10) · 즈윌링(4,930 · 츠빌링 15) · 주방칼(4,470 · 산토쿠칼 230). 어순은 브랜드 + 대표키워드 + 라인명("머렐 슬립온 정글목 …"), 브랜드·품번은 항상 원 상품명 기준(헹켈 상품에 즈윌링을 붙이지 않음 · 품번 앞에 J 안 붙임). 품번이 글자 수 제한에 잘리지 않게.
• 2026-09-29 상세페이지의 일본식 표현 고치기 — 편발 → 한 쪽 · 사이즈 전개 → 사이즈 · 내찢김성 → 잘 찢어지지 않는 · 다이버스 → 다목적 · 니즈 → 요구 · 신발 치수 25.0cm → 250mm. 상세페이지를 그릴 때 고쳐서 이미 만든 설명에도 바로 적용(네이버 반영은 수정 업로드).
• 2026-09-29 재고·가격 동기화를 라쿠텐 API 키 없이 — 등록상품 위 "원본 전체 새로고침": 확장프로그램이 원본 페이지를 하나씩 열어(수집과 같은 방식) 재고·원가를 읽고 수정 업로드. 오래 안 맞춘 상품부터, 한 번에 300개까지.
• 2026-09-29 AI 일괄 점검 4 (헤어·머렐 신발 약 80개) — 태그: 성별이 다른 말(남성 상품에 여자등산화)·"등산화용"·병 이름(족저근막염)·다른 제형(헤어밀크에 헤어오일)·원문에 없는 특징(고어텍스·키높이·방수)·다른 상품 이름(하이드로)을 거름. 상품명: 품번은 원문 그대로(앞 글자 안 붙임)·헹켈/츠빌링·소말카·식기세척기가능. 신발 치수 22·23·24 → 220·230·240. 트레이닝화는 러닝화 카테고리로.
• 2026-09-29 AI 품질 — 골프공 수량 한 번만(12구) · 원문에 없는 방수·성별 빼기 · "직수입·병행수입·정품" 안 쓰기 · 태그에서 부속품 말(골프화깔창)·다른 브랜드(스탠리텀블러) 빼기. 일괄 작업은 서버가 잠깐 멈춰도 기다렸다 이어 감. 편집 화면 저장 단추를 보류 옆에
• 2026-09-29 원본 링크 바꾸기(수집·등록·가져온 상품 모두) · "전체 재수집"(연결된 원본 페이지에서 사진·설명·옵션·원가를 통째로 다시 — 확장프로그램 v0.40.0) · "AI 다시"(이미 만든 상품명·설명·태그를 지금 규칙으로 다시)
• 2026-09-29 판매가 탭 "스마트스토어 표시" — 가져온 상품의 정가·즉시할인·할인가(손님이 내는 값)를 한 줄로. 확장프로그램 "편집 열기" 로 들어오면 스토어를 묻지 않고 그 상품으로 바로
• 2026-09-29 가져온 상품의 즉시할인 — 앱 판매가는 손님이 내는 값. 수정 업로드 때 기존 할인이 한 번 더 먹어 싸게 올라가던 것을 고침 (할인 표시는 유지하고 정가를 올림, 기본 설정 → 업로드 설정에서 "없애기" 로 바꿀 수 있음)
• 2026-09-29 주문 관리 샵마인 양식 다시 맞춤 — 샵마인에서 긁은 줄과 값·순서를 같게(금액 쉼표·발송대기(신규주문)·택배사 한글·상품 주소·송장총주문금액), 왼쪽에 바로가기 상자(등록상품 = 네이버 상품 · 소싱상품 = 일본 상품 · 한 주문만 복사)를 따로 두어 끌어서 복사할 때 섞이지 않게
• 2026-09-28 쿠로로지(배대지) 연결 — 쿠로 종합현황 화면의 "일구대로 보내기"(확장프로그램 v0.38.0)로 국내 운송장·트래킹·무게·실제 배송비·진행상태를 주문 관리에 붙임. 쿠로는 API 가 없어 로그인된 화면을 읽는다
• 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-27 소싱 분석 "상품 랭킹" — 1주·1달·3달·6달·1년 동안 유입(광고 클릭)·전환·주문·매출이 많은 상품 순위 (검색광고 API 는 92일씩 나눠 받아 더함)
• 2026-09-27 소싱 분석 "상세페이지 진단" — 검색광고 노출·클릭·전환과 주문으로 상세페이지·대표이미지를 손볼 상품, 취소·반품 많은 상품, 잘 팔리는 상품을 골라 줌
• 2026-09-27 주문 관리 메뉴 — 스마트스토어 주문을 탭별로 보고, 일본 원본 링크·원가·예상 이익을 붙이고, 배대지용으로 수령인·주소·통관부호를 한 번에 복사 (보기 전용)
• 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 에 있습니다.