MCP Model Context Protocol
Protocollo aperto che permette a un assistente AI (come ChatGPT o Claude) di collegarsi in modo standard a fonti dati e strumenti esterni. Al posto di integrazioni su misura, l'AI parla con un server MCP che espone strumenti e dati.
In Vendooly: Vendooly è un server MCP per Amazon che espone strumenti di lettura e azioni operative.
Server MCP
Il servizio che implementa il protocollo MCP: riceve richieste dall'assistente AI, le traduce in chiamate verso API o database, e restituisce dati o esegue azioni entro i permessi autorizzati.
In Vendooly: il server MCP traduce le domande in linguaggio naturale in chiamate a SP-API e Amazon Ads API, mantenendo il contesto di organizzazione, seller account e marketplace.
SP-API Selling Partner API
L'insieme di API ufficiali di Amazon per i venditori. Copre catalogo, listing, ordini, inventario FBA, prezzi, report e Account Health. Sostituisce la vecchia MWS. L'accesso richiede autorizzazione OAuth ("Login with Amazon") con scope specifici.
Amazon Ads API
L'API ufficiale di Amazon Advertising, separata dall'SP-API e con un'autorizzazione OAuth dedicata. Gestisce campagne Sponsored Products, Sponsored Brands e Sponsored Display, oltre a keyword, target, bid, budget e report di performance.
In Vendooly: la performance (ACoS, spesa, click) si legge dai report; la configurazione (stato, budget, bid) dagli endpoint di listing delle campagne.
Seller Central
Il portale web con cui i venditori terzi gestiscono il proprio account Amazon: prodotti, ordini, inventario, prezzi, pubblicità e metriche. L'accesso programmatico allo stesso account avviene tramite SP-API, non condividendo la password.
Marketplace
Un singolo store nazionale di Amazon, identificato da un marketplace ID (es. APJ6JRA9NG5V4 = amazon.it). Un venditore può operare su più marketplace; ognuno ha propri prezzi, disponibilità e regole.
Outpost termine Vendooly
La coppia seller account + marketplace: la foglia operativa più fine. È la chiave a cui Vendooly ancora i dati di performance, perché due venditori diversi possono operare sullo stesso marketplace e vanno tenuti separati.
ASIN / SKU
ASIN (Amazon Standard Identification Number): l'identificativo di un prodotto nel catalogo Amazon, condiviso da tutti i venditori della stessa scheda. SKU (Stock Keeping Unit): il codice interno con cui un singolo venditore identifica la propria offerta su quell'ASIN.
Listing
L'offerta di un venditore su un ASIN: prezzo, quantità, condizione, tempi di gestione e attributi. Un listing sano è pubblicato, con attributi completi e senza errori bloccanti.
Vedi anche automazione listing con controllo umano.
Listing soppresso
Un listing rimosso dai risultati di ricerca e dalla vendita per un problema di qualità o conformità: immagine mancante, attributo obbligatorio assente, violazione di policy. Non è cancellato, ma non vende finché il problema non è risolto.
Stranded inventory
Stock presente nei centri FBA ma non associato a un'offerta attiva (spesso per un listing soppresso o disattivato). È inventario che occupa spazio e genera costi senza poter essere venduto.
Buy Box
Il pulsante Aggiungi al carrello assegnato a una singola offerta quando più venditori competono sulla stessa scheda. Vincere la Buy Box significa ricevere la maggior parte delle vendite; l'assegnazione dipende da prezzo, disponibilità, metodo di gestione e metriche del venditore.
FBA / FBM
FBA (Fulfillment by Amazon): lo stock è nei centri Amazon che gestiscono spedizione, resi e assistenza. FBM (Fulfillment by Merchant): è il venditore a stoccare e spedire. La modalità influenza costi, Buy Box e disponibilità Prime.
Repricing
L'aggiustamento del prezzo di un'offerta, manuale o automatico, per restare competitivi sulla Buy Box preservando il margine. Un buon repricing lavora sempre entro un floor price.
Floor price
Il prezzo minimo sotto cui una regola di repricing non deve mai scendere. Protegge il margine ed evita corse al ribasso. Il suo opposto è il ceiling, il prezzo massimo.
Feed
Un invio in blocco all'SP-API (via Feeds/Listings API) per aggiornare molti listing, prezzi o quantità in una sola operazione. Un feed viene elaborato in modo asincrono e produce un report di esito con eventuali errori riga per riga.
Account Health
Il cruscotto di metriche con cui Amazon valuta l'affidabilità di un venditore: tasso di difetti ordine, spedizioni in ritardo, violazioni di policy, reclami. Un punteggio basso può portare a sospensione dell'account.
Vedi anche audit Account Health.
ACoS / ROAS / TACoS
ACoS: spesa pubblicitaria ÷ vendite da pubblicità (%). Più è basso, più la campagna è efficiente. ROAS: l'inverso, vendite ÷ spesa. TACoS: spesa pubblicitaria ÷ vendite totali (organiche + ads); misura l'impatto della pubblicità sull'intero business.
OAuth / LWA
OAuth è lo standard con cui un venditore autorizza un'app ad accedere al proprio account senza condividere la password. Su Amazon si chiama Login with Amazon (LWA). L'app riceve un token con scope limitati, revocabile in qualsiasi momento.
In Vendooly: SP-API e Amazon Ads richiedono autorizzazioni OAuth separate. Vedi sicurezza e protezione dati.
RDT Restricted Data Token
Un token temporaneo dell'SP-API necessario per leggere dati personali dell'acquirente (PII), come l'indirizzo di spedizione di un ordine. Ha uno scopo ristretto e una durata breve: è un controllo di privacy imposto da Amazon.
Approvazione umana human-in-the-loop
Il modello per cui l'AI può leggere dati e preparare un'azione, ma qualsiasi scrittura verso Amazon (prezzo, stock, listing, budget, bid) richiede una conferma esplicita di una persona prima di essere eseguita.
In Vendooly: è la regola di sicurezza non negoziabile. Vedi cosa Vendooly non è.