Skip to main content
Glama
Sign In
deenesjakoruzh
clishop

clishop

by DavooxBv2
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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

兼容

Related MCP server: BuyWhere

亮点

  • 一次查询搜索网络中的所有商店。结果只会过滤出实际能配送至您地址的商品。

  • 设置每笔订单的消费上限，要求发货前进行邮件确认，或让它自动处理——由您决定。

  • 以原生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代理的MCP服务器）。

OpenClaw

一旦ClawHub包发布，就可以通过以下方式将CLISHOP安装到OpenClaw工作区中：

openclaw plugins install clawhub:clishop

该捆绑包在skills/clishop/SKILL.md下暴露CLISHOP技能，并合并打包的.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风格的Shell以及其他工具运行器，请使用：

clishop setup start --email user@example.com --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。代理绝不应在聊天中询问原始卡号信息。

  • 立即使用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

请参阅MCP设置指南了解VS Code、Claude Desktop、Cursor和Windsurf的配置。

文档

完整的命令参考、代理配置、搜索过滤器等：

→ clishop.ai/docs

链接

许可证

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers