clishop

CLISHOP

在终端中订购任何商品。专为 AI Agent 和用户打造。

---

CLISHOP 是一款开源 CLI，让 AI Agent 和用户能够在终端中搜索多个商店的商品、比较价格并下单。任何人都可以通过 Dark Store 在 CLISHOP 上销售商品。

兼容

亮点

• 一次查询即可搜索网络中的所有商店。搜索结果会筛选为实际可配送到你地址的商品。
• 为每笔订单设置支出上限、要求发货前通过电子邮件确认，或者允许自动下单——由你决定。
• 以原生 MCP 服务形式提供，包含 46 个工具。兼容 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 Agent 使用的 MCP 服务）。

OpenClaw

ClawHub 软件包发布后，可使用以下命令将 CLISHOP 安装到 OpenClaw 工作区：

openclaw plugins install clawhub:clishop

该软件包会在 skills/clishop/SKILL.md 下提供 CLISHOP 技能，并合并 .mcp.json 中打包的 MCP 默认配置，使 OpenClaw 能够在本地启动打包的 CLISHOP MCP 运行时，而无需在启动时获取 npm 代码。

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 风格的 shell 和其他工具运行器，请使用：

clishop setup start --email [email protected] --json

setup start 会立即返回账户就绪状态，并在本地保存身份验证信息。

在 OpenClaw 中，优先使用已安装的 CLISHOP MCP 工具，而不是 CLI shell 命令。管理地址时，预期流程是先调用 list_addresses，然后使用任何已知字段以非交互方式调用 add_address，仅在必填地址字段（label、firstName、lastName、line1、city、postalCode、country）缺失时询问用户。管理付款时，使用 add_payment_method 为用户生成安全设置链接，然后在用户完成网页流程后检查 list_payment_methods。Agent 绝不应在聊天中询问原始银行卡信息。

• 立即使用 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 以原生 MCP 服务的形式提供，包含 46 个工具。任何兼容 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 设置指南。

---

文档

完整的命令参考、Agent 配置、搜索筛选条件等内容：

→ clishop.ai/docs

---

链接

• 🌐 clishop.ai
• 📖 文档
• 💬 Discord
• 🏪 Dark Store

许可证

MIT