AgentVitrina documentation

Draft (2026-10-31). Steps match module 0.4.x. AgentVitrina is published at https://rgcglobalnet.com/agentvitrina/. Hosted-plan sales are not open yet.

1. PrestaShop 1.7.8, 8 and 9

Status (module 0.3.2). Module tested on PrestaShop 1.7.8, 8 and 9 on real shops (install, upgrade, configuration, llms.txt, JSON-LD, uninstall). The connection to the hosted service is in beta (catalogue sync and order attribution). As always, try it on a staging copy first. Report issues to contacto@rgcglobalnet.com with your PrestaShop and PHP versions, theme and the message or a screenshot; we reply within 2 business days.

Download agentvitrina-prestashop-0.3.2.zip (sha256 757df5abb1cd0983f537b253efef76ffe412540b680accffa229721c4848edce, SHA256SUMS) (PrestaShop build) from https://rgcglobalnet.com/agentvitrina/download (PrestaShop Addons listing: later).
Back office → Modules → Module Manager → Upload a module → select the ZIP → Configure.
Without an account the module already publishes /agentvitrina/llms.txt and adds schema.org Product JSON-LD (Offer with price, currency, availability and valueAddedTaxIncluded) on product pages. JSON-LD mode: auto (only if your theme has none), standalone (always) or off.
To use the hosted service (EU validator, ACP/UCP/MCP endpoints, attribution), enter your email under Connect and click the link we email you. The module then sends your catalogue; use Sync now after big catalogue changes.
VAT and prices come from your PrestaShop tax rules; AgentVitrina reads them and never changes them.

2. WooCommerce

Requires WordPress 6.5+, WooCommerce 8.0+, PHP 7.4+.

Download agentvitrina-woocommerce-0.4.3.zip (sha256 9fe1d19b73d14fb86c818acb948a7d774b5389d1b6c6d15cc84e3fb5943f4c14, SHA256SUMS) (WooCommerce build) from https://rgcglobalnet.com/agentvitrina/download → Plugins → Add New → Upload plugin → Activate (WordPress.org listing: later).
WooCommerce → AgentVitrina. /agentvitrina/llms.txt and Product JSON-LD (with VAT and shipping details) work straight away; choose the JSON-LD mode if an SEO plugin already outputs Product markup.
Optional: Connect with your email to use the hosted service. The catalogue syncs daily (WP-Cron) and on demand.

3. Generic feed (any platform, e.g. Shopify)

Sign in at https://rgcglobalnet.com/agentvitrina/account and enter your shop URL and a public feed URL: Google Merchant XML/RSS/Atom, Google Merchant CSV/TSV, or Shopify-style /products.json.
Say whether feed prices include VAT (e.g. 21) or are net, plus shop country, language and returns-policy URL.
We fetch it immediately and then every hour (respecting robots.txt and ETag/Last-Modified; max 5 MB, 10 s, public hosts only). Validator errors and warnings appear on your account page.

Limits: products.json has no currency, so EUR is assumed; only the first page is read (add ?limit=250); feeds behind a login are not supported; up to 5,000 products. There is no Shopify app yet: llms.txt and on-page markup on your own domain stay with your platform.

Minimal Google Merchant CSV example:

id,title,description,link,image_link,price,availability,brand
SKU-1,Extra virgin olive oil,500 ml,https://shop.example/p/sku-1,https://shop.example/sku-1.jpg,12.10 EUR,in stock,Mas

Known import limits: HTML in titles/descriptions is stripped to plain text; a g:shipping/g:tax price is not the product price; 1.234,56 EUR is read as 1234.56; empty availability stays unknown (not forced to out_of_stock); preorder becomes pre_order; newlines inside quoted CSV fields are kept.

4. Attribution (no cookies of our own, no pixel)

PrestaShop and WooCommerce: once connected, the module recognises visits from AI assistants (referrer, user agent, utm_source) and reports orders that came from them (order id, amount, currency, agent). No shopper personal data is sent.
Signed links (feed shops): the links in your hosted feeds go through /r?store=…&a=…&to=…&sig=…, which records a visit and redirects to your own page with utm_source=<agent>. It only redirects to your shop's host.
Order webhook (feed shops): your server sends POST /attribution with header X-Ingest-Token: avk_… and {store_id, agent, kind:"order", order_id, amount_cents, currency}. Duplicate order ids are ignored.

5. Hosted endpoints (connected shops)

Served from our domain with ?store=<your store id> (optional &lang=, &country=):

/agentvitrina/llms.txt — store summary for LLMs
/.well-known/ucp — UCP profile
/feed/acp.jsonl — ACP product feed
/jsonld — schema.org Product list
/mcp — MCP catalogue server (JSON-RPC over POST)
/validate — EU validator (final VAT price, Omnibus prior price, GPSR fields)

Your score, pillar by pillar

The free audit splits the 0–100 score into 4 pillars, so you see where you lose points:

AI access (robots.txt for AI bots, llms.txt, sitemap)
Product data (schema.org Product, price with VAT, organisation)
Agent commerce (UCP profile)
Experience (hreflang, speed)

Show your score with a badge: <img src="https://rgcglobalnet.com/agentvitrina/badge.svg?url=your-store.com" alt="AI visibility score">. Our server calculates the score itself — it can't be set by hand. Available once the site is open.

Pro (coming soon): per-agent sales dashboard (orders and revenue per AI assistant) and AI product-data completion (GTIN, attributes; your own key, you review before publishing).

The 0–100 score uses only the weighted checks (robots, llms.txt, Product JSON-LD, VAT, organisation, UCP, sitemap, hreflang, speed). Informational checks (weight 0) — brand, SKU, image URL, availability, plain description, material, seller, reviews, FAQ, a single Product block, duplicate ids, GTIN, and optional files such as /agents.md, ACP JSON, /agent-feed.json, ai-plugin.json or /anthropic.txt when provided — appear on the report but never move the score.

6. What AgentVitrina does not do (yet)

It does not edit robots.txt, generate sitemaps or add hreflang: the free audit tells you what to change by hand.
Serving UCP from /.well-known/ucp on your own domain: coming soon (today it is hosted on ours).
Organization JSON-LD, AI-sales dashboard, multi-store agency dashboard, AI product-data completion: coming soon.
We never process payments; checkout stays with your own payment provider.
No in-chat (ACP Instant) checkout: agents get tracked links to your own product pages, and the purchase happens in your own checkout. ACP and UCP are protocols we follow and prepare for.
Known audit limitation: for shops outside the EU the "offer states VAT" check (10 points) does not apply, but today it counts as passed, so the score can come out up to 10 points too high. After launch, checks that do not apply will be left out of the total.
Known audit limitation: if your shop blocks our bot (firewall/WAF, 403 error) or redirects in a loop, the report shows it as unreachable without saying why. After launch, both cases get their own message.

Methodology: score weights (0-100)

Criterion	Weight
`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

“n/a” criteria (offer_vat outside the EU, hreflang on single-language stores) currently count as passed; see the points above.

Correction example (internal calibration, private web only): masdelacreu.com, 90/100 → 100/100 after adding a valid UCP profile. Linking this on the public site is not yet published by the shop.

7. FAQ

Will ChatGPT or Gemini show my products?: No one can guarantee that. We make your catalogue readable and correct; AI platforms decide what they show.
Does the free audit need an account?: No. The basic score is instant; the full report with fixes is emailed after you confirm your address (double opt-in).
Does blocking GPTBot hide me from ChatGPT search?: No. GPTBot is for training; ChatGPT search uses OAI-SearchBot and ChatGPT-User. The audit checks both groups separately.
Is the audit score exact?: It is automated and indicative: it reads your home page, one product page, robots.txt, llms.txt, the sitemap and /.well-known/ucp from our server.
Do you change my prices or VAT?: No. We read them; the merchant stays responsible for price, VAT, Omnibus and GPSR accuracy.
Prices?: Free; Pro 9 €/month or 90 €/year; Agencies 49 €/month for 10 shops, +3 € per extra shop; Founder 199 € + VAT, 3 years, 100 places, not yet on sale (plus applicable VAT).
Cookies or trackers?: No trackers and no cookies of our own on our site. In your shop, the modules remember which AI assistant sent the visitor inside the shop's existing session (PrestaShop cookie or WooCommerce session) until checkout; no new cookie and no third-party script.

8. Privacy and processors

See the privacy policy and the DPA. Planned sub-processors: Cloudflare, Inc. (hosting, database, edge), Resend, Inc. (transactional email); Paddle [PENDING: payment provider to be confirmed] as merchant of record (independent controller). Final list, countries and safeguards are published before launch.