clishop

CLISHOP은 오픈소스 CLI로, AI 에이전트와 인간이 여러 스토어에서 제품을 검색하고, 가격을 비교하며, 실제 주문까지 터미널에서 모두 처리할 수 있게 해줍니다. 누구나 Dark Store를 사용하여 CLISHOP에서 판매할 수 있습니다.

호환 가능

Related MCP server: BopMarket MCP Server

주요 기능

• 하나의 검색어로 네트워크 내 모든 스토어를 검색합니다. 결과는 실제로 배송 가능한 주소 기준으로 필터링됩니다.

• 주문당 지출 한도를 설정하고, 배송 전 이메일 확인을 요구하거나, 자동으로 처리하도록 설정할 수 있습니다.

• 46개의 도구를 갖춘 네이티브 MCP 서버로 제공됩니다. VS Code Copilot, Claude, Cursor, Windsurf 및 MCP를 지원하는 모든 도구와 호환됩니다.

• 원하는 상품을 찾을 수 없나요? 광고 요청을 게시하고 판매자들이 경쟁하여 주문을 처리하도록 하세요.

• 고객 지원 티켓, 제품 리뷰, 스토어 리뷰 등 모든 것을 터미널에서 처리할 수 있습니다.

• 누구나 Dark Store를 배포하여 CLISHOP에서 판매할 수 있습니다. 웹사이트가 필요 없습니다.

설치

Node.js ≥ 18이 필요합니다. macOS, Windows, Linux/WSL에서 작동합니다.

npm install -g clishop

이 명령어는 clishop(CLI)와 clishop-mcp(AI 에이전트용 MCP 서버) 두 가지를 제공합니다.

OpenClaw

ClawHub 패키지가 게시되면 다음 명령어로 CLISHOP을 OpenClaw 워크스페이스에 설치할 수 있습니다:

openclaw plugins install clawhub:clishop

번들은 skills/clishop/SKILL.md 아래에 CLISHOP 스킬을 노출하고, 패키징된 MCP 기본값을 .mcp.json과 병합하여 OpenClaw가 시작 시 npm 코드를 가져오지 않고도 번들된 CLISHOP MCP 런타임을 로컬에서 실행할 수 있게 합니다.

Linux / WSL

CLISHOP은 Linux와 WSL에서 즉시 작동합니다. 네이티브 키체인이 없는 시스템에서는 토큰이 제한된 권한으로 로컬 파일(~/.config/clishop/auth.json)에 저장됩니다.

네이티브 키체인 지원을 원하는 경우(선택 사항):

sudo apt install libsecret-1-0

clishop doctor를 실행하여 시스템 호환성을 확인하세요.

소스에서 설치

git clone https://github.com/DavooxBv2/CLISHOP.git
cd CLISHOP
npm install
npm run build
npm link

빠른 시작

clishop.ai에서 계정을 만들거나 CLI에서 모든 작업을 수행할 수 있습니다.

설정

설정에는 이메일 주소만 필요합니다. 먼저 검색하고, 구매할 준비가 되면 주소와 결제 수단을 추가하세요.

OpenClaw, MCP 클라이언트, Claude 스타일 셸 및 기타 도구 실행기의 경우 다음을 사용하세요:

clishop setup start --email user@example.com --json

setup start는 계정 준비 상태와 함께 즉시 반환되며 인증 정보를 로컬에 저장합니다.

OpenClaw에서는 CLI 셸 명령어보다 설치된 CLISHOP MCP 도구를 선호하세요. 주소 관리의 경우, 먼저 list_addresses를 호출한 다음, 알려진 필드로 add_address를 비대화식으로 호출하고, 누락된 필수 주소 필드(label, firstName, lastName, line1, city, postalCode, country)에 대해서만 사용자에게 질문하는 것이 의도된 흐름입니다. 결제의 경우, add_payment_method를 사용하여 사람이 사용할 안전한 설정 링크를 생성한 후, 사람이 웹 흐름을 완료한 후 list_payment_methods를 확인하세요. 에이전트는 채팅에서 원시 카드 정보를 요청해서는 안 됩니다.

• clishop search <query>로 바로 제품 검색

• 나중에 clishop address add로 배송 주소 추가

• 나중에 clishop payment add로 결제 수단 추가

설정이 완료된 후 배송 주소를 추가하고 주문을 시작하세요:

$ clishop search "wireless headphones"

  🔍 Search results for "wireless headphones"

  1  Sony WH-1000XM5                           $278.00
     SUPERSTORE · ★ 8.1 · Free shipping · 3-5 days

  2  JBL Tune 770NC Wireless                    $79.95
     EveryMarket · ★ 7.9 · $5.99 shipping · 5-8 days

$ clishop info 1

  Sony WH-1000XM5
  ─────────────────────────────────────
  Price:       $278.00
  Store:       SUPERSTORE (★ 8.1)
  Shipping:    Free · 3-5 business days
  Returns:     30-day free returns
  In stock:    Yes

  Industry-leading noise cancellation with
  Auto NC Optimizer. 30-hour battery life.
  Multipoint connection for two devices.

clishop buy 1

팁: 검색 결과 번호를 어디서든 사용하세요 — clishop info 1 2 3 또는 clishop buy 2.

진단

문제가 발생하면 다음을 실행하세요:

clishop doctor

이 명령어는 키체인 가용성, 토큰 저장소, 인증 상태 및 API 연결을 확인합니다.

아키텍처

┌─────────────────────────────┐
│  AI Agent / Script / Human  │
└──────────────┬──────────────┘
               │
       ┌───────▼───────┐
       │  CLISHOP CLI   │  ← this repo
       │  (Node.js)     │
       └───────┬───────┘
               │ HTTPS
       ┌───────▼───────┐
       │  CLISHOP API   │  ← backend (Vercel)
       └───────┬───────┘
               │
    ┌──────────┼──────────┐
    ▼          ▼          ▼
 Store A    Store B    Store C   ← vendor Dark Stores

CLISHOP에서 판매하기

Dark Store 템플릿으로 나만의 스토어를 운영할 수 있습니다. 카탈로그, 배송 규칙 및 가격을 YAML로 정의하고 Vercel에 배포하면 바로 시작할 수 있습니다. 웹사이트가 필요 없습니다.

개발

git clone https://github.com/DavooxBv2/CLISHOP.git
cd CLISHOP && npm install
npm run dev -- search "headphones"   # Dev mode (no build needed)
npm run build                        # Production build
npm run lint                         # Type-check

MCP 서버

CLISHOP은 46개의 도구를 갖춘 네이티브 MCP 서버로 제공됩니다. 모든 MCP 호환 클라이언트는 즉시 쇼핑 기능을 사용할 수 있습니다.

clishop-mcp              # If installed globally
node ./dist/mcp.js       # From the installed package directory

MCP 온보딩 도구는 이제 동일한 이메일 우선 모델을 따릅니다:

• setup은 이메일 주소로 즉시 계정을 생성합니다

• setup_status는 레거시 설정 ID에 대해서만 계속 사용 가능합니다

VS Code, Claude Desktop, Cursor 및 Windsurf 구성에 대한 자세한 내용은 MCP 설정 가이드를 참조하세요.

문서

전체 명령어 참조, 에이전트 구성, 검색 필터 등:

→ clishop.ai/docs

링크

• 🌐 clishop.ai

• 📖 문서

• 💬 Discord

• 🏪 Dark Store

라이선스

MIT