Documentazione AgentVitrina

Bozza (2026-10-31). I passaggi corrispondono al modulo 0.4.x. AgentVitrina è pubblicato su https://rgcglobalnet.com/agentvitrina/. Le vendite del servizio ospitato non sono ancora aperte.

1. PrestaShop 1.7.8, 8 e 9

Stato (modulo 0.3.2). Modulo testato su PrestaShop 1.7.8, 8 e 9 in negozi reali (installazione, aggiornamento, configurazione, llms.txt, JSON-LD, disinstallazione). La connessione al servizio online è in beta (sincronizzazione del catalogo e attribuzione degli ordini). Prova sempre prima su una copia di staging. Segnala i problemi a contacto@rgcglobalnet.com con le versioni di PrestaShop e PHP, il tema e il messaggio o uno screenshot; rispondiamo entro 2 giorni lavorativi.

Scarica agentvitrina-prestashop-0.3.2.zip (sha256 757df5abb1cd0983f537b253efef76ffe412540b680accffa229721c4848edce, SHA256SUMS) (versione PrestaShop) da https://rgcglobalnet.com/agentvitrina/download (scheda su PrestaShop Addons: più avanti).
Back office → Moduli → Gestione moduli → Carica un modulo → scegli lo ZIP → Configura.
Senza account il modulo pubblica già /agentvitrina/llms.txt e aggiunge JSON-LD schema.org Product (Offer con prezzo, valuta, disponibilità e valueAddedTaxIncluded) nelle schede prodotto. Modalità JSON-LD: auto (solo se il tema non lo ha), standalone (sempre) o off.
Per il servizio ospitato (validatore UE, endpoint ACP/UCP/MCP, attribuzione), inserisci la tua email in Collega e clicca il link che ti inviamo. Il modulo invia quindi il catalogo; usa Sincronizza ora dopo grandi modifiche.
IVA e prezzi provengono dalle tue regole fiscali PrestaShop; AgentVitrina li legge e non li modifica mai.

2. WooCommerce

Richiede WordPress 6.5+, WooCommerce 8.0+ e PHP 7.4+.

Scarica agentvitrina-woocommerce-0.4.3.zip (sha256 9fe1d19b73d14fb86c818acb948a7d774b5389d1b6c6d15cc84e3fb5943f4c14, SHA256SUMS) (versione WooCommerce) da https://rgcglobalnet.com/agentvitrina/download → Plugin → Aggiungi nuovo → Carica plugin → Attiva (scheda su WordPress.org: più avanti).
WooCommerce → AgentVitrina. /agentvitrina/llms.txt e il JSON-LD Product (con IVA e spedizione) funzionano subito; scegli la modalità JSON-LD se un plugin SEO genera già markup Product.
Facoltativo: Collega con la tua email per il servizio ospitato. Il catalogo si sincronizza ogni giorno (WP-Cron) e su richiesta.

3. Feed generico (qualsiasi piattaforma, es. Shopify)

Accedi a https://rgcglobalnet.com/agentvitrina/account e inserisci l'URL del negozio e un URL di feed pubblico: Google Merchant XML/RSS/Atom, Google Merchant CSV/TSV o /products.json stile Shopify.
Indica se i prezzi del feed includono l'IVA (es. 22) o sono netti, oltre a paese, lingua e URL della politica di reso.
Lo scarichiamo subito e poi ogni ora (rispettando robots.txt ed ETag/Last-Modified; max 5 MB, 10 s, solo host pubblici). Errori e avvisi del validatore compaiono nel tuo account.

Limiti: products.json non ha valuta, si assume EUR; viene letta solo la prima pagina (aggiungi ?limit=250); feed con login non supportati; fino a 5.000 prodotti. Non c'è ancora un'app Shopify: llms.txt e il markup sul tuo dominio restano gestiti dalla tua piattaforma.

Esempio minimo di CSV Google Merchant:

id,title,description,link,image_link,price,availability,brand
SKU-1,Olio extravergine di oliva,500 ml,https://shop.example/p/sku-1,https://shop.example/sku-1.jpg,12.10 EUR,in stock,Mas

Limiti noti dell'import: l'HTML di titoli/descrizioni è ridotto a testo semplice; un prezzo g:shipping/g:tax non è il prezzo del prodotto; 1.234,56 EUR è letto come 1234,56; una disponibilità vuota resta unknown (non forzata a out_of_stock); preorder diventa pre_order; gli a capo nei campi CSV tra virgolette sono conservati.

4. Attribuzione (senza cookie propri né pixel)

PrestaShop e WooCommerce: una volta collegato, il modulo riconosce le visite degli assistenti IA (referrer, user agent, utm_source) e segnala gli ordini che ne derivano (id ordine, importo, valuta, agente). Nessun dato personale degli acquirenti viene inviato.
Link firmati (negozi con feed): i link dei feed ospitati passano per /r?store=…&a=…&to=…&sig=…, che registra la visita e reindirizza alla tua pagina con utm_source=<agente>. Reindirizza solo al dominio del tuo negozio.
Webhook ordini (negozi con feed): il tuo server invia POST /attribution con l'header X-Ingest-Token: avk_… e {store_id, agent, kind:"order", order_id, amount_cents, currency}. Gli order_id duplicati vengono ignorati.

5. Endpoint ospitati (negozi collegati)

Serviti dal nostro dominio con ?store=<id del negozio> (facoltativo &lang=, &country=):

/agentvitrina/llms.txt — riepilogo del negozio per LLM
/.well-known/ucp — profilo UCP
/feed/acp.jsonl — feed prodotti ACP
/jsonld — elenco schema.org Product
/mcp — server MCP del catalogo (JSON-RPC via POST)
/validate — validatore UE (prezzo finale con IVA, prezzo precedente Omnibus, campi GPSR)

Il tuo punteggio, pilastro per pilastro

L’audit gratuito divide il punteggio da 0 a 100 in 4 pilastri, così vedi dove perdi punti:

Accesso IA (robots.txt per i bot IA, llms.txt, sitemap)
Dati prodotto (schema.org Product, prezzo IVA inclusa, organizzazione)
Commercio agentico (profilo UCP)
Esperienza (hreflang, velocità)

Mostra il tuo punteggio con un badge: <img src="https://rgcglobalnet.com/agentvitrina/badge.svg?url=tuo-negozio.it" alt="Punteggio di visibilità IA">. Lo calcola il nostro server; non si può impostare a mano. Disponibile all’apertura del sito.

Pro (in arrivo): dashboard vendite per agente (ordini e ricavi per assistente IA) e completamento dei dati prodotto con IA (GTIN, attributi; la tua chiave, revisioni prima di pubblicare).

Il punteggio 0–100 usa solo i controlli con peso (robots, llms.txt, JSON-LD Product, IVA, organizzazione, UCP, sitemap, hreflang, velocità). I controlli informativi (peso 0) — marca, SKU, URL immagine, disponibilità, descrizione in testo semplice, materiale, venditore, recensioni, FAQ, un solo blocco Product, id duplicati, GTIN, e file opzionali come /agents.md, JSON ACP, /agent-feed.json, ai-plugin.json o /anthropic.txt se forniti — compaiono nel report ma non spostano il punteggio.

6. Cosa AgentVitrina non fa (ancora)

Non modifica robots.txt, non genera sitemap e non aggiunge hreflang: l'audit gratuito ti dice cosa cambiare a mano.
Servire UCP da /.well-known/ucp sul tuo dominio: in arrivo (oggi è ospitato sul nostro).
JSON-LD Organization, dashboard vendite IA, dashboard multi-negozio per agenzie, completamento dati prodotto con IA: in arrivo.
Non elaboriamo mai pagamenti; il checkout resta presso il tuo fornitore di pagamenti.
Nessun checkout dentro la chat (ACP Instant): gli agenti ricevono link tracciati alle tue pagine prodotto e l'acquisto avviene nel tuo checkout. ACP e UCP sono protocolli che seguiamo e per cui ci prepariamo.
Limite noto dell'audit: per i negozi fuori dall'UE il criterio «IVA indicata nell'offerta» (10 punti) non si applica, ma oggi conta come superato, quindi il punteggio può risultare fino a 10 punti più alto. Dopo il lancio, i criteri non applicabili usciranno dal totale.
Limite noto dell'audit: se il tuo negozio blocca il nostro bot (firewall/WAF, errore 403) o reindirizza in loop, il report lo mostra come non raggiungibile senza dire il motivo. Dopo il lancio, entrambi i casi avranno un messaggio dedicato.

Metodologia: pesi del punteggio (0-100)

Criterio	Peso
`robots_ai_search`	20
`robots_ai_training`	5
`llms_txt`	15
`jsonld_product`	20
`offer_vat`	10
`jsonld_org`	5
`ucp_profile`	10
`sitemap`	5
`hreflang`	5
`speed`	5
Totale	100

I criteri «n/a» (offer_vat fuori dall'UE, hreflang nei negozi monolingue) oggi contano come superati; vedi i punti sopra.

Esempio di correzione (calibrazione interna, solo sito privato): masdelacreu.com, 90/100 → 100/100 dopo l'aggiunta di un profilo UCP valido. Il collegamento sul sito pubblico resta non è ancora pubblicato sul negozio.

7. FAQ

ChatGPT o Gemini mostreranno i miei prodotti?: Nessuno può garantirlo. Rendiamo il catalogo leggibile e corretto; le piattaforme IA decidono cosa mostrare.
L'audit gratuito richiede un account?: No. Il punteggio base è immediato; il report completo con le correzioni arriva dopo la conferma dell'email (doppio opt-in).
Bloccare GPTBot mi nasconde dalla ricerca di ChatGPT?: No. GPTBot serve per l'addestramento; la ricerca di ChatGPT usa OAI-SearchBot e ChatGPT-User. L'audit controlla i due gruppi separatamente.
Il punteggio è esatto?: È automatico e indicativo: legge home, una scheda prodotto, robots.txt, llms.txt, la sitemap e /.well-known/ucp dal nostro server.
Modificate i miei prezzi o l'IVA?: No. Li leggiamo; il commerciante resta responsabile dell'esattezza di prezzi, IVA, Omnibus e GPSR.
Prezzi?: Gratis; Pro 9 €/mese o 90 €/anno; Agenzie 49 €/mese per 10 negozi, +3 € per negozio aggiuntivo; Founder 199 € + IVA, 3 anni, 100 posti, non ancora in vendita (più IVA applicabile).
Cookie o tracker?: Nessun tracker né cookie proprio sul nostro sito. Nel tuo negozio, i moduli ricordano quale assistente IA ha inviato il visitatore nella sessione già esistente del negozio (cookie PrestaShop o sessione WooCommerce) fino al checkout; nessun nuovo cookie né script di terzi.

8. Privacy e responsabili del trattamento

Vedi l'informativa privacy e il DPA. Sub-responsabili previsti: Cloudflare, Inc. (hosting, database, edge), Resend, Inc. (email transazionali); Paddle [IN SOSPESO: fornitore di pagamento da confermare] come merchant of record (titolare autonomo). Elenco definitivo, paesi e garanzie saranno pubblicati prima del lancio.