clishop

CLISHOP es un CLI de código abierto que permite a los agentes de IA y a los humanos buscar productos en múltiples tiendas, comparar precios y realizar pedidos reales, todo desde la terminal. Cualquiera puede vender en CLISHOP usando una Dark Store.

Funciona con

Related MCP server: BopMarket MCP Server

Aspectos destacados

• Una búsqueda busca en todas las tiendas de la red. Los resultados se filtran según lo que realmente se puede enviar a tu dirección.

• Establece límites de gasto por pedido, exige confirmación por correo electrónico antes de que se envíe algo, o déjalo pasar automáticamente: tú decides.

• Se envía como un servidor MCP nativo con 46 herramientas. Funciona con VS Code Copilot, Claude, Cursor, Windsurf y cualquier otra cosa que hable MCP.

• ¿No encuentras lo que necesitas? Publica una solicitud de anuncio y deja que los vendedores compitan para cumplirla.

• Tickets de soporte, reseñas de productos, reseñas de tiendas, todo desde la terminal.

• Cualquier persona puede vender en CLISHOP desplegando una Dark Store. Sin necesidad de sitio web.

Instalar

Requiere Node.js ≥ 18. Funciona en macOS, Windows y Linux/WSL.

npm install -g clishop

Esto te da dos comandos: clishop (el CLI) y clishop-mcp (el servidor MCP para agentes de IA).

OpenClaw

Una vez que el paquete ClawHub esté publicado, instala CLISHOP en un espacio de trabajo de OpenClaw con:

openclaw plugins install clawhub:clishop

El paquete expone la habilidad de CLISHOP en skills/clishop/SKILL.md y fusiona las configuraciones predeterminadas de MCP empaquetadas desde .mcp.json para que OpenClaw pueda lanzar el runtime de MCP de CLISHOP empaquetado localmente sin tener que obtener el código de npm al inicio.

Linux / WSL

CLISHOP funciona de serie en Linux y WSL. En sistemas sin un llavero nativo, los tokens se almacenan en un archivo local (~/.config/clishop/auth.json) con permisos restringidos.

Para soporte nativo de llavero (opcional):

sudo apt install libsecret-1-0

Ejecuta clishop doctor para comprobar la compatibilidad de tu sistema.

Desde el código fuente

git clone https://github.com/DavooxBv2/CLISHOP.git
cd CLISHOP
npm install
npm run build
npm link

Inicio rápido

Puedes crear tu cuenta en clishop.ai o hacer todo desde el CLI.

Configuración

La configuración solo necesita una dirección de correo electrónico. Busca primero, luego añade tu dirección y método de pago cuando estés listo para comprar.

Para OpenClaw, clientes MCP, shells estilo Claude y otros ejecutores de herramientas, usa:

clishop setup start --email user@example.com --json

setup start devuelve inmediatamente el estado de cuenta listo y almacena la autenticación localmente.

En OpenClaw, prefiere las herramientas MCP de CLISHOP instaladas sobre los comandos de shell del CLI. Para la gestión de direcciones, el flujo previsto es llamar primero a list_addresses, luego a add_address de forma no interactiva con cualquier campo conocido, y preguntar al usuario solo por los campos de dirección obligatorios que falten (label, firstName, lastName, line1, city, postalCode, country). Para pagos, usa add_payment_method para generar un enlace de configuración seguro para el humano, luego verifica list_payment_methods después de que el humano complete el flujo web. El agente nunca debe pedir datos brutos de tarjeta en el chat.

• Busca productos de inmediato con clishop search <query>

• Añade una dirección de envío más tarde con clishop address add

• Añade un método de pago más tarde con clishop payment add

Después de completar la configuración, añade una dirección de envío y empieza a pedir:

$ 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

Consejo: usa los números de resultado de una búsqueda en cualquier lugar — clishop info 1 2 3 o clishop buy 2.

Diagnóstico

Si algo no funciona, ejecuta:

clishop doctor

Esto comprueba la disponibilidad del llavero, el almacenamiento de tokens, el estado de autenticación y la conectividad con la API.

Arquitectura

┌─────────────────────────────┐
│  AI Agent / Script / Human  │
└──────────────┬──────────────┘
               │
       ┌───────▼───────┐
       │  CLISHOP CLI   │  ← this repo
       │  (Node.js)     │
       └───────┬───────┘
               │ HTTPS
       ┌───────▼───────┐
       │  CLISHOP API   │  ← backend (Vercel)
       └───────┬───────┘
               │
    ┌──────────┼──────────┐
    ▼          ▼          ▼
 Store A    Store B    Store C   ← vendor Dark Stores

Vender en CLISHOP

Puedes gestionar tu propia tienda con la plantilla Dark Store. Define tu catálogo, reglas de envío y precios en YAML, despliega en Vercel y ya estás en línea. Sin necesidad de sitio web.

Desarrollo

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

Servidor MCP

CLISHOP se envía como un servidor MCP nativo con 46 herramientas. Cualquier cliente compatible con MCP obtiene capacidades de compra de serie.

clishop-mcp              # If installed globally
node ./dist/mcp.js       # From the installed package directory

Las herramientas de integración de MCP ahora siguen el mismo modelo basado en correo electrónico:

• setup crea la cuenta de inmediato a partir de la dirección de correo electrónico

• setup_status sigue disponible solo para IDs de configuración heredados

Consulta las guías de configuración de MCP para la configuración de VS Code, Claude Desktop, Cursor y Windsurf.

Documentación

Referencia completa de comandos, configuración de agente, filtros de búsqueda y más:

→ clishop.ai/docs

Enlaces

• 🌐 clishop.ai

• 📖 Documentación

• 💬 Discord

• 🏪 Dark Store

Licencia

MIT