Amazon Business MCP Browser

Server MCP locale per cercare prodotti e gestire un carrello Amazon Business tramite un browser Playwright visibile e isolato.

Stato: prototipo iniziale. Amazon non supporta ufficialmente questa automazione del sito. L'interfaccia può cambiare, comparire CAPTCHA o richiedere nuovamente MFA. Verifica che l'uso sia compatibile con le condizioni applicabili al tuo account.

Principi di sicurezza

• Il login avviene personalmente nella finestra Amazon: l'MCP non chiede né conserva la password.

• La sessione risiede in un profilo browser locale dedicato, fuori dal repository.

• Il browser resta visibile (headless: false).

• Le operazioni browser sono serializzate per evitare modifiche concorrenti al carrello.

• amazon_prepare_checkout apre solo la revisione del carrello.

• Non esiste un tool che prema Effettua l'ordine.

Related MCP server: wholesale-mcp

Tool disponibili

Requisiti

• Node.js 20 o successivo

• Account Amazon Business

• macOS, Linux o Windows con interfaccia grafica

Installazione

npm install
npx playwright install chromium
npm run build

Per usare Google Chrome installato anziché il Chromium incluso:

export AMAZON_BROWSER_CHANNEL=chrome

Configurazione MCP

Esempio generico per un client MCP:

{
  "mcpServers": {
    "amazon-business": {
      "command": "node",
      "args": ["/percorso/amazon-business-mcp-browser/dist/index.js"],
      "env": {
        "AMAZON_MARKETPLACE_URL": "https://www.amazon.it",
        "AMAZON_BROWSER_CHANNEL": "chromium"
      }
    }
  }
}

Al primo utilizzo:

1. Chiama amazon_open_login.

2. Completa login, MFA ed eventuale CAPTCHA nella finestra aperta.

3. Chiama amazon_session_status.

4. Avvia una ricerca o leggi il carrello.

Il profilo predefinito viene salvato in ~/.amazon-business-mcp-browser/profile. Puoi cambiarlo con AMAZON_BROWSER_PROFILE.

Configurazione

Copia .env.example come riferimento. Il server legge direttamente le variabili d'ambiente:

Sviluppo

npm run check
npm test
npm run build

I test automatici non effettuano accessi né modifiche su Amazon. Le verifiche end-to-end devono essere eseguite manualmente su un account autorizzato.

Limiti noti

• Selettori, testi e flussi Amazon possono cambiare senza preavviso.

• CAPTCHA, MFA e consensi devono essere completati manualmente.

• Alcuni prodotti richiedono la selezione di una variante prima di poterli aggiungere.

• Prezzi e disponibilità sono istantanee e possono cambiare durante il checkout.

• Non aggira protezioni anti-bot, limiti dell'account o controlli Amazon.

Evoluzione prevista

Il codice browser è separato dal layer MCP per consentire in futuro un provider basato sulle API ufficiali Amazon Business, mantenendo invariati i nomi dei tool.