auchan-mcp 0.2.1 → 0.3.0

package/.env.example

@@ -0,0 +1,21 @@
+# auchan-mcp: variáveis de ambiente
+# Com o plugin supermercados-mcp, o ficheiro é criado e aberto sozinho na primeira vez:
+#   Windows: %USERPROFILE%\.supermercados-mcp\credentials.env
+#   macOS/Linux: ~/.supermercados-mcp/credentials.env
+# Sem o plugin, podes pôr as duas linhas abaixo nesse ficheiro ou em ~/.auchan-mcp/credentials.env.
+# Esse ficheiro nunca vai para o git. A pesquisa funciona sem ele.
+
+# Necessárias para o carrinho (get_cart, add_to_cart, update_cart_item).
+# AUCHAN_EMAIL=tu@exemplo.pt
+# AUCHAN_PASSWORD=a-tua-palavra-passe
+
+# As seguintes definem-se no "env" do servidor no cliente MCP, não no ficheiro acima.
+
+# Outro ficheiro de credenciais (por omissão: o do plugin e depois ~/.auchan-mcp/credentials.env).
+# AUCHAN_ENV_PATH=C:\caminho\para\credentials.env
+
+# Outra pasta para a sessão guardada e a cache (por omissão: ~/.auchan-mcp).
+# AUCHAN_STATE_DIR=C:\caminho\para\pasta
+
+# Põe false só para ver o browser durante o login, ao procurar um problema.
+# AUCHAN_LOGIN_HEADLESS=true

package/README.md

@@ -10,6 +10,7 @@ Feito à imagem do [continente-mcp](https://github.com/davidmarqu3s/continente-m
 
 - **Pesquisa sem conta**: nome, marca, preço, preço e preço por litro, quilo ou unidade.
 - **Carrinho**: ver, juntar e mudar quantidades; cada alteração é confirmada no carrinho a seguir.
+- **Entra sozinho**: usa o email e a palavra-passe de um ficheiro teu, em segundo plano e sem janela, e volta a entrar sempre que o Auchan termina a sessão.
 - **Respeita o site**: no máximo um pedido por segundo, resultados guardados durante 6 horas e um user-agent que diz quem é.
 - **Tu decides**: a finalização da encomenda e o pagamento fazem-se sempre no Auchan.pt. O servidor não tem nenhuma ferramenta para isso.
 
@@ -31,7 +32,16 @@ Precisas do Node.js 20.18.1 ou mais recente e de um cliente MCP, por exemplo o C
 }
 ```
 
-A pesquisa funciona logo, sem conta. Para o carrinho não crias nada: quando o assistente precisar dele, abre-se uma janela do Edge ou do Chrome na página de login do Auchan. Entras tu, a janela fecha e ficas ligado. A palavra-passe nunca passa pelo servidor nem fica guardada: só a sessão, no teu computador (`%USERPROFILE%\.auchan-mcp\cookies.json`). Se aparecer um CAPTCHA, resolves tu na janela.
+A pesquisa funciona logo, sem conta. Para o carrinho, cria o ficheiro `%USERPROFILE%\.auchan-mcp\credentials.env` (no macOS e Linux, `~/.auchan-mcp/credentials.env`) com duas linhas, sem aspas e sem espaços à volta do `=`:
+
+```
+AUCHAN_EMAIL=o-teu-email
+AUCHAN_PASSWORD=a-tua-palavra-passe
+```
+
+Também lê `~/.supermercados-mcp/credentials.env`, o ficheiro que o plugin [supermercados-mcp](https://github.com/vasco-branco06/supermercados-mcp) cria e abre sozinho na primeira vez, e o que `AUCHAN_ENV_PATH` indicar. O Auchan só aceita produtos no carrinho depois de escolheres uma vez, no site, entrega em casa ou levantamento (com o código postal); essa escolha fica guardada na tua conta.
+
+A palavra-passe fica em texto simples nesse ficheiro, na tua pasta de utilizador. Não o partilhes. Só é lida para preencher o formulário de login e nunca aparece nas respostas nem nos registos. A sessão (cookies e armazenamento local) fica em `%USERPROFILE%\.auchan-mcp\cookies.json`.
 
 ## Usar
 
@@ -42,12 +52,16 @@ Pede coisas como "procura leite meio-gordo no Auchan" ou "junta 2 pacotes ao car
 | `search_products` | Pesquisar o catálogo (devolve JSON) |
 | `get_cart` | Ver o carrinho |
 | `add_to_cart` / `update_cart_item` | Juntar um produto / mudar a quantidade (0 tira-o) |
-| `login` | Ligar a tua conta: abre a janela de login (as ferramentas do carrinho fazem-no sozinhas se for preciso) |
-| `logout` | Desligar a conta: apaga a sessão guardada neste computador |
+| `login` | Verificar ou renovar a sessão com o ficheiro de credenciais (as ferramentas do carrinho fazem-no sozinhas) |
+| `logout` | Desligar a conta: apaga a sessão guardada neste computador (o ficheiro de credenciais fica) |
 | `close_session` | Libertar recursos |
 
+Com o servidor a correr, faz um pedido leve de 10 em 10 minutos para o Auchan não fechar a sessão por inatividade, e guarda o que o site renova.
+
 ## Mais
 
+- **Sem ficheiro de credenciais:** existe o ramo [`login-por-janela`](https://github.com/vasco-branco06/supermercados-mcp/tree/login-por-janela), em que a pessoa entra numa janela do browser e a palavra-passe nunca é guardada.
+- **Definições:** variáveis em [`.env.example`](.env.example).
 - **Problemas:** [docs/troubleshooting.md](docs/troubleshooting.md).
 - **Testes:** `npm test` corre sem internet. `LIVE=1` liga um teste que faz um pedido real ao Auchan.pt (no PowerShell: `$env:LIVE=1; npm test`).
 

package/dist/index.js

@@ -176,21 +176,47 @@ async function fetchPage(url2, { fetchImpl = fetch, gate = throttle } = {}) {
 }
 
 // src/paths.js
+import { existsSync, readFileSync as readFileSync2 } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 function resolveStatePaths(env = process.env) {
-  const stateDir = env.AUCHAN_STATE_DIR || join(env.HOME || env.USERPROFILE || homedir(), ".auchan-mcp");
+  const home = env.HOME || env.USERPROFILE || homedir();
+  const stateDir = env.AUCHAN_STATE_DIR || join(home, ".auchan-mcp");
   return {
     stateDir,
     cacheDir: join(stateDir, "cache"),
+    // Where the plugin's first run creates the template, shared by every supermarket.
+    sharedCredentialFile: env.SUPERMERCADOS_MCP_CREDENTIALS || join(env.SUPERMERCADOS_MCP_DIR || join(home, ".supermercados-mcp"), "credentials.env"),
+    credentialFile: join(stateDir, "credentials.env"),
     cookieFile: join(stateDir, "cookies.json")
   };
 }
+function parseEnvFile(contents) {
+  const parsed = {};
+  for (const line of contents.split(/\r?\n/)) {
+    const raw = line.trim().replace(/^export\s+/, "");
+    const index = raw.indexOf("=");
+    if (!raw || raw.startsWith("#") || index === -1) continue;
+    const key = raw.slice(0, index).trim();
+    const value = raw.slice(index + 1).trim().replace(/^(["'])(.*)\1$/, "$2");
+    if (/^[A-Z_][A-Z0-9_]*$/.test(key)) parsed[key] = value;
+  }
+  return parsed;
+}
+function loadCredentials(env = process.env) {
+  const { credentialFile, sharedCredentialFile } = resolveStatePaths(env);
+  for (const file2 of [env.AUCHAN_ENV_PATH, sharedCredentialFile, credentialFile]) {
+    if (!file2 || !existsSync(file2)) continue;
+    const { AUCHAN_EMAIL: email3, AUCHAN_PASSWORD: password } = parseEnvFile(readFileSync2(file2, "utf8"));
+    if (email3 && password) return { email: email3, password };
+  }
+  return null;
+}
 
 // src/search.js
 import * as cheerio2 from "cheerio";
 import { createHash } from "node:crypto";
-import { mkdirSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
+import { mkdirSync, readFileSync as readFileSync3, writeFileSync } from "node:fs";
 import { join as join2 } from "node:path";
 
 // ../../node_modules/zod/v4/classic/external.js
@@ -20010,7 +20036,7 @@ var searchUrl = (query) => `${AUCHAN_BASE}/pt/pesquisa?q=${encodeURIComponent(qu
 var cacheFile = (cacheDir, query) => join2(cacheDir, `${createHash("sha256").update(query.trim().toLowerCase()).digest("hex").slice(0, 32)}.json`);
 function readCache(file2, now) {
   try {
-    const entry = JSON.parse(readFileSync2(file2, "utf8"));
+    const entry = JSON.parse(readFileSync3(file2, "utf8"));
     if (now - Date.parse(entry.fetched_at) < CACHE_TTL_MS && Array.isArray(entry.raw)) return entry;
   } catch {
   }
@@ -20035,23 +20061,30 @@ async function searchProducts(query, limit = 10, { cacheDir, fetchImpl, now = Da
 }
 
 // src/session.js
-import { chmodSync, existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync3, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { chmodSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync4, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { dirname } from "node:path";
 var LOGIN_URL = `${AUCHAN_BASE}/on/demandware.store/Sites-AuchanPT-Site/pt_PT/Login-OAuthLogin?oauthProvider=Salesforce&oauthLoginTargetEndPoint=1`;
 var DELIVERY_URL = `${AUCHAN_BASE}/on/demandware.store/Sites-AuchanPT-Site/pt_PT/Delivery-Header`;
 var CART_URL = `${AUCHAN_BASE}/on/demandware.store/Sites-AuchanPT-Site/pt_PT/Cart-Show`;
+var EMAIL_FIELD = 'input[name="uname1"], input[type="email"]';
+var PASSWORD_FIELD = 'input[name="passwordLogin"], input[type="password"]';
+var SUBMIT_BUTTON = '#btnSubmit_login, input[name="btnSubmit_login"], button[type="submit"]:visible';
+var CHALLENGE = 'iframe[src*="captcha"], iframe[title*="challenge"], .g-recaptcha, .h-captcha, #px-captcha';
 var BROWSER_CHANNELS = ["msedge", "chrome", void 0];
 var NO_PLAYWRIGHT = "falta o Playwright; instala o pacote de novo (npm install auchan-mcp)";
-var NO_BROWSER = 'n\xE3o encontrei o Microsoft Edge nem o Google Chrome para abrir a janela de login; instala um deles ou corre "npx playwright install chromium"';
+var NO_BROWSER = 'n\xE3o encontrei o Microsoft Edge nem o Google Chrome para fazer o login; instala um deles ou corre "npx playwright install chromium"';
+var FORM_CHANGED = "o formul\xE1rio de login do Auchan n\xE3o \xE9 o esperado (o site pode ter mudado); \xE9 preciso atualizar o servidor";
+var LOGIN_FAILED = "o login n\xE3o terminou; confirma o email e a palavra-passe no ficheiro de credenciais";
+var NO_DELIVERY = "o Auchan ainda n\xE3o tem a tua entrega escolhida; escolhe-a uma vez no auchan.pt (entrega em casa ou levantamento, com o c\xF3digo postal) e tenta de novo";
 function writeState(path, state) {
   mkdirSync2(dirname(path), { recursive: true, mode: 448 });
   writeFileSync2(path, JSON.stringify(state, null, 2), { mode: 384 });
   chmodSync(path, 384);
 }
 function readState(path) {
-  if (!existsSync(path)) return null;
+  if (!existsSync2(path)) return null;
   try {
-    const saved = JSON.parse(readFileSync3(path, "utf8"));
+    const saved = JSON.parse(readFileSync4(path, "utf8"));
     const state = Array.isArray(saved) ? { cookies: saved, origins: [] } : { cookies: saved?.cookies, origins: saved?.origins ?? [] };
     return Array.isArray(state.cookies) && state.cookies.length ? state : null;
   } catch {
@@ -20059,13 +20092,14 @@ function readState(path) {
   }
 }
 function createSession({
+  credentials,
+  credentialFile = "credentials.env",
   cookieFile,
   log = console.error,
   loadPlaywright = () => import("playwright"),
-  loginTimeoutMs = 5 * 60 * 1e3,
-  keepAliveMs = 10 * 60 * 1e3,
-  pollMs = 3e3,
-  sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+  headless = true,
+  loginTimeoutMs = 3e4,
+  keepAliveMs = 10 * 60 * 1e3
 }) {
   let playwright = null;
   let api = null;
@@ -20105,7 +20139,7 @@ function createSession({
     assertNotBlocked(res.status(), "");
     return res.ok() && /data-has-context="true"/.test(await res.text());
   }
-  async function launch(chromium, headless) {
+  async function launch(chromium) {
     for (const channel of BROWSER_CHANNELS) {
       try {
         return await chromium.launch({ headless, ...channel && { channel } });
@@ -20114,31 +20148,49 @@ function createSession({
     }
     return null;
   }
-  async function interactiveLogin(saved = null) {
+  function scrubbed(error62) {
+    for (const secret of [credentials?.email, credentials?.password]) {
+      if (secret) error62.message = String(error62.message).split(secret).join("***");
+    }
+    return error62;
+  }
+  async function autoLogin() {
+    if (!credentials) {
+      throw new Error(`falta o ficheiro ${credentialFile} com as linhas AUCHAN_EMAIL=... e AUCHAN_PASSWORD=... (ver o README)`);
+    }
     const { chromium } = await pw();
-    const browser = await launch(chromium, false);
+    const browser = await launch(chromium);
     if (!browser) throw new Error(NO_BROWSER);
-    const closed = new Promise((resolve) => browser.on("disconnected", () => resolve("closed")));
     try {
-      const context = await browser.newContext({ locale: "pt-PT", ...saved && { storageState: saved } });
+      const context = await browser.newContext({ locale: "pt-PT", userAgent: USER_AGENT });
       const page = await context.newPage();
-      log(saved ? "[auth] Abri uma janela do browser: escolhe a entrega ou o levantamento no Auchan." : "[auth] Abri uma janela do browser: faz o login no Auchan e escolhe a entrega ou o levantamento.");
-      await throttle(() => page.goto(saved ? `${AUCHAN_BASE}/pt/` : LOGIN_URL, { waitUntil: "domcontentloaded", timeout: 3e4 }));
-      const deadline = Date.now() + loginTimeoutMs;
-      while (Date.now() < deadline) {
-        if (await Promise.race([closed, sleep(pollMs).then(() => "tick")]) === "closed") {
-          throw new Error("a janela de login foi fechada antes de o login terminar; tenta de novo");
-        }
-        const url2 = new URL(page.url());
-        if (url2.hostname !== "www.auchan.pt" || /login/i.test(url2.pathname)) continue;
-        if (await isLoggedIn(context.request) && await hasDeliveryContext(context.request)) {
-          const next = await context.storageState();
-          writeState(cookieFile, next);
-          log("[auth] Sess\xE3o iniciada.");
-          return next;
+      log("[auth] A iniciar sess\xE3o no Auchan...");
+      await throttle(() => page.goto(LOGIN_URL, { waitUntil: "domcontentloaded", timeout: 3e4 }));
+      await page.locator("#onetrust-accept-btn-handler").click({ timeout: 2e3 }).catch(() => {
+      });
+      try {
+        await page.locator(EMAIL_FIELD).first().fill(credentials.email, { timeout: 2e4 });
+        await page.locator(PASSWORD_FIELD).first().fill(credentials.password, { timeout: 1e4 });
+        await throttle(() => page.locator(SUBMIT_BUTTON).first().click({ timeout: 1e4 }));
+      } catch {
+        throw new Error(FORM_CHANGED);
+      }
+      try {
+        await page.waitForURL((url2) => url2.hostname === "www.auchan.pt" && !/login/i.test(url2.pathname), { timeout: loginTimeoutMs });
+      } catch {
+        if (await page.locator(CHALLENGE).count()) {
+          throw new BlockedError("o site pediu uma verifica\xE7\xE3o anti-rob\xF4 (CAPTCHA) no login; entra uma vez no auchan.pt pelo browser e tenta mais tarde");
         }
+        throw new Error(LOGIN_FAILED);
       }
-      throw new Error("o login n\xE3o terminou em 5 minutos; tenta de novo");
+      if (!await isLoggedIn(context.request)) throw new Error(LOGIN_FAILED);
+      const next = await context.storageState();
+      writeState(cookieFile, next);
+      log("[auth] Sess\xE3o iniciada.");
+      return next;
+    } catch (error62) {
+      if (error62 instanceof BlockedError || error62.message === LOGIN_FAILED || error62.message === FORM_CHANGED || error62.message.startsWith("falta ")) throw scrubbed(error62);
+      throw new Error(LOGIN_FAILED);
     } finally {
       await browser.close().catch(() => {
       });
@@ -20167,8 +20219,10 @@ function createSession({
           await persist(true);
           return;
         }
-        loggedIn = false;
+        if (credentials) await openApi(await autoLogin());
+        else loggedIn = false;
       } catch {
+        loggedIn = false;
       } finally {
         beating = false;
       }
@@ -20179,26 +20233,19 @@ function createSession({
     if (api && loggedIn) return Promise.resolve("saved");
     pending ??= (async () => {
       try {
+        let how = "login";
         const saved = readState(cookieFile);
         if (saved) {
           await openApi(saved);
-          const logged = await isLoggedIn(api);
-          if (logged && await hasDeliveryContext(api)) {
-            loggedIn = true;
-            await persist(true);
-            startKeepAlive();
-            return "saved";
-          }
-          log(logged ? "[auth] Falta escolher a entrega." : "[auth] A sess\xE3o guardada expirou.");
-          await openApi(await interactiveLogin(logged ? saved : null));
-          loggedIn = true;
-          startKeepAlive();
-          return "window";
+          if (await isLoggedIn(api)) how = "saved";
+          else log("[auth] A sess\xE3o guardada expirou; vou entrar outra vez.");
         }
-        await openApi(await interactiveLogin());
+        if (how === "login") await openApi(await autoLogin());
+        if (!await hasDeliveryContext(api)) throw new Error(NO_DELIVERY);
         loggedIn = true;
+        await persist(true);
         startKeepAlive();
-        return "window";
+        return how;
       } finally {
         pending = null;
       }
@@ -20302,12 +20349,12 @@ var CART_TOOLS = [
 var LOGIN_TOOLS = [
   {
     name: "login",
-    description: "Connect your Auchan account. Opens a browser window on the Auchan.pt login page; the person logs in there and chooses home delivery or pickup with a postal code (Auchan needs this before any cart change), then the window closes. Tell the person this before calling. The password is never seen or stored. Cart tools call this automatically when there is no session.",
+    description: "Connect your Auchan account with the email and password in credentials.env (no window). Logs in again by itself whenever the session ends. Cart tools call this automatically.",
     inputSchema: { type: "object", properties: {} }
   },
   {
     name: "logout",
-    description: "Disconnect your Auchan account: deletes the saved session from this computer.",
+    description: "Disconnect your Auchan account: deletes the saved session from this computer (credentials.env is kept).",
     inputSchema: { type: "object", properties: {} }
   }
 ];
@@ -20340,7 +20387,13 @@ var AuchanServer = class {
     const paths = resolveStatePaths(env);
     this.cacheDir = paths.cacheDir;
     this.fetchImpl = fetchImpl;
-    this.session = session ?? createSession({ cookieFile: paths.cookieFile });
+    this.credentialsFound = Boolean(loadCredentials(env));
+    this.session = session ?? createSession({
+      credentials: loadCredentials(env),
+      credentialFile: paths.sharedCredentialFile,
+      cookieFile: paths.cookieFile,
+      headless: env.AUCHAN_LOGIN_HEADLESS !== "false"
+    });
     this.tools = [SEARCH_TOOL, ...CART_TOOLS, ...LOGIN_TOOLS, CLOSE_TOOL];
     this.server = new Server({ name: "auchan-mcp", version: VERSION }, { capabilities: { tools: {} } });
     this.server.onclose = () => {
@@ -20384,7 +20437,7 @@ var AuchanServer = class {
           );
         }
         case "login":
-          return text(await this.session.login() === "saved" ? "J\xE1 tens a sess\xE3o do Auchan iniciada." : "Sess\xE3o do Auchan iniciada. J\xE1 posso usar o teu carrinho.");
+          return text(await this.session.login() === "saved" ? "J\xE1 tens a sess\xE3o do Auchan iniciada." : "Sess\xE3o do Auchan iniciada com o ficheiro de credenciais. J\xE1 posso usar o teu carrinho.");
         case "logout":
           await this.session.logout();
           return text("Sess\xE3o do Auchan terminada: apaguei a sess\xE3o guardada neste computador.");
@@ -20398,7 +20451,7 @@ var AuchanServer = class {
   }
   async start() {
     await this.server.connect(new StdioServerTransport());
-    console.error(`Auchan MCP v${VERSION} started`);
+    console.error(`Auchan MCP v${VERSION} started${this.credentialsFound ? "" : " (search only until credentials.env exists)"}`);
   }
 };
 if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auchan-mcp",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Servidor MCP para o Auchan.pt: pesquisa de produtos e gestão do carrinho.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,6 +28,7 @@
   "license": "MIT",
   "files": [
     "dist/",
+    ".env.example",
     "LICENSE",
     "README.md"
   ],