danawa-cli

다나와 가격비교 상품 검색 CLI — AI 에이전트 친화적 설계 (Agent DX)

설치

npm install -g danawa-cli

또는 npx로 바로 실행:

npx danawa-cli search "노트북"

사용법

검색

# 기본 검색 (JSON 출력)
danawa search "노트북"

# 인간용 테이블 출력
danawa search "노트북" --format table

# 필드 선택 (토큰 절약)
danawa search "노트북" --fields productName,minPrice

# 가격 필터 + 정렬
danawa search "노트북" --min-price 1000000 --sort rating --format table

배치 검색

# 5페이지 배치 수집
danawa batch "마우스" --pages 5

# NDJSON 스트리밍 (한 줄에 한 상품)
danawa batch "마우스" --pages 3 --format ndjson | head -10

스키마 자체검사

danawa schema search    # 검색 스키마
danawa schema           # 전체 목록

HTTP API 서버

danawa serve --port 3000

# GET /api/search?q=노트북&page=1&fields=productName,minPrice
# GET /api/search/batch?q=마우스&pages=5
# GET /api/schema?resource=search

Agent DX

Agent DX 원칙에 따라 AI 에이전트를 주요 소비자로 설계되었습니다.

| 원칙 | 구현 | |------|------| | JSON-First Output | JSON 기본, --format table/compact/ndjson | | Raw Payload | --json-body, --params | | Schema Introspection | danawa schema search | | Input Hardening | 제어문자, 유니코드, 이중인코딩 거부 | | Context Discipline | --fields, --limit, 페이지네이션 | | Safety Rails | --dry-run, config 마스킹 | | Skill Files | SKILL.md 제공 |

Exit Codes

| 코드 | 의미 | |------|------| | 0 | 성공 | | 1 | 오류 |

프로그래매틱 사용

import { searchDanawa, searchDanawaBatch } from "danawa-cli";

const result = await searchDanawa({ query: "노트북", page: 1, limit: 10 });
console.log(result.items);

License

MIT