Documentación de AgentVitrina

Borrador (2026-10-31). Los pasos corresponden al módulo 0.4.x. AgentVitrina está en https://rgcglobalnet.com/agentvitrina/. Las ventas del servicio alojado aún no están abiertas.

1. PrestaShop 1.7.8, 8 y 9

Estado (módulo 0.3.2). Módulo probado en PrestaShop 1.7.8, 8 y 9 en tiendas reales (instalación, actualización, configuración, llms.txt, JSON-LD, desinstalación). La conexión al servicio online está en beta (sincronización del catálogo y atribución de pedidos). Prueba siempre antes en una copia de staging. Envía los problemas a contacto@rgcglobalnet.com con las versiones de PrestaShop y PHP, el tema y el mensaje o una captura; respondemos en 2 días laborables.

Descarga agentvitrina-prestashop-0.3.2.zip (sha256 757df5abb1cd0983f537b253efef76ffe412540b680accffa229721c4848edce, SHA256SUMS) (versión PrestaShop) desde https://rgcglobalnet.com/agentvitrina/download (ficha en PrestaShop Addons: más adelante).
Back office → Módulos → Gestor de módulos → Subir un módulo → elige el ZIP → Configurar.
Sin cuenta, el módulo ya publica /agentvitrina/llms.txt y añade JSON-LD schema.org Product (Offer con precio, moneda, disponibilidad y valueAddedTaxIncluded) en las fichas de producto. Modo JSON-LD: auto (solo si tu tema no lo tiene), standalone (siempre) u off.
Para el servicio alojado (validador UE, endpoints ACP/UCP/MCP, atribución), escribe tu correo en Conectar y pulsa el enlace que te enviamos. El módulo envía entonces tu catálogo; usa Sincronizar ahora tras cambios grandes.
El IVA y los precios salen de tus reglas de impuestos de PrestaShop; AgentVitrina los lee y nunca los cambia.

2. WooCommerce

Requiere WordPress 6.5+, WooCommerce 8.0+ y PHP 7.4+.

Descarga agentvitrina-woocommerce-0.4.3.zip (sha256 9fe1d19b73d14fb86c818acb948a7d774b5389d1b6c6d15cc84e3fb5943f4c14, SHA256SUMS) (versión WooCommerce) desde https://rgcglobalnet.com/agentvitrina/download → Plugins → Añadir nuevo → Subir plugin → Activar (ficha en WordPress.org: más adelante).
WooCommerce → AgentVitrina. /agentvitrina/llms.txt y el JSON-LD Product (con IVA y datos de envío) funcionan al momento; elige el modo JSON-LD si un plugin SEO ya genera marcado Product.
Opcional: Conectar con tu correo para usar el servicio alojado. El catálogo se sincroniza a diario (WP-Cron) y bajo demanda.

3. Feed genérico (cualquier plataforma, p. ej. Shopify)

Entra en https://rgcglobalnet.com/agentvitrina/account e indica la URL de tu tienda y una URL de feed pública: Google Merchant XML/RSS/Atom, Google Merchant CSV/TSV o /products.json estilo Shopify.
Indica si los precios del feed incluyen IVA (p. ej. 21) o son netos, además del país, idioma y URL de la política de devoluciones.
Lo descargamos al momento y luego cada hora (respetando robots.txt y ETag/Last-Modified; máx. 5 MB, 10 s, solo hosts públicos). Los errores y avisos del validador aparecen en tu cuenta.

Límites: products.json no trae moneda, se asume EUR; solo se lee la primera página (añade ?limit=250); no se admiten feeds con login; hasta 5.000 productos. Aún no hay app de Shopify: llms.txt y el marcado en tu propio dominio dependen de tu plataforma.

Ejemplo mínimo de CSV Google Merchant:

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

Límites conocidos del import: el HTML de títulos/descripciones se reduce a texto plano; un precio de g:shipping/g:tax no es el precio del producto; 1.234,56 EUR se lee como 1234,56; una disponibilidad vacía queda unknown (no se fuerza a out_of_stock); preorder pasa a pre_order; los saltos de línea dentro de campos CSV entre comillas se conservan.

4. Atribución (sin cookies propias ni píxel)

PrestaShop y WooCommerce: una vez conectado, el módulo reconoce las visitas de asistentes de IA (referrer, user agent, utm_source) e informa de los pedidos que vienen de ellos (id de pedido, importe, moneda, agente). No se envían datos personales de compradores.
Enlaces firmados (tiendas con feed): los enlaces de tus feeds alojados pasan por /r?store=…&a=…&to=…&sig=…, que registra la visita y redirige a tu página con utm_source=<agente>. Solo redirige al dominio de tu tienda.
Webhook de pedidos (tiendas con feed): tu servidor envía POST /attribution con la cabecera X-Ingest-Token: avk_… y {store_id, agent, kind:"order", order_id, amount_cents, currency}. Los order_id duplicados se ignoran.

5. Endpoints alojados (tiendas conectadas)

Servidos desde nuestro dominio con ?store=<id de tu tienda> (opcional &lang=, &country=):

/agentvitrina/llms.txt — resumen de la tienda para LLM
/.well-known/ucp — perfil UCP
/feed/acp.jsonl — feed de productos ACP
/jsonld — lista schema.org Product
/mcp — servidor MCP del catálogo (JSON-RPC por POST)
/validate — validador UE (precio final con IVA, precio anterior Omnibus, campos GPSR)

Tu puntuación, pilar a pilar

La auditoría gratuita divide la puntuación de 0 a 100 en 4 pilares, para que veas dónde pierdes puntos:

Acceso IA (robots.txt para bots de IA, llms.txt, sitemap)
Datos de producto (schema.org Product, precio con IVA, organización)
Comercio agéntico (perfil UCP)
Experiencia (hreflang, velocidad)

Muestra tu puntuación con una insignia: <img src="https://rgcglobalnet.com/agentvitrina/badge.svg?url=tu-tienda.com" alt="Puntuación de visibilidad IA">. La calcula nuestro servidor; no se puede fijar a mano. Disponible cuando la web esté abierta.

Pro (próximamente): panel de ventas por agente (pedidos e ingresos por asistente IA) y completado de datos de producto con IA (GTIN, atributos; tu propia clave, revisas antes de publicar).

La puntuación 0–100 usa solo las comprobaciones con peso (robots, llms.txt, JSON-LD Product, IVA, organización, UCP, sitemap, hreflang, velocidad). Las comprobaciones informativas (peso 0) — marca, SKU, URL de imagen, disponibilidad, descripción en texto plano, material, vendedor, reseñas, FAQ, un solo bloque Product, ids duplicados, GTIN, y archivos opcionales como /agents.md, JSON ACP, /agent-feed.json, ai-plugin.json o /anthropic.txt si se proporcionan — aparecen en el informe pero no mueven la puntuación.

6. Lo que AgentVitrina (aún) no hace

No edita robots.txt, no genera sitemaps ni añade hreflang: la auditoría gratuita te dice qué cambiar a mano.
Servir UCP desde /.well-known/ucp en tu propio dominio: próximamente (hoy se aloja en el nuestro).
JSON-LD Organization, panel de ventas IA, panel multitienda para agencias, completado de datos de producto con IA: próximamente.
Nunca procesamos pagos; el checkout sigue en tu propio proveedor de pagos.
Sin checkout dentro del chat (ACP Instant): los agentes reciben enlaces con seguimiento a tus páginas de producto y la compra se hace en tu propio checkout. ACP y UCP son protocolos que seguimos y para los que nos preparamos.
Limitación conocida de la auditoría: en tiendas de fuera de la UE el criterio «IVA declarado en la oferta» (10 puntos) no aplica, pero hoy cuenta como superado, así que la puntuación puede salir hasta 10 puntos más alta. Tras el lanzamiento, los criterios que no aplican saldrán del total.
Limitación conocida de la auditoría: si tu tienda bloquea nuestro robot (cortafuegos/WAF, error 403) o redirige en bucle, el informe la muestra como no accesible sin decir el motivo. Tras el lanzamiento, ambos casos tendrán un mensaje propio.

Metodología: pesos de la puntuación (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
Total	100

Los criterios «n/a» (offer_vat fuera de la UE, hreflang en tiendas monolingües) hoy cuentan como superados; ver los puntos anteriores.

Ejemplo de corrección (calibrado interno, solo web privada): masdelacreu.com, 90/100 → 100/100 al añadir un perfil UCP válido. El enlace en la web pública queda aún no se publica en la tienda.

7. Preguntas frecuentes

¿ChatGPT o Gemini mostrarán mis productos?: Nadie puede garantizarlo. Hacemos tu catálogo legible y correcto; las plataformas de IA deciden qué muestran.
¿La auditoría gratuita necesita cuenta?: No. La puntuación básica es inmediata; el informe completo con soluciones se envía tras confirmar tu correo (doble opt-in).
¿Bloquear GPTBot me oculta de la búsqueda de ChatGPT?: No. GPTBot es para entrenamiento; la búsqueda de ChatGPT usa OAI-SearchBot y ChatGPT-User. La auditoría revisa ambos grupos por separado.
¿La puntuación es exacta?: Es automática y orientativa: lee tu portada, una ficha de producto, robots.txt, llms.txt, el sitemap y /.well-known/ucp desde nuestro servidor.
¿Cambiáis mis precios o el IVA?: No. Los leemos; el comerciante sigue siendo responsable de la exactitud de precios, IVA, Omnibus y GPSR.
¿Precios?: Gratis; Pro 9 €/mes o 90 €/año; Agencias 49 €/mes por 10 tiendas, +3 € por tienda adicional; Founder 199 € + IVA, 3 años, 100 plazas, aún no a la venta (más el IVA aplicable).
¿Cookies o rastreadores?: Ningún rastreador ni cookie propia en nuestra web. En tu tienda, los módulos recuerdan qué asistente de IA envió al visitante dentro de la sesión ya existente de la tienda (cookie de PrestaShop o sesión de WooCommerce) hasta el pago; sin cookie nueva ni script de terceros.

8. Privacidad y encargados

Consulta la política de privacidad y el DPA. Subencargados previstos: Cloudflare, Inc. (alojamiento, base de datos, edge), Resend, Inc. (correo transaccional); Paddle [PENDIENTE: proveedor de pago por confirmar] como merchant of record (responsable independiente). La lista final, países y garantías se publican antes del lanzamiento.