shopport 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +108 -0
- package/dist/cli.js +2 -0
- package/dist/dashboard-ui/assets/index-CNEU9OYf.css +1 -0
- package/dist/dashboard-ui/assets/index-CTf-NIWh.js +291 -0
- package/dist/dashboard-ui/index.html +13 -0
- package/dist/skills/README.md +35 -0
- package/dist/skills/inventory-sync/SKILL.md +78 -0
- package/dist/skills/order-fulfill/SKILL.md +90 -0
- package/dist/skills/price-monitor/SKILL.md +96 -0
- package/dist/skills/product-parse/SKILL.md +114 -0
- package/dist/skills/promo-research/SKILL.md +160 -0
- package/dist/skills/source-to-register/SKILL.md +85 -0
- package/dist/skills/waterfall-source/SKILL.md +73 -0
- package/package.json +52 -0
package/README.md
ADDED
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# shopport
|
|
2
|
+
|
|
3
|
+
커머스 운영 자동화 CLI — Cafe24, Coupang, SmartStore, Shopify 통합 관리
|
|
4
|
+
|
|
5
|
+
## 설치
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g shopport
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
또는 npx로 바로 실행:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npx sppt --help
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## 빠른 시작
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
# 1. 채널 credentials 설정
|
|
21
|
+
sppt init
|
|
22
|
+
|
|
23
|
+
# 2. 연결 상태 확인
|
|
24
|
+
sppt status
|
|
25
|
+
|
|
26
|
+
# 3. 채널별 기능 비교
|
|
27
|
+
sppt cap
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 명령어
|
|
31
|
+
|
|
32
|
+
### 설정
|
|
33
|
+
|
|
34
|
+
| 명령어 | 설명 |
|
|
35
|
+
|--------|------|
|
|
36
|
+
| `init` | 대화형 채널 설정 |
|
|
37
|
+
| `config list` | 현재 설정 확인 |
|
|
38
|
+
| `config get <channel>` | 채널 설정 조회 |
|
|
39
|
+
| `config set <channel> <key> <value>` | 설정 변경 |
|
|
40
|
+
| `config remove <channel>` | 채널 삭제 |
|
|
41
|
+
|
|
42
|
+
### 상품
|
|
43
|
+
|
|
44
|
+
| 명령어 | 설명 |
|
|
45
|
+
|--------|------|
|
|
46
|
+
| `product list <channel>` | 상품 목록 |
|
|
47
|
+
| `product get <channel> <id>` | 상품 상세 |
|
|
48
|
+
| `product register <channel> --file <path>` | JSON으로 상품 등록 |
|
|
49
|
+
| `product update <channel> <id> --file <path>` | 상품 수정 |
|
|
50
|
+
| `product delete <channel> <id>` | 상품 삭제 |
|
|
51
|
+
|
|
52
|
+
### 주문
|
|
53
|
+
|
|
54
|
+
| 명령어 | 설명 |
|
|
55
|
+
|--------|------|
|
|
56
|
+
| `order list <channel> [--days N]` | 최근 주문 (기본 7일) |
|
|
57
|
+
| `order get <channel> <id>` | 주문 상세 |
|
|
58
|
+
| `order confirm <channel> <id>` | 주문 확인 |
|
|
59
|
+
| `order cancel <channel> <id>` | 주문 취소 |
|
|
60
|
+
|
|
61
|
+
### 송장
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
sppt invoice register <channel> <orderId> <carrier> <trackingNumber>
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
택배사 코드: `cj`, `hanjin`, `lotte`, `post`, `logen` (또는 채널별 원래 코드)
|
|
68
|
+
|
|
69
|
+
### 재고
|
|
70
|
+
|
|
71
|
+
| 명령어 | 설명 |
|
|
72
|
+
|--------|------|
|
|
73
|
+
| `inventory sync <channel> <productId> <qty>` | 재고 업데이트 |
|
|
74
|
+
| `inventory plan <totalStock> [sku]` | 재고 분배 시뮬레이션 |
|
|
75
|
+
|
|
76
|
+
### 기타
|
|
77
|
+
|
|
78
|
+
| 명령어 | 설명 |
|
|
79
|
+
|--------|------|
|
|
80
|
+
| `status` | 전체 채널 상태 |
|
|
81
|
+
| `cap [channel]` | API 기능 현황 |
|
|
82
|
+
| `rate-test` | Rate limiter 테스트 |
|
|
83
|
+
|
|
84
|
+
## 채널별 특이사항
|
|
85
|
+
|
|
86
|
+
| 채널 | 점수 | 주의사항 |
|
|
87
|
+
|------|------|----------|
|
|
88
|
+
| Shopify | 92/100 | GraphQL, delta 재고, 80+ 웹훅 |
|
|
89
|
+
| Cafe24 | 79/100 | 2 req/s 제한, 절대값 재고 |
|
|
90
|
+
| Coupang | 54/100 | 180일 키 만료, 웹훅 없음, 050번호만 |
|
|
91
|
+
| SmartStore | 44/100 | 웹훅 없음, 재고 API 없음, 24시간 윈도우 |
|
|
92
|
+
|
|
93
|
+
## 설정 저장 위치
|
|
94
|
+
|
|
95
|
+
- 파일: `~/.shopport/config.json`
|
|
96
|
+
- 환경변수 우선: `CAFE24_MALL_ID`, `COUPANG_VENDOR_ID` 등
|
|
97
|
+
|
|
98
|
+
## MCP 서버 모드
|
|
99
|
+
|
|
100
|
+
AI 에이전트 연동이 필요한 경우 MCP 서버로도 실행 가능:
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
sppt-mcp # 또는 node dist/index.js
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
## 라이선스
|
|
107
|
+
|
|
108
|
+
MIT
|