사용 설명서

프로그램 화면을 보며 따라 할 수 있는 단계별 가이드입니다.

섹션 1

마켓별 API 키 발급 (가장 먼저)

마켓에 상품을 등록·수정하거나 주문을 가져오려면 API 키가 필요한 경우가 많습니다. 프로그램에 넣기 전에, 사용 중인 마켓마다 아래 순서대로 키를 발급받으세요.

발급한 값은 설정 → 계정설정아이디키·시크릿키·업체코드에 입력합니다. (처음 해야 할 설정 참고)

한눈에 보기 — 프로그램 입력란 매핑

마켓아이디키시크릿키업체코드비고
스마트스토어애플리케이션 ID애플리케이션 시크릿네이버 커머스 API
쿠팡Access KeySecret KeyVendor IDWing Open API
11번가OPEN API KEY (32자)Seller API
옥션·G마켓불필요불필요판매자 로그인만

1. 스마트스토어 — 네이버 커머스 API

필요 권한: 스마트스토어 통합매니저 (주문 API까지 쓰려면 주문 판매자 권한도 필요)

  1. 네이버 커머스 API 센터 접속 → 스마트스토어 계정으로 로그인
  2. 처음이면 계정 생성 → 「내 스마트스토어 전용 커머스 API」 선택 후 가입
  3. 애플리케이션 → 내 스토어 애플리케이션 → 애플리케이션 등록
  4. 애플리케이션 이름·설명 입력 → API 권한에서 상품·주문 관련 API를 모두 추가 → 등록
  5. 등록한 애플리케이션 상세에서 애플리케이션 ID(아이디키)와 애플리케이션 시크릿(시크릿키) 복사
  6. 상태가 활성인지 확인 후 프로그램 계정설정에 입력

스마트스토어센터의 「API관리」(대행사용)와 커머스 API 센터의 「내 스토어 애플리케이션」은 별개입니다. SmartSellUp은 커머스 API 센터에서 발급한 ID·시크릿을 사용합니다.

2. 쿠팡 — Wing Open API

필요 조건: 사업자 인증이 완료된 쿠팡 Wing 판매자 계정

  1. 쿠팡 Wing 로그인
  2. 우측 상단 판매자명 클릭 → 판매자정보 또는 추가판매정보
  3. 상단에서 업체코드(Vendor ID, A 또는 C로 시작) 확인 → 프로그램 업체코드에 입력
  4. 하단 API Key 발급받기 → 사용 목적 OPEN API 선택 → 약관 동의
  5. 자체개발(직접입력) 선택 → 업체명·URL(없으면 wing.coupang.com)·사용 PC 공인 IP 입력 (최대 10개)
  6. 발급된 Access Key(아이디키)·Secret Key(시크릿키)를 프로그램에 입력

최초 발급 후 실제 API 접근 권한이 반영되기까지 24시간 이상 걸릴 수 있습니다. 키는 약 180일마다 재발급이 필요합니다.

3. 11번가 — OPEN API (Seller API)

  1. 11번가 OPEN API 센터 → 판매자 아이디로 로그인
  2. 상단 서비스 등록·확인 → 이용 정보 입력 후 등록
  3. 11ST OPEN API KEY [등록] 또는 Seller API 정보 수정에서 IP 등 추가 정보 입력
  4. API 관리에서 [인증하기] 완료 → API KEY 상태가 승인 완료인지 확인
  5. 발급된 32자리 API KEY를 프로그램 아이디키에 입력 (시크릿키 불필요)

키 수정·승인 후 상품 전송이 안 되면 1시간 정도 기다린 뒤 다시 시도하세요. 국내·글로벌 계정은 API KEY가 각각 따로입니다.

4. 옥션·G마켓 (ESM PLUS)

상품 등록·동기화는 판매자 아이디·비밀번호만으로 가능합니다. API 키는 넣지 않아도 됩니다.

  • 설정 → 계정설정에서 마켓·아이디·패스워드·스토어명·사업자만 등록
  • 주문 수집 API는 현재 버전에서 미지원

5. (선택) 검색광고 API — 광고관리 탭

스마트스토어 쇼핑검색 광고를 SmartSellUp에서 관리할 때만 필요합니다. 커머스 API와 별도입니다.

  1. 네이버 검색광고 → API 이용관리에서 CUSTOMER_ID·액세스라이선스·비밀키 발급
  2. 설정 → 계정설정 → 해당 스마트스토어 → 검색광고 API 입력 → 연동 테스트

자세한 사용법은 광고관리 섹션을 보세요.

6. (선택) 네이버 쇼핑검색 OpenAPI — 자동카테고리

스마트스토어·쿠팡 자동카테고리 기능에 쓰입니다.

  1. 네이버 개발자센터 → 애플리케이션 등록 → 검색 API 사용
  2. Client ID·Client Secret을 설정 → 옵션설정(또는 기타설정)에 저장

7. (선택) 도매꾹 Open API

도매꾹 탭에서 상품 검색·저장할 때 필요합니다.

  1. 도매꾹 Open API에서 API Key 발급
  2. 설정 → 기타설정 → 도매꾹 API Key 입력

8. (선택) Google Gemini API — AI SEO · 동영상제작

상품명·태그·대표이미지 등 AI SEO 메이커와, 상품 숏폼 동영상제작(대본 생성)에 필요합니다. 마켓 API와 별도이며, 설정 → 기타설정에 입력합니다.

  1. Google AI Studio · API 키 페이지 접속 → Google 계정으로 로그인
  2. 좌측 메뉴 또는 상단에서 API 키 만들기 (영문 화면: Create API key) 클릭
  3. 프로젝트를 선택하거나 새 프로젝트를 만든 뒤 계속
  4. 생성된 API 키를 복사 (한 번만 전체가 보이는 경우가 많으니 바로 저장)
  5. SmartSellUp → 설정 → 기타설정AI 사용여부 체크 → Gemini API Key에 붙여넣기 → 저장

무료 이용 한도가 있으며, Google 정책에 따라 과금·호출 제한이 바뀔 수 있습니다. API 키는 타인에게 노출되지 않게 관리하세요. 같은 키를 여러 프로그램에서 동시에 쓰면 할당량(429) 오류가 나기 쉽습니다.

프로그램 사용: SEO 메이커 · 동영상제작

8-1. (선택) Typecast API — 동영상 TTS

동영상제작 탭에서 나레이션(TTS)을 만들 때 필요합니다. 설정 → 기타설정에 Typecast API 키를 입력합니다.

발급 후 확인

  • 키 앞뒤 공백이 들어가지 않았는지 확인
  • 쿠팡은 업체코드·Access Key·Secret Key 세 가지가 모두 맞아야 함
  • 11번가는 키 길이 32자, 상태 승인 완료 확인
  • 입력 후 계정설정에서 등록 → 상품 전송 또는 상품동기화로 연동 테스트