shopport

커머스 운영 자동화 CLI — Cafe24, Coupang, SmartStore, Shopify 통합 관리

설치

npm install -g shopport

또는 npx로 바로 실행:

npx sppt --help

빠른 시작

# 1. 채널 credentials 설정
sppt init

# 2. 연결 상태 확인
sppt status

# 3. 채널별 기능 비교
sppt cap

명령어

설정

| 명령어 | 설명 | |--------|------| | init | 대화형 채널 설정 | | config list | 현재 설정 확인 | | config get <channel> | 채널 설정 조회 | | config set <channel> <key> <value> | 설정 변경 | | config remove <channel> | 채널 삭제 |

상품

| 명령어 | 설명 | |--------|------| | product list <channel> | 상품 목록 | | product get <channel> <id> | 상품 상세 | | product register <channel> --file <path> | JSON으로 상품 등록 | | product update <channel> <id> --file <path> | 상품 수정 | | product delete <channel> <id> | 상품 삭제 |

주문

| 명령어 | 설명 | |--------|------| | order list <channel> [--days N] | 최근 주문 (기본 7일) | | order get <channel> <id> | 주문 상세 | | order confirm <channel> <id> | 주문 확인 | | order cancel <channel> <id> | 주문 취소 |

송장

sppt invoice register <channel> <orderId> <carrier> <trackingNumber>

택배사 코드: cj, hanjin, lotte, post, logen (또는 채널별 원래 코드)

재고

| 명령어 | 설명 | |--------|------| | inventory sync <channel> <productId> <qty> | 재고 업데이트 | | inventory plan <totalStock> [sku] | 재고 분배 시뮬레이션 |

기타

| 명령어 | 설명 | |--------|------| | status | 전체 채널 상태 | | cap [channel] | API 기능 현황 | | rate-test | Rate limiter 테스트 |

채널별 특이사항

| 채널 | 점수 | 주의사항 | |------|------|----------| | Shopify | 92/100 | GraphQL, delta 재고, 80+ 웹훅 | | Cafe24 | 79/100 | 2 req/s 제한, 절대값 재고 | | Coupang | 54/100 | 180일 키 만료, 웹훅 없음, 050번호만 | | SmartStore | 44/100 | 웹훅 없음, 재고 API 없음, 24시간 윈도우 |

설정 저장 위치

• 파일: ~/.shopport/config.json
• 환경변수 우선: CAFE24_MALL_ID, COUPANG_VENDOR_ID 등

MCP 서버 모드

AI 에이전트 연동이 필요한 경우 MCP 서버로도 실행 가능:

sppt-mcp  # 또는 node dist/index.js

라이선스

MIT