clishop 1.5.3 → 1.5.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/.mcp.json +8 -0
  2. package/README.md +12 -2
  3. package/dist/index.js +3 -3
  4. package/dist/mcp.js +1 -1
  5. package/openclaw.bundle.json +3 -0
  6. package/package.json +9 -2
  7. package/server.json +23 -0
  8. package/skills/clishop/SKILL.md +150 -0
package/.mcp.json ADDED
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "clishop": {
4
+ "command": "npx",
5
+ "args": ["-y", "clishop", "--mcp"]
6
+ }
7
+ }
8
+ }
package/README.md CHANGED
@@ -33,7 +33,7 @@ CLISHOP is an open-source CLI that lets AI agents and humans search for products
33
33
 
34
34
  - One query searches every store in the network. Results are filtered to what actually ships to your address.
35
35
  - Set spending caps per order, require email confirmation before anything ships, or let it go through automatically — your call.
36
- - Ships as a native [MCP server](https://modelcontextprotocol.io/) with 44 tools. Works with VS Code Copilot, Claude, Cursor, Windsurf, and anything else that speaks MCP.
36
+ - Ships as a native [MCP server](https://modelcontextprotocol.io/) with 46 tools. Works with VS Code Copilot, Claude, Cursor, Windsurf, and anything else that speaks MCP.
37
37
  - Can't find what you need? Post an advertise request and let vendors compete to fulfill it.
38
38
  - Support tickets, product reviews, store reviews — all from the terminal.
39
39
  - Anyone can sell on CLISHOP by deploying a [Dark Store](https://github.com/DavooxBv2/CLISHOP-DARKSTORE). No website needed.
@@ -50,6 +50,16 @@ npm install -g clishop
50
50
 
51
51
  This gives you two commands: `clishop` (the CLI) and `clishop-mcp` (the MCP server for AI agents).
52
52
 
53
+ ### OpenClaw
54
+
55
+ Once the ClawHub package is published, install CLISHOP into an OpenClaw workspace with:
56
+
57
+ ```bash
58
+ openclaw plugins install clawhub:clishop
59
+ ```
60
+
61
+ The bundle exposes the CLISHOP skill under `skills/clishop/SKILL.md` and merges the packaged MCP defaults from `.mcp.json` so OpenClaw can launch `clishop --mcp` automatically.
62
+
53
63
  ### Linux / WSL
54
64
 
55
65
  CLISHOP works out of the box on Linux and WSL. On systems without a native keychain, tokens are stored in a local file (`~/.config/clishop/auth.json`) with restricted permissions.
@@ -184,7 +194,7 @@ npm run lint # Type-check
184
194
 
185
195
  ## MCP Server
186
196
 
187
- CLISHOP ships as a native MCP server with 44 tools. Any MCP-compatible client gets shopping capabilities out of the box.
197
+ CLISHOP ships as a native MCP server with 46 tools. Any MCP-compatible client gets shopping capabilities out of the box.
188
198
 
189
199
  ```bash
190
200
  clishop-mcp # If installed globally
package/dist/index.js CHANGED
@@ -1114,8 +1114,8 @@ async function runSetupWizard(emailArg, { json = false } = {}) {
1114
1114
  console.log();
1115
1115
  console.log(chalk4.bold.cyan(" W E L C O M E T O C L I S H O P"));
1116
1116
  console.log(chalk4.dim(" Order anything from your terminal."));
1117
- console.log(chalk4.dim(` npm: v${"1.5.3"}`));
1118
- console.log(chalk4.dim(` Build: ${"2026-04-04T21:38:36.646Z"}`));
1117
+ console.log(chalk4.dim(` npm: v${"1.5.7"}`));
1118
+ console.log(chalk4.dim(` Build: ${"2026-04-06T08:53:16.476Z"}`));
1119
1119
  console.log();
1120
1120
  divider(chalk4.cyan);
1121
1121
  console.log();
@@ -4261,7 +4261,7 @@ function registerDoctorCommand(program2) {
4261
4261
 
4262
4262
  // src/index.ts
4263
4263
  var program = new Command();
4264
- program.name("clishop").version("1.5.3").description(
4264
+ program.name("clishop").version("1.5.7").description(
4265
4265
  chalk16.bold("CLISHOP") + ` \u2014 Order anything from your terminal.
4266
4266
 
4267
4267
  Run 'clishop setup <email>' or 'clishop setup start --email <email> --json' to create your account.
package/dist/mcp.js CHANGED
@@ -13813,7 +13813,7 @@ function safeCall(fn) {
13813
13813
  var server = new McpServer(
13814
13814
  {
13815
13815
  name: "clishop",
13816
- version: "1.2.3"
13816
+ version: "1.5.7"
13817
13817
  },
13818
13818
  {
13819
13819
  capabilities: {
package/openclaw.bundle.json ADDED
@@ -0,0 +1,3 @@
1
+ {
2
+ "hostTargets": ["openclaw"]
3
+ }
package/package.json CHANGED
@@ -1,11 +1,16 @@
1
1
  {
2
2
  "name": "clishop",
3
- "version": "1.5.3",
3
+ "displayName": "CLISHOP",
4
+ "version": "1.5.7",
4
5
  "mcpName": "io.github.StefDCL/clishop",
5
6
  "description": "CLISHOP — Order anything from your terminal",
6
7
  "main": "dist/index.js",
7
8
  "files": [
8
- "dist"
9
+ "dist",
10
+ "skills",
11
+ ".mcp.json",
12
+ "openclaw.bundle.json",
13
+ "server.json"
9
14
  ],
10
15
  "bin": {
11
16
  "clishop": "dist/index.js",
@@ -28,6 +33,8 @@
28
33
  "cli",
29
34
  "shopping",
30
35
  "ordering",
36
+ "openclaw",
37
+ "clawhub",
31
38
  "mcp",
32
39
  "model-context-protocol",
33
40
  "ai",
package/server.json ADDED
@@ -0,0 +1,23 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.StefDCL/clishop",
4
+ "description": "Order anything from your terminal — search, buy, track, and manage via MCP tools.",
5
+ "repository": {
6
+ "url": "https://github.com/DavooxBv2/CLISHOP",
7
+ "source": "github"
8
+ },
9
+ "version": "1.5.7",
10
+ "packages": [
11
+ {
12
+ "registryType": "npm",
13
+ "identifier": "clishop",
14
+ "version": "1.5.7",
15
+ "runtime": "node",
16
+ "args": ["--mcp"],
17
+ "transport": {
18
+ "type": "stdio"
19
+ },
20
+ "environmentVariables": []
21
+ }
22
+ ]
23
+ }
package/skills/clishop/SKILL.md ADDED
@@ -0,0 +1,150 @@
1
+ ---
2
+ name: clishop
3
+ description: "Order anything from your terminal — search products, compare prices across stores, place orders, manage addresses and payments. Built for AI agents and humans."
4
+ ---
5
+
6
+ # CLISHOP — Buy anything from your terminal
7
+
8
+ CLISHOP is an open-source MCP server and CLI that lets AI agents search for products across multiple stores, compare prices, and place real orders — all from the terminal.
9
+
10
+ **46 MCP tools** for the full shopping lifecycle: search → compare → buy → track → review → return.
11
+
12
+ ## Installation
13
+
14
+ ```bash
15
+ npm install -g clishop
16
+ ```
17
+
18
+ Use the email-first setup command:
19
+
20
+ ```bash
21
+ clishop setup start --email user@example.com --json
22
+ ```
23
+
24
+ Then search products, and only add an address or payment method when the user is ready to buy.
25
+
26
+ ### MCP Server
27
+
28
+ ```bash
29
+ clishop-mcp # If installed globally
30
+ npx -y clishop --mcp # Without installing
31
+ ```
32
+
33
+ ## Tools
34
+
35
+ | Tool | Description | Read-only |
36
+ |------|-------------|-----------|
37
+ | `setup` | Create or sign in with an email address (completes immediately) | ❌ |
38
+ | `setup_status` | Check a legacy setup session by setup_id | ✅ |
39
+ | `search_products` | Search across all connected stores with filters (price, brand, category, shipping, ratings) | ✅ |
40
+ | `get_product` | Get detailed info about a specific product | ✅ |
41
+ | `buy_product` | Place an order (respects agent safety limits) | ❌ |
42
+ | `list_orders` | List orders, optionally filtered by status | ✅ |
43
+ | `get_order` | Full order details including tracking and shipments | ✅ |
44
+ | `cancel_order` | Cancel a pending or confirmed order | ❌ |
45
+ | `list_addresses` | List saved shipping addresses | ✅ |
46
+ | `add_address` | Add a new shipping address | ❌ |
47
+ | `remove_address` | Remove a saved address | ❌ |
48
+ | `set_default_address` | Set the default shipping address for the active agent | ❌ |
49
+ | `list_payment_methods` | List saved payment methods | ✅ |
50
+ | `remove_payment_method` | Remove a saved payment method | ❌ |
51
+ | `set_default_payment_method` | Set the default payment method for the active agent | ❌ |
52
+ | `list_stores` | Browse available stores | ✅ |
53
+ | `get_store` | View store details | ✅ |
54
+ | `store_catalog` | Browse a store's product catalog | ✅ |
55
+ | `account_status` | Full account overview (user, agents, addresses, payments) | ✅ |
56
+ | `list_agents` | List safety profiles (spending limits, allowed categories) | ✅ |
57
+ | `get_agent` | View details of a specific agent | ✅ |
58
+ | `create_agent` | Create a new agent (safety profile) with spending limits | ❌ |
59
+ | `update_agent` | Update an agent's settings (limits, categories, defaults) | ❌ |
60
+ | `switch_agent` | Switch the active agent | ❌ |
61
+ | `get_spending_limit` | View the current monthly spending limit | ✅ |
62
+ | `set_spending_limit` | Change the monthly spending limit | ❌ |
63
+ | `add_product_review` | Write a product review (1-10 rating) | ❌ |
64
+ | `add_store_review` | Write a store review (1-10 rating) | ❌ |
65
+ | `list_reviews` | List all your product and store reviews | ✅ |
66
+ | `get_product_rating` | View rating details for a product | ✅ |
67
+ | `get_store_rating` | View rating details for a store | ✅ |
68
+ | `delete_review` | Delete one of your reviews | ❌ |
69
+ | `create_advertise_request` | Post a request for vendors to bid on | ❌ |
70
+ | `list_advertise_requests` | List your advertised requests | ✅ |
71
+ | `get_advertise_request` | View an advertised request and its bids | ✅ |
72
+ | `accept_advertise_bid` | Accept a vendor's bid | ❌ |
73
+ | `reject_advertise_bid` | Reject a vendor's bid | ❌ |
74
+ | `cancel_advertise_request` | Cancel an open advertised request | ❌ |
75
+ | `create_support_ticket` | Create a support ticket for an order | ❌ |
76
+ | `list_support_tickets` | List support tickets | ✅ |
77
+ | `get_support_ticket` | View a support ticket and its message history | ✅ |
78
+ | `reply_to_support_ticket` | Send a reply to a support ticket | ❌ |
79
+ | `close_support_ticket` | Close a resolved support ticket | ❌ |
80
+ | `submit_feedback` | Report a bug or suggest an improvement | ❌ |
81
+ | `list_feedback` | List your submitted bug reports and suggestions | ✅ |
82
+ | `get_feedback` | View details of a specific feedback item | ✅ |
83
+
84
+ ## External Endpoints
85
+
86
+ All network requests go to the CLISHOP API:
87
+
88
+ | Endpoint | Method | Data sent | Purpose |
89
+ |----------|--------|-----------|---------|
90
+ | `/auth/setup-link` | POST | Email address | Create account / sign in |
91
+ | `/products/search` | GET | Search query, filters (category, brand, price range, country) | Product search |
92
+ | `/products/:id` | GET | Product ID | Product details |
93
+ | `/products/extended/:id` | GET | Product ID | Extended product lookup across vendor stores |
94
+ | `/orders` | GET | Status filter, page | List user's orders |
95
+ | `/orders` | POST | Product ID, quantity, address ID, payment ID, agent name | Place an order |
96
+ | `/orders/:id` | GET | Order ID | Order details |
97
+ | `/orders/:id/tracking` | GET | Order ID | Shipment tracking |
98
+ | `/orders/:id/cancel` | POST | Order ID | Cancel an order |
99
+ | `/addresses` | GET | Agent name | List addresses |
100
+ | `/addresses` | POST | Full address fields (name, street, city, country, etc.) | Add address |
101
+ | `/addresses/:id` | DELETE | Address ID | Remove address |
102
+ | `/payment-methods` | GET | Agent name | List payment methods |
103
+ | `/payment-methods/:id` | DELETE | Payment method ID | Remove payment method |
104
+ | `/stores` | GET | Query, filters | Browse stores |
105
+ | `/stores/:id` | GET | Store ID/slug | Store details |
106
+ | `/stores/:id/products` | GET | Query, filters | Store catalog |
107
+ | `/agents` | GET | — | List agents |
108
+ | `/spending-limit` | GET/PATCH | Limit in cents | Get/set spending limit |
109
+ | `/products/:id/reviews` | POST | Rating, title, body | Product review |
110
+ | `/stores/:id/reviews` | POST | Rating, title, body | Store review |
111
+ | `/reviews/mine` | GET | — | List own reviews |
112
+ | `/products/:id/rating` | GET | — | Product rating details |
113
+ | `/stores/:id/rating` | GET | — | Store rating details |
114
+ | `/advertise` | GET/POST | Title, description, brand, quantity, max bid price | Advertise requests |
115
+ | `/advertise/:id` | GET | — | Advertise request details |
116
+ | `/advertise/:id/bids/:id/accept` | POST | — | Accept bid |
117
+ | `/advertise/:id/bids/:id/reject` | POST | — | Reject bid |
118
+ | `/advertise/:id/cancel` | POST | — | Cancel advertise request |
119
+ | `/support` | GET/POST | Ticket details or status filter | Support tickets |
120
+ | `/support/:id` | GET | — | Support ticket details |
121
+ | `/support/:id/reply` | POST | Message | Reply to support ticket |
122
+ | `/support/:id/status` | PATCH | Status | Close support ticket |
123
+ | `/feedback` | GET/POST | Feedback type, title, description | Feedback |
124
+ | `/feedback/:id` | GET | — | Feedback details |
125
+
126
+ All requests are sent over **HTTPS** to `https://clishop-backend.vercel.app/api`.
127
+
128
+ ## Security & Privacy
129
+
130
+ - **Authentication:** Session tokens are stored in the OS keychain via [keytar](https://github.com/nicknisi/keytar), never in plain-text config files.
131
+ - **No local data collection:** CLISHOP does not collect analytics, telemetry, or tracking data locally.
132
+ - **Agent safety profiles:** Spending limits (`maxOrderAmount`), category allow/block lists, and confirmation requirements are enforced client-side before any order is placed.
133
+ - **Data sent to API:** Only the data required for each operation (search queries, addresses, order details) is sent to the CLISHOP backend API. No additional metadata is collected.
134
+ - **Vendor stores:** When extended search is enabled, the CLISHOP backend fans out search queries to registered vendor Dark Stores in real-time. Product data flows through the CLISHOP API — the CLI never contacts vendor stores directly.
135
+
136
+ ## Trust Statement
137
+
138
+ By using this skill, your search queries, shipping addresses, payment method references, and order details are sent to the CLISHOP API (`clishop-backend.vercel.app`). The API acts as a gateway to registered vendor stores. No data is sold or shared with third parties beyond what is necessary to fulfill orders.
139
+
140
+ ## Model Invocation Note
141
+
142
+ This skill is designed for autonomous invocation by AI agents via the Model Context Protocol (MCP). When an MCP client (e.g. Claude Desktop, Cursor, VS Code Copilot) calls these tools, the agent may search for products, place orders, and manage account data on the user's behalf — subject to the safety thresholds configured in the user's agent profile.
143
+
144
+ ## Links
145
+
146
+ - 🌐 [clishop.ai](https://clishop.ai)
147
+ - 📖 [Docs](https://clishop.ai/docs)
148
+ - 💬 [Discord](https://discord.gg/vwXMbzD4bx)
149
+ - 🏪 [Dark Store template](https://github.com/DavooxBv2/CLISHOP-DARKSTORE)
150
+ - 📦 [npm](https://www.npmjs.com/package/clishop)