Intelligenza artificiale
Shopify mette a disposizione di sviluppatori e agenti AI una CLI e un’API per integrare lo shopping in qualsiasi app: ricerca nel catalogo, creazione del carrello e pagamento con Shop Pay a nome dell’acquirente. Lo strumento si chiama @shopify/shop e, secondo la pagina ufficiale shop.dev, si installa con npm i -g @shopify/shop; secondo la documentazione della CLI richiede Node.js 22.21 o successivo nella serie 22, oppure 24.5 o successivo nella serie 24. La pagina non indica la data di apertura del servizio né la disponibilità per l’Italia.
Cosa si può fare con la CLI e l’API
Le funzioni descritte da Shopify:
search_catalogfiltra per prezzo, taglia, colore, valutazione, negozio e paese di spedizione, e accetta una ricerca per parole, per foto o per prodotto simile.get_productrestituisce opzioni, varianti, disponibilità in tempo reale, caratteristiche, specifiche e tutte le immagini: dati che, sottolinea Shopify, lo scraping di una pagina non dà.- Il carrello si crea da riga di comando indicando negozio, variante e quantità.
- Con la ricerca degli ordini l’app può mostrare cosa è in arrivo e lo stato delle consegne.
I comandi mostrati sulla pagina:
| Comando | A cosa serve |
|---|---|
shop search |
cerca prodotti, con opzioni come --ships-to, --currency e --limit |
shop cart create |
crea un carrello per un negozio, una variante e una quantità |
shop approval create |
avvia l’approvazione del pagamento da parte dell’acquirente |
shop account login |
accesso dell’acquirente con il suo account Shop |
shop order search |
cerca gli ordini, anche solo quelli attivi con --activity active |
Come funziona il pagamento con Shop Pay
Secondo Shopify, il pagamento passa dalla CLI shop eseguita sulla macchina dell’acquirente. Per ogni pagamento che l’acquirente approva, Shop Pay emette credenziali monouso, quindi i dati reali della carta restano privati rispetto all’agente.
Con quelle credenziali l’agente può completare l’acquisto nel normale checkout con carta del commerciante, dove il pagamento è elaborato come uno qualsiasi con carta. Shopify precisa che non serve alcuna integrazione da parte del commerciante; con Shop MCP e i commercianti Shopify, Shop Pay funziona direttamente.
Accesso con Shop e ricerca personalizzata
Un’app può far accedere l’utente con il suo account Shop: in quel caso ottiene nome, email e foto, gli indirizzi salvati, gli ordini e le consegne, e la possibilità di far pagare con Shop Pay. Se si usa la CLI npm, secondo la documentazione la credenziale viene salvata localmente in un file di testo non cifrato, da proteggere come una password.
Le ricerche inviate con il token di un utente che ha effettuato l’accesso vengono ordinate in base a preferenze, navigazione e acquisti. Secondo Shopify, queste informazioni restano note solo a Shop e non arrivano all’app.
Costi, requisiti e regole d’uso
- Non serve un agente AI: qualsiasi app può chiamare il servizio via HTTPS. L’API usa UCP tramite MCP, cioè formati di richiesta JSON-RPC e non un modello, e ogni richiesta include l’URL del profilo dell’agente.
- È gratuito. La ricerca non richiede account né chiave; per limiti più alti si crea una chiave API nel Dev Dashboard.
- Le regole d’uso vietano di salvare in cache i risultati e di ospitare di nuovo le immagini dei commercianti. I dati vanno richiesti quando servono e le immagini caricate dalla loro fonte, accanto all’elenco.
- Non tutti i campi sono sempre presenti: gli attributi dedotti dall’AI possono mancare o essere errati. Shopify chiede di gestire i campi mancanti e le valute di visualizzazione, e di verificare la disponibilità prima di linkare un prodotto.
- Promoted Placements permette di guadagnare commissioni sugli acquisti di articoli trovati dall’app. È in accesso anticipato, con lista d’attesa.
