Documentació d'AgentVitrina

Esborrany (2026-10-31). Els passos corresponen al mòdul 0.4.x. AgentVitrina és a https://rgcglobalnet.com/agentvitrina/. Les vendes del servei allotjat encara no són obertes.

1. PrestaShop 1.7.8, 8 i 9

Estat (mòdul 0.3.2). Mòdul provat a PrestaShop 1.7.8, 8 i 9 en botigues reals (instal·lació, actualització, configuració, llms.txt, JSON-LD, desinstal·lació). La connexió al servei en línia és beta (sincronització del catàleg i atribució de comandes). Fes sempre una prova en una còpia de staging. Envia els problemes a contacto@rgcglobalnet.com amb les versions de PrestaShop i PHP, el tema i el missatge o una captura; responem en 2 dies laborables.

1. Descarrega agentvitrina-prestashop-0.3.2.zip (sha256 757df5abb1cd0983f537b253efef76ffe412540b680accffa229721c4848edce, SHA256SUMS) (versió PrestaShop) des de https://rgcglobalnet.com/agentvitrina/download (fitxa a PrestaShop Addons: més endavant).
2. Back office → Mòduls → Gestor de mòduls → Puja un mòdul → tria el ZIP → Configura.
3. Sense compte, el mòdul ja publica /agentvitrina/llms.txt i afegeix JSON-LD schema.org Product (Offer amb preu, moneda, disponibilitat i valueAddedTaxIncluded) a les fitxes de producte. Mode JSON-LD: auto (només si el tema no en té), standalone (sempre) o off.
4. Per al servei allotjat (validador UE, endpoints ACP/UCP/MCP, atribució), escriu el teu correu a Connecta i fes clic a l'enllaç que t'enviem. Llavors el mòdul envia el catàleg; fes servir Sincronitza ara després de canvis grans.
5. L'IVA i els preus surten de les teves regles d'impostos de PrestaShop; AgentVitrina els llegeix i no els canvia mai.

2. WooCommerce

Requereix WordPress 6.5+, WooCommerce 8.0+ i PHP 7.4+.

1. Descarrega agentvitrina-woocommerce-0.4.3.zip (sha256 9fe1d19b73d14fb86c818acb948a7d774b5389d1b6c6d15cc84e3fb5943f4c14, SHA256SUMS) (versió WooCommerce) des de https://rgcglobalnet.com/agentvitrina/download → Extensions → Afegeix → Puja una extensió → Activa (fitxa a WordPress.org: més endavant).
2. WooCommerce → AgentVitrina. /agentvitrina/llms.txt i el JSON-LD Product (amb IVA i enviament) funcionen de seguida; tria el mode JSON-LD si un plugin SEO ja genera marcatge Product.
3. Opcional: Connecta amb el teu correu per fer servir el servei allotjat. El catàleg se sincronitza cada dia (WP-Cron) i a demanda.

3. Feed genèric (qualsevol plataforma, p. ex. Shopify)

1. Entra a https://rgcglobalnet.com/agentvitrina/account i indica l'URL de la botiga i una URL de feed pública: Google Merchant XML/RSS/Atom, Google Merchant CSV/TSV o /products.json estil Shopify.
2. Indica si els preus del feed inclouen IVA (p. ex. 21) o són nets, a més del país, l'idioma i l'URL de la política de devolucions.
3. El descarreguem a l'instant i després cada hora (respectant robots.txt i ETag/Last-Modified; màx. 5 MB, 10 s, només hosts públics). Els errors i avisos del validador surten al teu compte.

Límits: products.json no porta moneda, s'assumeix EUR; només es llegeix la primera pàgina (afegeix ?limit=250); no s'admeten feeds amb login; fins a 5.000 productes. Encara no hi ha app de Shopify: llms.txt i el marcatge al teu propi domini depenen de la teva plataforma.

Exemple mínim de CSV Google Merchant:

id,title,description,link,image_link,price,availability,brand
SKU-1,Oli d'oliva verge extra,500 ml,https://shop.example/p/sku-1,https://shop.example/sku-1.jpg,12.10 EUR,in stock,Mas

Límits coneguts de l'import: l'HTML de títols/descripcions es redueix a text pla; un preu de g:shipping/g:tax no és el preu del producte; 1.234,56 EUR es llegeix com 1234,56; una disponibilitat buida resta unknown (no es força a out_of_stock); preorder esdevé pre_order; els salts de línia dins de camps CSV entre cometes es conserven.

4. Atribució (sense galetes pròpies ni píxel)

• PrestaShop i WooCommerce: un cop connectat, el mòdul reconeix les visites d'assistents d'IA (referrer, user agent, utm_source) i informa de les comandes que en vénen (id de comanda, import, moneda, agent). No s'envien dades personals de compradors.
• Enllaços signats (botigues amb feed): els enllaços dels feeds allotjats passen per /r?store=…&a=…&to=…&sig=…, que registra la visita i redirigeix a la teva pàgina amb utm_source=<agent>. Només redirigeix al domini de la teva botiga.
• Webhook de comandes (botigues amb feed): el teu servidor envia POST /attribution amb la capçalera X-Ingest-Token: avk_… i {store_id, agent, kind:"order", order_id, amount_cents, currency}. Els order_id duplicats s'ignoren.

5. Endpoints allotjats (botigues connectades)

Servits des del nostre domini amb ?store=<id de la botiga> (opcional &lang=, &country=):

• /agentvitrina/llms.txt — resum de la botiga per a LLM
• /.well-known/ucp — perfil UCP
• /feed/acp.jsonl — feed de productes ACP
• /jsonld — llista schema.org Product
• /mcp — servidor MCP del catàleg (JSON-RPC per POST)
• /validate — validador UE (preu final amb IVA, preu anterior Omnibus, camps GPSR)

La teva puntuació, pilar a pilar

L’auditoria gratuïta divideix la puntuació de 0 a 100 en 4 pilars, perquè vegis on perds punts:

1. Accés IA (robots.txt per a bots d’IA, llms.txt, sitemap)
2. Dades de producte (schema.org Product, preu amb IVA, organització)
3. Comerç agèntic (perfil UCP)
4. Experiència (hreflang, velocitat)

Mostra la teva puntuació amb una insígnia: <img src="https://rgcglobalnet.com/agentvitrina/badge.svg?url=la-teva-botiga.cat" alt="Puntuació de visibilitat IA">. La calcula el nostre servidor; no es pot fixar a mà. Disponible quan la web estigui oberta.

Pro (aviat): tauler de vendes per agent (comandes i ingressos per assistent d’IA) i completat de dades de producte amb IA (GTIN, atributs; la teva clau, revises abans de publicar).

La puntuació 0–100 usa només els checks amb pes (robots, llms.txt, JSON-LD Product, IVA, organització, UCP, sitemap, hreflang, velocitat). Els checks informatius (pes 0) — marca, SKU, URL d'imatge, disponibilitat, descripció en text pla, material, venedor, ressenyes, FAQ, un sol bloc Product, ids duplicats, GTIN, i fitxers opcionals com /agents.md, JSON ACP, /agent-feed.json, ai-plugin.json o /anthropic.txt si es proporcionen — surten a l'informe però no mouen la puntuació.

6. El que AgentVitrina (encara) no fa

• No edita robots.txt, no genera sitemaps ni afegeix hreflang: l'auditoria gratuïta et diu què canviar a mà.
• Servir UCP des de /.well-known/ucp al teu propi domini: properament (avui s'allotja al nostre).
• JSON-LD Organization, tauler de vendes IA, tauler multibotiga per a agències, completat de dades de producte amb IA: properament.
• Mai no processem pagaments; el checkout continua al teu propi proveïdor de pagaments.
• Sense checkout dins el xat (ACP Instant): els agents reben enllaços amb seguiment a les teves fitxes de producte i la compra es fa al teu propi checkout. ACP i UCP són protocols que seguim i per als quals ens preparem.
• Limitació coneguda de l'auditoria: a les botigues de fora de la UE el criteri «IVA declarat a l'oferta» (10 punts) no aplica, però avui compta com a superat, de manera que la puntuació pot sortir fins a 10 punts més alta. Després del llançament, els criteris que no apliquen sortiran del total.
• Limitació coneguda de l'auditoria: si la teva botiga bloqueja el nostre robot (tallafoc/WAF, error 403) o fa una redirecció en bucle, l'informe la mostra com a no accessible sense dir-ne el motiu. Després del llançament, tots dos casos tindran un missatge propi.

Metodologia: pesos de la puntuació (0-100)

Criteris «n/a» (offer_vat fora de la UE, hreflang en botigues monolingües) avui compten com a superats; vegeu els punts anteriors.

Exemple de correcció (calibratge intern, només web privada): masdelacreu.com, 90/100 → 100/100 en afegir un perfil UCP vàlid. L'enllaç a la web pública queda encara no es publica a la botiga.

7. Preguntes freqüents

ChatGPT o Gemini mostraran els meus productes?

Ningú no ho pot garantir. Fem el teu catàleg llegible i correcte; les plataformes d'IA decideixen què mostren.

L'auditoria gratuïta necessita compte?

No. La puntuació bàsica és immediata; l'informe complet amb solucions s'envia després de confirmar el correu (doble opt-in).

Bloquejar GPTBot m'amaga de la cerca de ChatGPT?

No. GPTBot és per a entrenament; la cerca de ChatGPT fa servir OAI-SearchBot i ChatGPT-User. L'auditoria revisa els dos grups per separat.

La puntuació és exacta?

És automàtica i orientativa: llegeix la portada, una fitxa de producte, robots.txt, llms.txt, el sitemap i /.well-known/ucp des del nostre servidor.

Canvieu els meus preus o l'IVA?

No. Els llegim; el comerciant continua sent responsable de l'exactitud de preus, IVA, Omnibus i GPSR.

Preus?

Gratuït; Pro 9 €/mes o 90 €/any; Agències 49 €/mes per 10 botigues, +3 € per botiga addicional; Founder 199 € + IVA, 3 anys, 100 places, encara no a la venda (més l'IVA aplicable).

Galetes o rastrejadors?

Cap rastrejador ni galeta pròpia al nostre web. A la teva botiga, els mòduls recorden quin assistent d'IA ha enviat el visitant dins la sessió ja existent de la botiga (galeta de PrestaShop o sessió de WooCommerce) fins al pagament; cap galeta nova ni script de tercers.

8. Privacitat i encarregats

Consulta la política de privacitat i el DPA. Subencarregats previstos: Cloudflare, Inc. (allotjament, base de dades, edge), Resend, Inc. (correu transaccional); Paddle [PENDENT: proveïdor de pagament per confirmar] com a merchant of record (responsable independent). La llista final, països i garanties es publiquen abans del llançament.