# 명령줄 도구 (Beta)

API 를 터미널에서 입력하는 명령으로: 개발자는 엔드포인트를 시험하고, 스크립트는 `--json` 을 파이프로 넘기고, AI 코딩 에이전트는 MCP 설정 없이 씁니다. 명령을 게이트웨이 호출로 번역할 뿐이며 **인증·권한·속도 제한은 게이트웨이 한 곳**에 있습니다.

> CLI 는 베타입니다: 명령은 기능 카탈로그를 따르며 아직 바뀔 수 있습니다. 문제가 있으면 담당자에게 알려주세요.

## 설치

macOS / Linux:

```bash
curl -fsSL https://connect.everugg.net.au/cli/install.sh | sh
```

Windows (PowerShell):

```powershell
irm https://connect.everugg.net.au/cli/install.ps1 | iex
```

단일 바이너리, Node 나 Python 불필요. 설치 후 `ever --help`. 게이트웨이 주소는 로컬 설정에 기록되며 `ever config base <url>` 로 바꿀 수 있습니다.

## 3단계

먼저 공개 샌드박스(데모 데이터, 실제 재고는 건드리지 않음):

```bash
ever login --sandbox
ever whoami
ever stock changes AU --since 0
```

그다음 내 채널(시크릿은 토큰 교환 시에만 전송되며 0600 권한 설정 파일에 보관, `--no-save-secret` 로 저장 안 함):

```bash
ever login --channel 100780
ever stock sku AU OB0021611
ever order create --file order.json --confirm
ever stock changes AU --since 51204 --json | jq '.data | length'
```

쓰기(주문 등)는 기본이 미리보기이며 `--confirm` 을 붙여야 전송되고, **항상 초안**으로만 생성되어 ERP 에서 사람이 확인합니다. `--json` 은 봉투를 그대로 출력해 `jq` 와 스크립트에 쓰기 좋습니다.

## AI 코딩 에이전트용

Claude Code, Cursor 같은 도구는 이미 터미널을 씁니다. `ever` 만 설치하면 스스로 재고를 조회하고 문서를 읽습니다. `ever tools --json` 은 호출 가능한 도구(권한에 맞게 축소, MCP 와 같은 이름)를, `ever docs <tool>` 은 해당 엔드포인트의 Markdown 문서를 출력합니다.

```bash
ever tools --json
ever docs stock_changes
ever call stock_changes --warehouse_code AU --since 0 --json
```

## 명령 목록

명령은 게이트웨이 **기능 카탈로그**(`/tools.json`)에서 오며 시작 시 받아 1시간 로컬 캐시합니다 — 카탈로그가 바뀌어도 CLI 를 다시 배포할 필요가 없습니다. `ever call <tool> --파라미터 값`; 자주 쓰는 것은 단축형이 있습니다: `ever stock changes AU --since 0`, `ever stock sku AU OB0021611`, `ever order get <주문번호>`.

- `ever call warehouse_list` — 창고 목록: 코드, 이름, 국가, 소속 회사, 합계 뷰/실물 여부, 출고 가능 여부, 통화
- `ever call stock_list` — 한 창고의 재고(도매가/소매가/가용 수량)
- `ever call stock_changes` — 창고 재고 증분 변경: since=지난번 받은 version 을 넘기면 그 이후 변경된 행만 반환; has_more=true 면 새 version 으로 다시 호출; needs_full_sync=true 면 since 가 너무 오래되어 전체를 한 번 받아야 합니다
- `ever call product_list` — 한 창고의 상품 목록(스타일 코드 기준 중복 제거, 가격 포함)
- `ever call product_get` — 스타일 코드로 상품 상세: 이미지/설명/소재/가격 및 모든 변형(skus)
- `ever call sku_get` — SKU 로 단일 변형 상세(객체 하나)
- `ever call dropship_product_list` — 드롭쉬핑 시스템 판매 중 상품 목록(페이지)
- `ever call price_list` — 내 채널의 상품 가격(페이지)
- `ever call shipping_method_list` — 계정에서 사용할 수 있는 배송 방식(자가 수령 / Ever 배송 / 택배…)
- `ever call carrier_list` — 계정에서 선택 가능한 물류사; 도매 주문에서 carrier_id 는 선택 사항입니다
- `ever call address_list` — OMS 에 저장된 배송지 주소록
- `ever call order_create` (쓰기) — 도매 주문 생성
- `ever call feed_products` — 상품 피드 생성(Google Merchant 규격, 대량 내보내기 겸용)
- `ever call feed_status` — 상품 피드 생성 진행 상태 확인: 생성 중 / 완료 / 실패(사유 포함) 및 최신 결과물 정보
- `ever call order_list` — 기간 내 내 채널의 도매 주문
- `ever call order_get` — 주문번호로 도매 주문 상세(본인 채널만)
- `ever call order_cancel` (쓰기) — 도매 주문을 취소하고 잡고 있던 재고를 해제합니다
- `ever call dropship_order_cancel` (쓰기) — 대행 건을 취소하고 잡고 있던 재고를 해제합니다
- `ever call order_allocation_preview` (쓰기) — 도매 배정 미리보기: 행별로 배정 가능 수량, 부족 수량(quantity_owed), 예약 배치 입고일, 결제 금액과 잔액 충분 여부를 알려줍니다
- `ever call order_submit` (쓰기) — 도매 주문 제출(이후 명세 변경 불가)
- `ever call dropship_order_allocation_preview` (쓰기) — 대행 사전배정: 일련번호를 한 번에 보내면 건별로 배정 가능 여부, 부족 수량, 결제 금액을 알려줍니다
- `ever call dropship_order_submit` (쓰기) — 대행 건 제출(이후 변경 불가)
- `ever call dropship_order_allocation_cancel` (쓰기) — 제출하지 않기로 한 사전배정이 잡고 있는 재고를 해제합니다
- `ever call dropship_order_create` (쓰기) — 드롭쉬핑 주문 생성(주문당 SKU 하나)
- `ever call dropship_order_list` — 내 채널의 드롭쉬핑 주문: 창고 + 기간으로 조회하거나 client_order_number / serial_number 로 한 건 찾기
- `ever call dropship_order_summary` — 드롭쉬핑 주문 요약 목록(페이지)
- `ever call dropship_order_get` — 주문번호로 드롭쉬핑 주문 상세(본인 채널만)
- `ever call shipment_list` — 내 채널의 출고 목록
- `ever call shipment_get` — 출고번호로 출고 상세(본인 채널만)
- `ever call shipment_tracking` — 배송 추적(Auexpress)
- `ever call reservation_list` — 내 채널의 재고 예약(잠금 재고)
- `ever call reservation_get` — 예약번호로 예약 상세(본인 채널만)
- `ever call balance_list` — 계정 잔액(호주 / 중국 / 뉴질랜드 중 보유한 계정)
- `ever call transaction_list` — 거래 내역(충전 / 결제 / 환불)과 각 거래 후 잔액; amount_total 은 이 페이지 합계입니다
- `ever call bill_list` — 창고·월별 월간 청구서(결제 여부 포함)
- `ever call refund_list` — 환불 전표(도매 / 대행)와 심사 상태·사유
- `ever call freight_bill_list` — 운임 전표(물류사, 운송장 번호, 박스 수, 금액)
- `ever call cart_get` — 계정의 장바구니
- `ever call cart_put_items` (쓰기) — 장바구니 항목 추가/수정(멱등)
- `ever call cart_delete_item` (쓰기) — 장바구니에서 SKU 하나 제거
- `ever call cart_delete_product` (쓰기) — 한 스타일의 모든 SKU 를 장바구니에서 제거

어떤 엔드포인트든 `ever api <METHOD> <path> --query k=v --body <json>` 으로 직접 호출; `ever whoami` 는 신원과 권한; `ever login --sandbox` 는 샌드박스로 전환.

## 수동 다운로드

- https://connect.everugg.net.au/cli/dl/ever-linux-x64
- https://connect.everugg.net.au/cli/dl/ever-darwin-arm64
- https://connect.everugg.net.au/cli/dl/ever-linux-arm64
- https://connect.everugg.net.au/cli/dl/ever-windows-x64.exe
- https://connect.everugg.net.au/cli/dl/ever-darwin-x64

---
Markdown 원본: https://connect.everugg.net.au/cli.md?lang=ko · 웹 페이지: https://connect.everugg.net.au/cli?lang=ko