Shufersal MCP Server

Servidor MCP de Shufersal

Un servidor de Protocolo de Contexto de Modelo que proporciona capacidades de compra automatizadas para el sitio web de Shufersal utilizando Puppeteer. Este servidor permite que los LLM interactúen con la plataforma de compras en línea de Shufersal, busquen productos, creen listas de compras y agreguen artículos a su carrito.

Características Clave

• Búsqueda de Productos: Busque en el catálogo de productos de Shufersal; los usuarios con sesión iniciada obtendrán resultados personalizados
• Gestión del Carrito: Agregue productos a su carrito de compras de Shufersal
• Automatización del Navegador: Interacción fluida con el sitio web de Shufersal
• Gestión de Listas de Compras: Cree listas de compras estructuradas a partir de enlaces web (por ejemplo, enlaces de recetas)
• Monitoreo de Consola: Realice un seguimiento de los registros de consola de la automatización del navegador (para depuración)

Flujo de Trabajo

1. Crear Lista de Compras: Use create_shopping_list_table para crear una lista de compras a partir de su solicitud o enlace de receta
2. Abrir Shufersal: Use open_shufersal para navegar al sitio web de Shufersal (se requiere inicio de sesión)
3. Buscar Productos: Use search_shufersal para encontrar productos que coincidan con los artículos de su lista de compras
4. Agregar al Carrito: Use add_to_shufersal_cart para agregar los productos encontrados a su carrito de compras

Componentes

Herramientas

• open_shufersal

  • Abra el sitio web de Shufersal y prepárese para comprar (requiere inicio de sesión del usuario)
  • Entrada: hasCreatedShoppingList (booleano): Si se ha creado una lista de compras previamente

• search_shufersal

  • Busque productos en el sitio web de Shufersal (resultados ordenados por historial de compras)
  • Entrada: query (cadena): Consulta de búsqueda de productos (por ejemplo, 'leche', 'pan', 'tomates')

• add_to_shufersal_cart

  • Agregue un producto al carrito de compras (debe usarse después de buscar)
  • Entradas:
    • product_id (cadena): ID del producto de los resultados de búsqueda
    • sellingMethod (cadena): Método de venta de los resultados de búsqueda
    • qty (número): Cantidad a agregar al carrito
    • comment (cadena, opcional): Comentario opcional para el producto

Herramientas Extra para pegar un enlace de receta

• read_webpage_content

  • Lea y convierta el contenido de una página web a formato markdown
  • Entrada: url (cadena): URL de la página web a leer

• create_shopping_list_table

  • Cree una tabla de lista de compras en formato markdown a partir de los ingredientes de una receta
  • Entrada: recipe (matriz): Matriz de ingredientes de receta con nombre, cantidad, unidad de medida y marca opcional

Recursos

El servidor proporciona acceso a:

1. Registros de Consola (console://logs)
   • Salida de consola del navegador en formato de texto
   • Incluye todos los mensajes de consola de la automatización del navegador

Configuración

Aquí está la configuración de Claude Desktop para usar el servidor MCP de Shufersal:

{
  "mcpServers": {
    "shufersal": {
      "command": "node",
      "args": ["<path/to/shufersal-mcp>/dist/index.js"],
    }
  }
}

Con directorio de datos de usuario personalizado:

{
  "mcpServers": {
    "shufersal": {
      "command": "node",
      "args": ["<path/to/shufersal-mcp>/dist/index.js", "--user-data-dir=<path/to/custom/user/data>"],
    }
  }
}

Windows:

{
  "mcpServers": {
    "shufersal": {
      "command": "<path/to/node>",
      "args": ["<path/to/shufersal-mcp>/dist/index.js"],
    }
  }
}

Aviso de Seguridad

IMPORTANTE: Esta herramienta automatiza las interacciones del navegador con el sitio web de Shufersal y almacena datos del navegador localmente. Tenga en cuenta:

• Los datos de la sesión del navegador se almacenan en ./puppeteer-user-data/ (excluidos de git)
• Si inicia sesión en Shufersal durante el primer uso, la herramienta guardará los datos de su sesión en el directorio de datos de usuario
• Use esta herramienta solo con clientes MCP de confianza

Desarrollo

Compilación

npm run build

Modo de Desarrollo

npm run watch

Linting

npm run lint
npm run lint:fix

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT.