Playbook — Lire les avis publiés d’un produit
Public : tous les profils utilisateurs (depuis le 01/09/2026) Connexion : menu Assistant IA (MCP) > Connexion (Claude / Cursor en un clic ; autres assistants via l’URL MCP) Intention : consulter les verbatims déjà publiés d’un produit (pas la file à modérer) Module requis : Trustt Reviews (accès lecture à la marque ; le droit de modération n’est pas requis) Personas primaires : Brand / Product Manager, Marketing Lead
Prompt type
Montre les avis publiés du produit [nom exact OU GTIN OU URL fiche OU UUID produit]
sur la marque [nom]. Format lignes, note ≥ 3, avec photos si possible.
Enchaîne les pages via le curseur tant qu’il reste des avis.
Chaîne d’outils
get_user_brands— retrouver l’identifiant de marque (brand_uuid) si besoinget_product_reviews— page d’avis publiés du produit (note 1–5, modération publiée)- En cas d’ambiguïté produit : reprendre l’appel avec le
product_uuidd’un candidat renvoyé - Pour la page suivante : rappeler
cursor=next_cursortant qu’il n’est pas nul
⚠️ Ne pas confondre avec
get_pending_reviews(file à modérer) ni avecget_brand_catalog_stats(volumes et notes, sans textes d’avis).
Identifiant produit
Exactement un identifiant parmi :
| Paramètre | Règle |
|---|---|
product_name |
Nom exact (égalité stricte, pas de recherche partielle) |
gtin |
GTIN exact |
product_url |
URL de la fiche e-commerce |
product_uuid |
UUID produit (après désambiguïsation) |
Zéro ou plusieurs identifiants → paramètre invalide.
Formats de sortie
| Format | Usage |
|---|---|
lines (défaut) |
Une ligne par avis : date, note, langue, texte ; photos et profil fermé seulement s’ils existent ; dept: NN si la ville est publique |
json |
Champs structurés sans URL photo |
full |
Comme json + URL des photos visibles |
Filtres optionnels courants : min_rating / max_rating, date_from, has_photos, limit (défaut 40, plafond 80 avis).
Contenu exposé (vie privée)
| Exposé par défaut | Non exposé par défaut |
|---|---|
| Texte / titre / critères d’avis, photos visibles | Pseudo, e-mail, nom, adresse, âge calculé depuis la date de naissance |
| Critères de profil fermés (radio, liste, tranche d’âge) | Ville, code postal complet, pays |
| Département (2 premiers chiffres du code postal) si la ville du compte est publique | Lieu si ville privée |
include_author=true (même scope reviews.read) ajoute le pseudo (celui de l’iframe, « Utilisateur vérifié » si l’avis est anonymisé) et la ville, le code postal et le pays lorsque la ville est publique.
La réponse JSON compacte est aussi coupée vers 60 000 caractères : les avis sont ajoutés un par un. Si la page s’arrête avant limit, un curseur reste présent — le rappeler pour la suite. max_body_chars tronque le texte de chaque avis.
Livrable attendu
- Produit résolu (nom, GTIN, URL, UUID)
- Volume total et répartition des notes (1–5) sur le filtre appliqué
- Page d’avis (verbatims) + curseur pour la suite si besoin
- En cas de produit introuvable ou ambigu : message clair, sans inventer d’avis
Garde-fous
| Règle | Détail |
|---|---|
| Lecture seule | Aucune écriture ; pour valider / rejeter → Modération des avis |
| Scope | reviews.read (même scope que la file de modération et les stats catalogue ; grain différent) |
| Trustt AI | Le widget ne précharge pas cet outil : question « avis publiés d’un produit » → pas de verbatims dans Trustt AI |
| Mots-clés « avis en attente » | Dirigent vers get_pending_reviews, pas vers cet outil |
Les schémas et codes d’erreur de get_product_reviews sont fournis à l’assistant par le serveur MCP.
Alternative dans la plateforme
- Modération des avis — file à traiter (pas les verbatims déjà publiés via MCP)
- Statistiques catalogue — volumes et notes sans texte
- Trustt AI — file à modérer en lecture ; pas les textes d’avis publiés d’un produit