KaliCart Bridge · Soluzione tecnica

API prodotti WooCommerce per agenti AI

Esponi un catalogo WooCommerce compatto e in sola lettura per scoperta, ricerca filtrata e verifica del prodotto, senza pubblicare credenziali REST amministrative.

La risposta diretta

KaliCart Bridge pubblica dal dominio del merchant un livello di lettura dei prodotti. Un agente compatibile scopre l’interfaccia, cerca riepiloghi con paginazione controllata e richiede il dettaglio corrente di un prodotto selezionato. Le operazioni di scrittura restano fuori dal contratto.

Perché non consegnare all’agente le REST API WooCommerce?

Le REST API sono un’interfaccia applicativa ampia e normalmente richiedono credenziali. A un agente di acquisto pubblico serve un contratto più piccolo: scoprire, cercare in modo economico, verificare un’offerta e seguire l’URL di acquisto canonico.

Flusso delle richieste

1. Scoperta delle capacità

L’agente legge entry point e indicazioni pubblicate dal negozio.

2. Ricerca di record compatti

Testo, categoria e paginazione restringono i candidati senza caricare il dettaglio completo.

3. Verifica di un candidato

Il finalista viene controllato sui dati correnti di WooCommerce: identità, prezzo, stock e varianti.

4. Rispetto dei segnali

Errori strutturati, limiti e Retry-After indicano come correggere o rinviare la richiesta.

5. Ritorno al negozio canonico

Selezione finale, spedizione, imposte e pagamento avvengono nel percorso del merchant.

Dati pensati per le decisioni di acquisto

SegnaleUtilità per l’agente
Identità stabileID, SKU e URL canonico distinguono i candidati.
ClassificazioneNomi, categorie, brand e attributi supportano ricerca e confronto.
Dati d’offertaPrezzo, valuta e stock riflettono ciò che WooCommerce pubblica ora.
VariantiLa risposta segnala quando serve ancora una scelta esatta.
Confine d’azioneStato di acquisto e link canonici mostrano quando deve intervenire il merchant.

Accesso al catalogo controllato

API, feed e MCP sono livelli diversi

SuperficieUso corretto
Feed prodottiInvio massivo a una piattaforma con formato e aggiornamenti definiti.
API catalogo BridgeScoperta live e verifica selettiva sul dominio del merchant.
Server MCPScoperta e invocazione di strumenti per client compatibili con MCP.
Checkout WooCommerceOpzioni finali, spedizione, imposte, pagamento e transazione.

Soluzioni collegate

Architettura merchant

Commercio agentico per WooCommerce

Inserisci l’API nel percorso completo dalla scoperta al checkout controllato.

Feed di piattaforma

Feed prodotti ChatGPT per WooCommerce

Usa il flusso feed separato quando una piattaforma richiede un catalogo massivo.

Installa Bridge (gratis)Apri la documentazione API

Domande frequenti

L’API richiede chiavi consumer WooCommerce?
No per le rotte pubbliche di lettura del catalogo Bridge. Espongono dati commerciali pubblici e limitati senza concedere autorità amministrativa.
Un agente può aggiornare un prodotto o creare un ordine?
No. L’interfaccia catalogo Bridge è in sola lettura. Amministrazione prodotti e ordini restano fuori dal contratto pubblico.
Un agente può scaricare tutto il catalogo in una richiesta?
No. Ricerca ed elenchi sono paginati e limitati. L’agente deve restringere i candidati e chiedere il dettaglio solo quando serve.
È la stessa cosa di un feed prodotti?
No. Un feed serve all’invio o all’importazione massiva; l’API serve a richieste selettive e correnti sul dominio del merchant.
È un server MCP?
No. È l’interfaccia commerciale in sola lettura utilizzabile da agenti e integrazioni compatibili. KaliCart offre una superficie MCP separata.
Cosa accade quando viene raggiunto il limite?
Il negozio può restituire una risposta di rate limit con indicazioni di riprova. Un agente conforme attende l’intervallo indicato.