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
| Segnale | Utilità per l’agente |
|---|---|
| Identità stabile | ID, SKU e URL canonico distinguono i candidati. |
| Classificazione | Nomi, categorie, brand e attributi supportano ricerca e confronto. |
| Dati d’offerta | Prezzo, valuta e stock riflettono ciò che WooCommerce pubblica ora. |
| Varianti | La risposta segnala quando serve ancora una scelta esatta. |
| Confine d’azione | Stato di acquisto e link canonici mostrano quando deve intervenire il merchant. |
Accesso al catalogo controllato
- Superficie pubblica in sola lettura, senza endpoint per clienti, ordini o amministrazione.
- Paginazione e dimensione massima impediscono richieste dell’intero catalogo.
- Riepiloghi compatti riducono token, banda e lavoro del server.
- I segnali di rate limit consentono di attendere e riprovare.
- WooCommerce resta la fonte autorevole per i dati commerciali correnti.
API, feed e MCP sono livelli diversi
| Superficie | Uso corretto |
|---|---|
| Feed prodotti | Invio massivo a una piattaforma con formato e aggiornamenti definiti. |
| API catalogo Bridge | Scoperta live e verifica selettiva sul dominio del merchant. |
| Server MCP | Scoperta e invocazione di strumenti per client compatibili con MCP. |
| Checkout WooCommerce | Opzioni finali, spedizione, imposte, pagamento e transazione. |
Soluzioni collegate
Commercio agentico per WooCommerce
Inserisci l’API nel percorso completo dalla scoperta al checkout controllato.
Feed di piattaformaFeed prodotti ChatGPT per WooCommerce
Usa il flusso feed separato quando una piattaforma richiede un catalogo massivo.
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.
