Shufersal

Automates Shufersal shopping via browser automation: search, shopping lists, and cart operations.

typescript

14

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can automate interactions with Shufersal’s online shopping platform using a dedicated MCP server. It lets you search products, manage your cart, and build shopping lists from recipes or links while keeping browser automation under your control for reliable, repeatable results.

How to use

Use an MCP client to interact with the Shufersal MCP Server. The workflow centers on creating a shopping list, opening Shufersal, searching for items from that list, and adding items to your cart.

Steps you can perform in sequence:

How to install

Prerequisites: you need Node.js and npm installed on your system.

Install dependencies and build the MCP server.

npm install
npm run build

Run the MCP server locally using the standard runtime command shown for the environment you are on.

Standard run (Unix-like systems):

node dist/index.js

Alternatively, run with a custom user data directory to preserve browser state across sessions:

node dist/index.js --user-data-dir=PATH_TO_CUSTOM_USER_DATA

Windows run example using the same approach:

<path/to/node> dist/index.js

Configuration and security notes

Configure the MCP server in your client with the following examples. These configurations are provided to enable the server when your client connects.

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

If you prefer a custom user data directory, use this variant:

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

Notes on security and data handling

This tool automates browser interactions with Shufersal and stores browser data locally. Be mindful of session data saved in the user data directory and only operate with trusted MCP clients.

Available tools

open_shufersal

Opens the Shufersal website and prepares for shopping (requires user login). Input: hasCreatedShoppingList (boolean).

search_shufersal

Searches the Shufersal website for products. Results are sorted by purchase history. Input: query (string).

add_to_shufersal_cart

Adds a product to the shopping cart after a search. Inputs: product_id (string), sellingMethod (string), qty (number), comment (string, optional).

read_webpage_content

Reads a webpage and converts content to markdown. Input: url (string).

create_shopping_list_table

Creates a shopping list table in markdown from recipe ingredients. Input: recipe (array of ingredients with name, quantity, unit, optional brand).