Documentation AgentVitrina

Brouillon (2026-10-31). Les étapes correspondent au module 0.4.x. AgentVitrina est publié sur https://rgcglobalnet.com/agentvitrina/. Les ventes du service hébergé ne sont pas encore ouvertes.

1. PrestaShop 1.7.8, 8 et 9

État (module 0.3.2). Module testé sur PrestaShop 1.7.8, 8 et 9 sur de vraies boutiques (installation, mise à jour, configuration, llms.txt, JSON-LD, désinstallation). La connexion au service en ligne est en bêta (synchronisation du catalogue et attribution des commandes). Testez toujours d'abord sur une copie de préproduction. Signalez les problèmes à contacto@rgcglobalnet.com avec vos versions de PrestaShop et de PHP, le thème et le message ou une capture ; réponse sous 2 jours ouvrés.

Téléchargez agentvitrina-prestashop-0.3.2.zip (sha256 757df5abb1cd0983f537b253efef76ffe412540b680accffa229721c4848edce, SHA256SUMS) (version PrestaShop) depuis https://rgcglobalnet.com/agentvitrina/download (fiche PrestaShop Addons : plus tard).
Back-office → Modules → Gestionnaire de modules → Installer un module → choisissez le ZIP → Configurer.
Sans compte, le module publie déjà /agentvitrina/llms.txt et ajoute du JSON-LD schema.org Product (Offer avec prix, devise, disponibilité et valueAddedTaxIncluded) sur les fiches produit. Mode JSON-LD : auto (seulement si votre thème n'en a pas), standalone (toujours) ou off.
Pour le service hébergé (validateur UE, endpoints ACP/UCP/MCP, attribution), saisissez votre e-mail sous Connecter et cliquez sur le lien reçu. Le module envoie alors votre catalogue ; utilisez Synchroniser après de gros changements.
La TVA et les prix viennent de vos règles de taxes PrestaShop ; AgentVitrina les lit et ne les modifie jamais.

2. WooCommerce

Nécessite WordPress 6.5+, WooCommerce 8.0+ et PHP 7.4+.

Téléchargez agentvitrina-woocommerce-0.4.3.zip (sha256 9fe1d19b73d14fb86c818acb948a7d774b5389d1b6c6d15cc84e3fb5943f4c14, SHA256SUMS) (version WooCommerce) depuis https://rgcglobalnet.com/agentvitrina/download → Extensions → Ajouter → Téléverser une extension → Activer (fiche WordPress.org : plus tard).
WooCommerce → AgentVitrina. /agentvitrina/llms.txt et le JSON-LD Product (avec TVA et livraison) fonctionnent tout de suite ; choisissez le mode JSON-LD si une extension SEO produit déjà du balisage Product.
Facultatif : Connecter avec votre e-mail pour le service hébergé. Le catalogue se synchronise chaque jour (WP-Cron) et à la demande.

3. Flux générique (toute plateforme, p. ex. Shopify)

Connectez-vous sur https://rgcglobalnet.com/agentvitrina/account et indiquez l'URL de la boutique et une URL de flux publique : Google Merchant XML/RSS/Atom, Google Merchant CSV/TSV ou /products.json type Shopify.
Indiquez si les prix du flux sont TTC (p. ex. 21) ou HT, ainsi que le pays, la langue et l'URL de la politique de retour.
Nous le récupérons immédiatement puis toutes les heures (en respectant robots.txt et ETag/Last-Modified ; max. 5 Mo, 10 s, hôtes publics uniquement). Les erreurs et avertissements du validateur apparaissent dans votre compte.

Limites : products.json n'a pas de devise, l'EUR est supposé ; seule la première page est lue (ajoutez ?limit=250) ; pas de flux derrière un login ; jusqu'à 5 000 produits. Pas encore d'app Shopify : llms.txt et le balisage sur votre propre domaine restent gérés par votre plateforme.

Exemple minimal de CSV Google Merchant :

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

Limites connues de l'import : le HTML des titres/descriptions est réduit en texte brut ; un prix g:shipping/g:tax n'est pas le prix du produit ; 1.234,56 EUR est lu comme 1234,56 ; une disponibilité vide reste unknown (pas forcée à out_of_stock) ; preorder devient pre_order ; les retours à la ligne dans les champs CSV entre guillemets sont conservés.

4. Attribution (sans cookie propre ni pixel)

PrestaShop et WooCommerce : une fois connecté, le module reconnaît les visites des assistants IA (referrer, user agent, utm_source) et remonte les commandes qui en proviennent (id, montant, devise, agent). Aucune donnée personnelle d'acheteur n'est envoyée.
Liens signés (boutiques par flux) : les liens de vos flux hébergés passent par /r?store=…&a=…&to=…&sig=…, qui enregistre la visite et redirige vers votre page avec utm_source=<agent>. Redirection uniquement vers le domaine de votre boutique.
Webhook de commande (boutiques par flux) : votre serveur envoie POST /attribution avec l'en-tête X-Ingest-Token: avk_… et {store_id, agent, kind:"order", order_id, amount_cents, currency}. Les order_id en double sont ignorés.

5. Endpoints hébergés (boutiques connectées)

Servis depuis notre domaine avec ?store=<id de votre boutique> (facultatif &lang=, &country=) :

/agentvitrina/llms.txt — résumé de la boutique pour les LLM
/.well-known/ucp — profil UCP
/feed/acp.jsonl — flux produits ACP
/jsonld — liste schema.org Product
/mcp — serveur MCP du catalogue (JSON-RPC en POST)
/validate — validateur UE (prix final TTC, prix antérieur Omnibus, champs GPSR)

Votre score, pilier par pilier

L’audit gratuit découpe le score de 0 à 100 en 4 piliers, pour voir où vous perdez des points :

Accès IA (robots.txt pour les robots IA, llms.txt, sitemap)
Données produit (schema.org Product, prix TTC, organisation)
Commerce agentique (profil UCP)
Expérience (hreflang, vitesse)

Affichez votre score avec un badge : <img src="https://rgcglobalnet.com/agentvitrina/badge.svg?url=votre-boutique.fr" alt="Score de visibilité IA">. Le score est calculé par notre serveur ; impossible de le fixer à la main. Disponible à l’ouverture du site.

Pro (bientôt) : tableau des ventes par agent (commandes et CA par assistant IA) et complétion des données produit par IA (GTIN, attributs ; votre propre clé, vous validez avant publication).

Le score 0–100 n'utilise que les contrôles pondérés (robots, llms.txt, JSON-LD Product, TVA, organisation, UCP, sitemap, hreflang, vitesse). Les contrôles informatifs (poids 0) — marque, SKU, URL d'image, disponibilité, description en texte brut, matière, vendeur, avis, FAQ, un seul bloc Product, identifiants en double, GTIN, et fichiers optionnels tels que /agents.md, JSON ACP, /agent-feed.json, ai-plugin.json ou /anthropic.txt lorsqu'ils sont fournis — figurent dans le rapport mais ne déplacent pas le score.

6. Ce qu'AgentVitrina ne fait pas (encore)

Il ne modifie pas robots.txt, ne génère pas de sitemap et n'ajoute pas de hreflang : l'audit gratuit vous dit quoi changer à la main.
Servir UCP depuis /.well-known/ucp sur votre propre domaine : bientôt (hébergé chez nous aujourd'hui).
JSON-LD Organization, tableau de bord des ventes IA, tableau multi-boutiques pour agences, complétion des données produit par IA : bientôt.
Nous ne traitons jamais les paiements ; le paiement reste chez votre propre prestataire.
Pas de paiement dans le chat (ACP Instant) : les agents reçoivent des liens suivis vers vos fiches produit, et l'achat se fait dans votre propre paiement. ACP et UCP sont des protocoles que nous suivons et pour lesquels nous nous préparons.
Limite connue de l'audit : pour les boutiques hors UE, le critère « TVA indiquée dans l'offre » (10 points) ne s'applique pas mais compte aujourd'hui comme réussi : le score peut être jusqu'à 10 points trop élevé. Après le lancement, les critères non applicables sortiront du total.
Limite connue de l'audit : si votre boutique bloque notre robot (pare-feu/WAF, erreur 403) ou redirige en boucle, le rapport l'indique comme inaccessible sans en donner la raison. Après le lancement, chaque cas aura son propre message.

Méthodologie : pondération du score (0-100)

Critère	Poids
`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

Les critères « n/a » (offer_vat hors UE, hreflang pour les boutiques monolingues) comptent aujourd'hui comme réussis ; voir les points ci-dessus.

Exemple de correction (calibrage interne, site privé uniquement) : masdelacreu.com, 90/100 → 100/100 après ajout d'un profil UCP valide. Le lien sur le site public reste n'est pas encore publié sur la boutique.

7. FAQ

ChatGPT ou Gemini afficheront-ils mes produits ?: Personne ne peut le garantir. Nous rendons votre catalogue lisible et correct ; les plateformes IA décident de ce qu'elles affichent.
L'audit gratuit nécessite-t-il un compte ?: Non. Le score de base est immédiat ; le rapport complet avec corrections est envoyé après confirmation de votre e-mail (double opt-in).
Bloquer GPTBot me cache-t-il de la recherche ChatGPT ?: Non. GPTBot sert à l'entraînement ; la recherche ChatGPT utilise OAI-SearchBot et ChatGPT-User. L'audit vérifie les deux groupes séparément.
Le score est-il exact ?: Il est automatique et indicatif : il lit votre accueil, une fiche produit, robots.txt, llms.txt, le sitemap et /.well-known/ucp depuis notre serveur.
Modifiez-vous mes prix ou la TVA ?: Non. Nous les lisons ; le marchand reste responsable de l'exactitude des prix, de la TVA, d'Omnibus et du GPSR.
Tarifs ?: Gratuit ; Pro 9 €/mois ou 90 €/an ; Agences 49 €/mois pour 10 boutiques, +3 € par boutique supplémentaire ; Founder 199 € HT, 3 ans, 100 places, pas encore en vente (TVA applicable en sus).
Cookies ou traceurs ?: Aucun traceur ni cookie propre sur notre site. Dans votre boutique, les modules mémorisent quel assistant IA a envoyé le visiteur dans la session existante de la boutique (cookie PrestaShop ou session WooCommerce) jusqu'au paiement ; aucun nouveau cookie ni script tiers.

8. Confidentialité et sous-traitants

Voir la politique de confidentialité et le DPA. Sous-traitants prévus : Cloudflare, Inc. (hébergement, base de données, edge), Resend, Inc. (e-mail transactionnel) ; Paddle [EN ATTENTE : prestataire de paiement à confirmer] comme merchant of record (responsable indépendant). La liste finale, les pays et les garanties seront publiés avant le lancement.