Shufersal MCP Server

Shufersal MCP Server

Um servidor Model Context Protocol que fornece capacidades de compras automatizadas para o site da Shufersal usando Puppeteer. Este servidor permite que LLMs interajam com a plataforma de compras online da Shufersal, pesquisem produtos, criem listas de compras e adicionem itens ao seu carrinho.

Principais Recursos

• Pesquisa de Produtos: Pesquise o catálogo de produtos da Shufersal; usuários logados receberão resultados personalizados
• Gerenciamento de Carrinho: Adicione produtos ao seu carrinho de compras da Shufersal
• Automação de Navegador: Interação perfeita com o site da Shufersal
• Gerenciamento de Listas de Compras: Crie listas de compras estruturadas a partir de links da web (ex.: links de receitas)
• Monitoramento de Console: Acompanhe os logs do console da automação do navegador (para depuração)

Fluxo de Trabalho

1. Criar Lista de Compras: Use create_shopping_list_table para criar uma lista de compras a partir da sua solicitação ou link de receita
2. Abrir Shufersal: Use open_shufersal para navegar até o site da Shufersal (login necessário)
3. Pesquisar Produtos: Use search_shufersal para encontrar produtos que correspondam aos itens da sua lista de compras
4. Adicionar ao Carrinho: Use add_to_shufersal_cart para adicionar os produtos encontrados ao seu carrinho de compras

Componentes

Ferramentas

• open_shufersal

  • Abra o site da Shufersal e prepare-se para as compras (requer login do usuário)
  • Entrada: hasCreatedShoppingList (booleano): Se uma lista de compras foi criada anteriormente

• search_shufersal

  • Pesquise produtos no site da Shufersal (resultados ordenados por histórico de compras)
  • Entrada: query (string): Consulta de pesquisa de produtos (ex.: 'leite', 'pão', 'tomates')

• add_to_shufersal_cart

  • Adicione um produto ao carrinho de compras (deve ser usado após a pesquisa)
  • Entradas:
    • product_id (string): ID do produto dos resultados da pesquisa
    • sellingMethod (string): Método de venda dos resultados da pesquisa
    • qty (número): Quantidade a adicionar ao carrinho
    • comment (string, opcional): Comentário opcional para o produto

Ferramentas Extras para colar um link de receita

• read_webpage_content

  • Leia e converta o conteúdo da página web para o formato markdown
  • Entrada: url (string): URL da página web a ser lida

• create_shopping_list_table

  • Crie uma tabela de lista de compras em formato markdown a partir dos ingredientes da receita
  • Entrada: recipe (array): Matriz de ingredientes da receita com nome, quantidade, unidade de medida e marca opcional

Recursos

O servidor fornece acesso a:

1. Logs do Console (console://logs)
   • Saída do console do navegador em formato de texto
   • Inclui todas as mensagens do console da automação do navegador

Configuração

Aqui está a configuração do Claude Desktop para usar o servidor MCP da Shufersal:

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

Com diretório de dados do usuário 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 Segurança

IMPORTANTE: Esta ferramenta automatiza interações com o navegador no site da Shufersal e armazena dados do navegador localmente. Esteja ciente de que:

• Os dados da sessão do navegador são armazenados em ./puppeteer-user-data/ (excluídos do git)
• Se você fizer login na Shufersal durante o primeiro uso, a ferramenta salvará os dados da sua sessão no diretório de dados do usuário
• Use esta ferramenta apenas com clientes MCP confiáveis

Desenvolvimento

Compilação

npm run build

Modo de Desenvolvimento

npm run watch

Linting

npm run lint
npm run lint:fix

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT.