clishop

CLISHOP

ターミナルから何でも注文できます。AI エージェントと人間のために構築されています。

---

CLISHOP は、AI エージェントと人間が複数のストアから商品を検索し、価格を比較して、実際に注文できるオープンソースの CLI です。すべてターミナルから操作できます。Dark Store を使えば、誰でも CLISHOP で商品を販売できます。

対応環境

主な特長

• 1 回の検索でネットワーク内のすべてのストアを検索します。検索結果は、お届け先に実際に配送可能な商品に絞り込まれます。
• 注文ごとに支出上限を設定したり、発送前にメールでの確認を必須にしたり、自動で注文を完了させたりできます。設定は自由です。
• 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 サーバー）の 2 つのコマンドが利用できるようになります。

OpenClaw

ClawHub パッケージの公開後、次のコマンドで CLISHOP を OpenClaw ワークスペースにインストールできます。

openclaw plugins install clawhub:clishop

このバンドルは skills/clishop/SKILL.md に CLISHOP スキルを提供し、.mcp.json に含まれる MCP のデフォルト設定をマージします。これにより、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 [email protected] --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