{
  "markdown": "<p align=\"center\">\n  <h1 align=\"center\">CLISHOP</h1>\n  <p align=\"center\">\n    <strong>Order anything from your terminal. Built for AI agents and humans.</strong>\n  </p>\n  <p align=\"center\">\n    <a href=\"https://www.npmjs.com/package/clishop\"><img alt=\"npm\" src=\"https://img.shields.io/npm/v/clishop?style=flat-square&color=cb3837\" /></a>\n    <a href=\"https://clishop.ai\"><img alt=\"Website\" src=\"https://img.shields.io/badge/website-clishop.ai-blue?style=flat-square\" /></a>\n    <a href=\"https://discord.gg/vwXMbzD4bx\"><img alt=\"Discord\" src=\"https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white\" /></a>\n  </p>\n</p>\n\n---\n\nCLISHOP is an open-source CLI that lets AI agents and humans search for products across multiple stores, compare prices, and place real orders — all from the terminal. Anyone can sell on CLISHOP using a [Dark Store](https://github.com/DavooxBv2/CLISHOP-DARKSTORE).\n\n## Works with\n\n<p>\n  <img alt=\"VS Code\" src=\"https://img.shields.io/badge/VS%20Code-Copilot-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white\" />\n  <img alt=\"Claude\" src=\"https://img.shields.io/badge/Claude-Supported-7C3AED?style=for-the-badge&logo=anthropic&logoColor=white\" />\n  <img alt=\"GPT\" src=\"https://img.shields.io/badge/GPT-Supported-10A37F?style=for-the-badge&logo=openai&logoColor=white\" />\n  <img alt=\"Gemini\" src=\"https://img.shields.io/badge/Gemini-Supported-4285F4?style=for-the-badge&logo=googlegemini&logoColor=white\" />\n</p>\n<p>\n  <img alt=\"Cursor\" src=\"https://img.shields.io/badge/Cursor-Supported-000000?style=for-the-badge&logo=cursor&logoColor=white\" />\n  <img alt=\"Windsurf\" src=\"https://img.shields.io/badge/Windsurf-Supported-0EA5E9?style=for-the-badge\" />\n  <img alt=\"AutoGPT\" src=\"https://img.shields.io/badge/AutoGPT-Agent-111827?style=for-the-badge&logo=github&logoColor=white\" />\n  <img alt=\"LangGraph\" src=\"https://img.shields.io/badge/LangGraph-Agent-16A34A?style=for-the-badge&logo=langchain&logoColor=white\" />\n</p>\n\n## Highlights\n\n- One query searches every store in the network. Results are filtered to what actually ships to your address.\n- Set spending caps per order, require email confirmation before anything ships, or let it go through automatically — your call.\n- 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.\n- Can't find what you need? Post an advertise request and let vendors compete to fulfill it.\n- Support tickets, product reviews, store reviews — all from the terminal.\n- Anyone can sell on CLISHOP by deploying a [Dark Store](https://github.com/DavooxBv2/CLISHOP-DARKSTORE). No website needed.\n\n---\n\n## Install\n\nRequires **Node.js ≥ 18**. Works on macOS, Windows, and Linux/WSL.\n\n```bash\nnpm install -g clishop\n```\n\nThis gives you two commands: `clishop` (the CLI) and `clishop-mcp` (the MCP server for AI agents).\n\n### OpenClaw\n\nOnce the ClawHub package is published, install CLISHOP into an OpenClaw workspace with:\n\n```bash\nopenclaw plugins install clawhub:clishop\n```\n\nThe bundle exposes the CLISHOP skill under `skills/clishop/SKILL.md` and merges the packaged MCP defaults from `.mcp.json` so OpenClaw can launch the bundled CLISHOP MCP runtime locally without fetching npm code at startup.\n\n### Linux / WSL\n\nCLISHOP 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.\n\nFor native keychain support (optional):\n\n```bash\nsudo apt install libsecret-1-0\n```\n\nRun `clishop doctor` to check your system's compatibility.\n\n### From source\n\n```bash\ngit clone https://github.com/DavooxBv2/CLISHOP.git\ncd CLISHOP\nnpm install\nnpm run build\nnpm link\n```\n\n## Quick Start\n\nYou can create your account on [clishop.ai](https://clishop.ai) or do everything from the CLI.\n\n### Setup\n\nSetup only needs an email address. Search first, then add your address and payment method when you're ready to buy.\n\nFor OpenClaw, MCP clients, Claude-style shells, and other tool runners, use:\n\n```bash\nclishop setup start --email user@example.com --json\n```\n\n`setup start` returns immediately with account-ready status and stores auth locally.\n\nIn OpenClaw, prefer the installed CLISHOP MCP tools over CLI shell commands. For address management, the intended flow is to call `list_addresses` first, then `add_address` non-interactively with any known fields, and ask the user only for missing required address fields (`label`, `firstName`, `lastName`, `line1`, `city`, `postalCode`, `country`). For payments, use `add_payment_method` to generate a secure setup link for the human, then check `list_payment_methods` after the human completes the web flow. The agent should never ask for raw card details in chat.\n\n- Search products right away with `clishop search <query>`\n- Add a shipping address later with `clishop address add`\n- Add a payment method later with `clishop payment add`\n\nAfter setup is complete, add a shipping address and start ordering:\n\n```\n$ clishop search \"wireless headphones\"\n\n  🔍 Search results for \"wireless headphones\"\n\n  1  Sony WH-1000XM5                           $278.00\n     SUPERSTORE · ★ 8.1 · Free shipping · 3-5 days\n\n  2  JBL Tune 770NC Wireless                    $79.95\n     EveryMarket · ★ 7.9 · $5.99 shipping · 5-8 days\n\n```\n\n```\n$ clishop info 1\n\n  Sony WH-1000XM5\n  ─────────────────────────────────────\n  Price:       $278.00\n  Store:       SUPERSTORE (★ 8.1)\n  Shipping:    Free · 3-5 business days\n  Returns:     30-day free returns\n  In stock:    Yes\n\n  Industry-leading noise cancellation with\n  Auto NC Optimizer. 30-hour battery life.\n  Multipoint connection for two devices.\n```\n\n```bash\nclishop buy 1\n```\n\n> **Tip:** use result numbers from a search anywhere — `clishop info 1 2 3` or `clishop buy 2`.\n\n### Diagnostics\n\nIf something isn't working, run:\n\n```bash\nclishop doctor\n```\n\nThis checks keychain availability, token storage, authentication status, and API connectivity.\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────┐\n│  AI Agent / Script / Human  │\n└──────────────┬──────────────┘\n               │\n       ┌───────▼───────┐\n       │  CLISHOP CLI   │  ← this repo\n       │  (Node.js)     │\n       └───────┬───────┘\n               │ HTTPS\n       ┌───────▼───────┐\n       │  CLISHOP API   │  ← backend (Vercel)\n       └───────┬───────┘\n               │\n    ┌──────────┼──────────┐\n    ▼          ▼          ▼\n Store A    Store B    Store C   ← vendor Dark Stores\n```\n\n---\n\n## Sell on CLISHOP\n\nYou can run your own store with the [Dark Store](https://github.com/DavooxBv2/CLISHOP-DARKSTORE) template. Define your catalog, shipping rules, and pricing in YAML, deploy to Vercel, and you're live. No website needed.\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/DavooxBv2/CLISHOP.git\ncd CLISHOP && npm install\nnpm run dev -- search \"headphones\"   # Dev mode (no build needed)\nnpm run build                        # Production build\nnpm run lint                         # Type-check\n```\n\n---\n\n## MCP Server\n\nCLISHOP ships as a native MCP server with 46 tools. Any MCP-compatible client gets shopping capabilities out of the box.\n\n```bash\nclishop-mcp              # If installed globally\nnode ./dist/mcp.js       # From the installed package directory\n```\n\nThe MCP onboarding tools now follow the same email-first model:\n\n- `setup` creates the account immediately from the email address\n- `setup_status` remains available only for legacy setup IDs\n\nSee the [MCP setup guides](https://clishop.ai/docs#mcp-overview) for VS Code, Claude Desktop, Cursor, and Windsurf configuration.\n\n---\n\n## Docs\n\nFull command reference, agent configuration, search filters, and more:\n\n**[→ clishop.ai/docs](https://clishop.ai/docs)**\n\n---\n\n## Links\n\n- 🌐 [clishop.ai](https://clishop.ai)\n- 📖 [Docs](https://clishop.ai/docs)\n- 💬 [Discord](https://discord.gg/vwXMbzD4bx)\n- 🏪 [Dark Store](https://github.com/DavooxBv2/CLISHOP-DARKSTORE)\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 8035,
  "sha": "acae65b162411600618bde28154725bb3ebbb39ed6a1b262cfaf43a4317bcd0c",
  "repo_slug": "davooxbv2/clishop",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_stefdcl_clishop_1560d668/readme"
}