Statut : version active depuis le 16/08/2026. Remplace le jugement par raisonnement libre décrit dans
SOP_Juge_Produit.md(qui reste la référence/secours, voir bannière en tête de ce fichier). Construit initialement pendant une session où Claude Code était à quota (Antigravity/Claude ont posé les scripts), complété et testé en conditions réelles le 16/08/2026 (correction de 2 bugs de code + un bug de fond sur le Tracker, puis re-jugement réel de 19 produits).
Contrairement à SOP_Juge_Produit.md (un agent lit le texte de la procédure et se discipline lui-même),
ici c'est le code qui refuse mécaniquement d'accepter un verdict non conforme :
- Marge (filtre 2.2) et note fournisseur (filtre 2.3) sont calculées automatiquement depuis les
colonnes réelles du Tracker (Col G, Col J) — jamais estimées par l'IA, jamais invoquées de tête.
- Les filtres qualitatifs (2.1, 2.4, 2.5, 2.6, 2.7) exigent une preuve textuelle non vide avant que
le script n'accepte d'écrire le verdict — impossible de sauter une étape par oubli.
- Le filtrage reste séquentiel (arrêt au premier échec), identique en logique à l'ancienne SOP.
tools/)juge_produit_orchestrateur.py — point d'entrée. row --row N : vérifie l'éligibilitéall : liste tous les produits éligibles et traite le premier (design définitif, pas une limitation--dry-run (avant ou après la sous-commande) : aucune écriture, pour revue groupée.competitive_researcher.py — collecte brute (Amazon.fr, Google Shopping FR, avis AliExpress).scraping_blocked: true) plutôt que de planter.product_judge.py — check-eligible --row N puis verdict --row N avec les arguments :--marque-statut aucune_ambiguite|incertaine_d2c|majeure_mondiale --preuve-marque "..."--filtre-2-1 pass|fail --preuve-2-1 "..." (Anti-Dinosaure), --avis-clients "..."--filtre-2-4/--justif-2-4--filtre-2-5/--justif-2-5 (Conscience client),--filtre-2-6/--citation-2-6/--url-2-6 (Red Flags avis, verbatim + URL obligatoires),--levier-2-7 (différenciation). Écrit Col R (statut) + Col X (commentaire du coach, jamais T/U),verdict-reserve (ajoutée 18/08/2026, demande Raphael) — voir sectionaudit_report_generator.py — dashboard HTML unique et persistantrapport_audit_dashboard.html, jamais un fichier par produit) : add --row N après un verdict,regenerate pour tout reconstruire depuis le Sheet, send-telegram. Le lien est inscritContexte : la mission chasse-2produits-20260818 a confirmé un vrai goulot d'étranglement — sur 25 candidats évalués, un seul a passé le filtre painkiller/prix, et son sourcing a échoué (matching image Minea + panne RapidAPI confirmée). Le VERROU ANTI-FABRICATION empêchait jusqu'ici TOUT jugement sans Prix d'achat rempli, même quand le produit avait par ailleurs un vrai potentiel (bon painkiller, marché non saturé, angle marketing solide) — perdant ce signal utile.
Constat qui a débloqué l'idée : sur les 7 filtres, seuls 2.2 (Marge) et 2.3 (Note fournisseur) dépendent réellement des données de sourcing. Les 5 autres (2.1 Saturation, 2.4 Audit marketing, 2.5 Conscience client, 2.6 Red flags avis, 2.7 Levier de différenciation) reposent sur de la recherche marché indépendante de notre fournisseur.
Nouvelle commande : product_judge.py verdict-reserve --row N — mêmes arguments qualitatifs que verdict (2.1, avis-clients, 2.4 à 2.7), sans --filtre-2-2/--filtre-2-3 qui n'existent pas dans cette commande.
Verrou d'éligibilité DISTINCT et STRICT (_eligibility_reserve(), ne touche jamais au verrou de verdict classique) :
- Statut doit être EXACTEMENT À sourcer (pas "À tester" — un candidat jamais sourcé n'est PAS éligible à la réserve, ce serait sauter l'étape, pas geler un échec réel).
- Prix d'achat (Col E) doit être vide.
- Col S (notes sourcing) doit être NON vide — preuve qu'un vrai sourcing a été tenté et documenté, jamais une réserve "par défaut" sur une ligne jamais travaillée.
Comportement du verdict :
- Si 2.1, 2.4, 2.5, 2.6 ou 2.7 échoue : verdict DISQUALIFIÉ normal (une vraie disqualification tient, sourcing ou pas).
- Si les 5 passent : Col R = Réserve (jamais Validé), Col X précise explicitement que 2.2/2.3 sont NON ÉVALUÉS, jamais estimés ni inventés.
- Réserve est ajouté à STATUTS_ELIGIBLES dans product_judge.py : une ligne en réserve reste rejugeable via verdict (mode complet) dès qu'un sourcing réussi remplit Col E — le jugement complet remplace alors la réserve.
Testé et VALIDÉ EN CONDITIONS RÉELLES le 18/08/2026 (mission chasse-3produits-20260818, lignes 26 et 27) : verdict-reserve fonctionne bout-en-bout — éligibilité correcte, séquentiel identique au mode normal, --avis-clients obligatoire respecté, verdict "Disqualifié" écrit normalement (pas forcé en "Réserve") quand la saturation réelle tranche dès 2.1 — confirmant que le mode réserve ne dilue jamais un vrai motif de disqualification.
Faille détectée et corrigée le 18/08/2026 : juge_produit_orchestrateur.py row --row N n'utilisait QUE le verrou normal (check-eligible), donc renvoyait un faux "NON ÉLIGIBLE" silencieux sur une ligne pourtant éligible au mode réserve — piège pour qui utilise l'orchestrateur par réflexe au lieu d'appeler product_judge.py directement (ce que la SOP demande déjà, mais sans avertissement en cas d'oubli). Corrigé : nouvelle commande product_judge.py check-eligible-reserve --row N, appelée automatiquement par l'orchestrateur en fallback dès que le mode normal échoue — affiche désormais un avertissement explicite si le mode réserve s'applique, au lieu de se taire.
Raphael a repéré que les missions du 17-18/08/2026 imposaient un plafond de 25 candidats par mission (pause automatique une fois atteint). Ce n'était pas une règle officielle de la SOP — un chiffre introduit par erreur dans le suivi d'une mission puis recopié dans les suivantes. La SOP ne définit qu'un timeout de 25 minutes par produit (Boucle d'Intelligence, Règle d'Or #4) et 6 boucles de re-chasse max par produit — rien au niveau mission entière. Décision de Raphael : ne plus imposer de plafond artificiel de candidats par mission. Une mission continue tant qu'elle progresse ; c'est Raphael qui décide d'arrêter, pas un chiffre arbitraire non documenté.
Raphael a comparé un verdict scripté (Tystrap, ligne 24, disqualifié à l'étape 2.1) à un audit
approfondi obtenu AVANT la mission de scripting (09/08/2026, via Antigravity en raisonnement libre)
sur le MÊME produit — même conclusion finale (disqualifié), mais l'ancien rapport était bien plus
riche : cartographie concurrentielle en 3 segments (Marketplaces / GSA-Pharmacies / Marques D2C,
correspond au filtre 2.4 Règle du Supermarché), et surtout des avis clients réels avec verbatims
(positifs ET négatifs récurrents) qui appuyaient et enrichissaient le diagnostic — totalement absents
du premier verdict scripté.
Cause racine identifiée dans le code de product_judge.py : le filtrage étant strictement
séquentiel (if verdict_final is None: avant chaque étape), dès qu'un verdict est tranché tôt
(ex: échec à 2.1), les arguments --filtre-2-4/--justif-2-4, --filtre-2-5/--justif-2-5,
--citation-2-6/--url-2-6, --levier-2-7 sont acceptés par argparse mais silencieusement ignorés
— jamais ajoutés à la trace écrite en Col X. Ce n'est pas un bug (le design séquentiel économise
délibérément la recherche une fois le verdict connu), mais ça veut dire concrètement :
Corrigé mécaniquement dans le code (pas juste documenté) le 16/08/2026 : --avis-clients est
désormais un argument obligatoire sur CHAQUE appel à product_judge.py verdict, argparse refuse
physiquement de lancer le script sans lui — contrairement à --filtre-2-4 et suivants qui restent
optionnels et silencieusement ignorés si le verdict tombe tôt. La section [Avis Clients Réels] est
ajoutée à la trace Col X inconditionnellement, juste après 2.1, quel que soit l'étape où le
verdict final est tranché. Si aucun avis réel n'existe (produit trop récent), l'IA doit l'écrire
explicitement — une chaîne vide n'est jamais acceptée (même VERROU ANTI-FABRICATION que les autres
preuves qualitatives). C'est la différence entre une instruction texte (dépend de la discipline de
l'IA qui lit la SOP — le défaut même que le scripting devait corriger) et une garantie de code : cette
fois c'est la seconde.
Bonus utile pour la richesse du rapport (recommandé, pas obligatoire par le code) : structurer
aussi --preuve-2-1 en sections lisibles quand la recherche le permet (A. Saturation, B. Cartographie
3 segments Marketplaces/GSA-Pharmacies/Marques D2C, C. Prix comparés) plutôt qu'une seule phrase
compacte — rapproche la richesse de lecture de l'ancien rapport approfondi d'Antigravity, dans une
seule colonne Sheet.
product_judge.py verdict avec les arguments structurés.--preuve-2-1 etc. —Une note explicative écrite en Col X pour expliquer une correction contenait par accident les mots
"jugement" et une citation entre guillemets de l'ancien texte "VALIDE POUR LANCEMENT" — a redéclenché
la même fausse alerte de fabrication que le texte était censé corriger (audit_tracker.py cherche les
sous-chaînes "JUGE"+"VALID" dans le commentaire). Ne jamais citer littéralement un ancien verdict
"VALIDÉ" dans une note de correction — reformuler sans les mots déclencheurs.
~30 lignes du Tracker avaient leurs prix (Col E/F) stockés en texte avec point décimal au lieu de
vrais nombres — invisible à l'œil, mais ça casse silencieusement la formule de marge (Col G) dès
qu'une ligne y est exposée. Corrigé une fois, mais si product_judge.py verdict échoue avec
"Col G illisible ou vide", vérifier d'abord le type de la valeur (valueRenderOption=UNFORMATTED_VALUE)
avant de suspecter autre chose — ne jamais écraser G/H/I par une valeur statique, toujours restaurer
la formule =IF(F<>0; F-E; "").
Changement de paradigme (enseignements Nathanael) :
- Saturation Marketing vs Saturation Produit : Un produit physique n'est presque jamais saturé en soi. Ce qui se sature, c'est l'angle marketing, le hook, ou l'avatar cible (Fatigue publicitaire / Ad Fatigue).
- Fin des seuils binaires automatiques : La présence de 50+ avis Amazon FR ou 5+ boutiques Minea ne déclenche PLUS un rejet automatique binaire. Elle exige une évaluation du Potentiel de Pivot.
Les 3 Piliers du Pivot Potential :
1. Pivot Avatar (Cible) : Est-il possible d'adresser le produit à un tout autre segment d'audience sous-exploité ? (ex: pistolet de massage pour seniors/douleurs articulaires au lieu des sportifs ; correcteur de posture pour travailleurs de bureau au lieu des conducteurs).
2. Pivot Mécanisme / Format : Le produit apporte-t-il une variation de format ou un mécanisme unique ? (ex: crème vs stick solaire ; patch anti-acné micro-aiguilles vs crème ; gummies vs pilules ; système de tension élastique).
3. Niveau de Conscience (Awareness) & Coût d'Éducation : Le client cible ressent-il déjà son problème (Conscient Problème/Solution = Niveaux 1 & 2) ? Un produit nécessitant d'éduquer un client Non-Conscient (Niveau 3) brûle du budget et doit être rejeté.
Ajout 22/08/2026 (Claude Code, après confrontation à une analyse indépendante des 5 vidéos) — manques comblés dans product_judge.py :
- Signal de tendance réel obligatoire : product_judge.py check-trend --mot-cle "<produit>" interroge Google Trends (12 mois, FR) et doit être cité dans --preuve-2-1 (chiffre + direction). Remplace le pur jugement d'opinion par une donnée vérifiable — non bloquant si l'API échoue. Limite connue : pytrends (librairie non-officielle) peut se faire bloquer par IP comme ça a été le cas pour youtube_transcript_api le 22/08/2026 — une vraie API officielle existe mais en accès alpha restreint (candidature Google requise), non retenue pour l'instant.
- Signal d'ancienneté publicitaire réel obligatoire : product_judge.py check-ads-age --mot-cle "<produit>" interroge la Meta Ad Library publique (réutilise extract_ads_library.py --metadata-only, déjà utilisé pour Studio Pub) et doit être cité (annonceur le plus ancien + date de début). Mesure la fatigue publicitaire concurrentielle, distincte de la demande (check-trend) : un produit peut avoir une demande stable tout en étant saturé côté pub si des concurrents tournent dessus depuis longtemps.
- Question budget/CPA obligatoire : un pivot théoriquement valable mais nécessitant de rivaliser aux enchères avec des Leaders Premium hors budget doit être traité comme un pivot non disponible.
Règles de décision pour Filtre 2.1 dans --preuve-2-1 :
- FAIL (Disqualifié) :
- Marché verrouillé par des Leaders Premium établis, SANS aucune possibilité d'innovation sur l'Avatar, le Mécanisme ou le Branding, ET sans budget suffisant pour rivaliser sur ce segment. (Le nombre de concurrents seul n'est jamais le critère — un marché à 300 concurrents avec un pivot clair et un budget adapté peut passer ; un marché à 10 concurrents dominé par des budgets hors de portée peut échouer.)
- Produit gadget/bullshit sans valeur perçue ni problème réel.
- Clientèle cible en Niveau 3 (Unaware) nécessitant une éducation coûteuse.
- Tendance Google Trends décroissante ou nulle ET pubs concurrentes actives depuis longtemps (fatigue confirmée sur les deux signaux) SANS aucun pivot Avatar/Mécanisme documenté pour la contrer.
- PASS (Validé avec Pivot) :
- Même avec une forte concurrence, si un Pivot Avatar, Pivot Mécanisme ou Pivot Géographique/Branding clair est documenté ET reste viable avec le budget de test disponible.
- Clientèle en Niveau 1 ou 2 (Problem-Aware / Solution-Aware).
Contexte : un premier jet (signaux Branding/Monopole-web/Absence-AliExpress → rejet automatique si "marque propriétaire détectée") a été rejeté par Raphael comme reproduisant exactement le même biais que l'ancien seuil binaire de saturation — aucun moyen fiable de trancher automatiquement un statut juridique de marque déposée. Un dropshipper qui crée son propre nom/logo sur un produit OEM white-label (pratique normale et légitime, y compris la nôtre à venir) n'est PAS un créateur/propriétaire de marque protégée — un branding visible seul ne le prouve pas.
Règle définitive, à appliquer AVANT le Pivot Potential (2.1b) — --marque-statut obligatoire, un des 3 :
- majeure_mondiale → SEUL cas de rejet automatique dur (DISQUALIFIÉ, étape 2.1a). Réservé aux marques/franchises mondialement connues et non-ambiguës : Nike, Apple, Nintendo, Marvel, Dyson, Lacoste, Star Wars, etc. — si le nom fait immédiatement penser à une marque déposée mondiale sans le moindre doute, c'est ce cas.
- incertaine_d2c → NE BLOQUE JAMAIS. Un nom/logo est présent mais c'est une marque D2C/dropshipping inconnue (ex: WhyGolf, AutoScooper-by-PetPivot) — impossible de savoir avec certitude si c'est un vrai créateur propriétaire ou un autre dropshipper ayant fait comme nous. Cas par défaut dès qu'un doute existe. Le jugement continue normalement (2.1b puis la suite) ; le script écrit automatiquement une alerte non-bloquante en Col AB ("⚠️ Marque incertaine... à vérifier par Raphael avant lancement") — c'est LUI qui tranchera au cas par cas, pas le filtre automatique seul.
- aucune_ambiguite → produit générique/unbranded, aucun logo/marque propre visible. Aucune alerte écrite.
--preuve-marque obligatoire dans tous les cas : citer ce qui a été vu/trouvé (nom de marque, logo, recherche web faite) — jamais une affirmation sans preuve, même pour aucune_ambiguite.
Cas réel qui a déclenché ce correctif : un candidat prometteur (veilleuse murale) disqualifié sur une note AliExpress 4.0/5 — alors que cette note reposait sur ~16 ventes seulement, un échantillon bien trop petit pour être un signal fiable. Le sourcing marquait déjà ce cas en Col S ([ATTENTION: note basee sur un faible volume...], mécanisme existant depuis le 23/08/2026), mais le seuil dur de product_judge.py (note < 4.6 → DISQUALIFIÉ) ne lisait jamais ce texte libre.
Règle définitive : quand Col S contient ce marqueur de faible volume, le filtre 2.3 devient NON ÉVALUÉ (non-bloquant, le jugement continue normalement) — exactement le même traitement que le cas déjà existant "note absente". Quand la note vient d'un vrai gros volume de ventes/avis, elle reste un motif de disqualification dur (signal fiable, pas de raison de l'assouplir — ex: 500 avis à 4.1/5 = vrai problème produit).
Important, distinction volontaire : le filtre 2.2 (marge financière, seuil 20€) reste un filtre dur inchangé — ce n'est pas un signal ambigu comme la marque ou une note à faible échantillon, c'est de l'argent réel calculé sur un prix réellement sourcé. Ne jamais l'assouplir sur le même principe.
Sourcing (_verify_suppliers_visually) : le prompt de sélection du fournisseur préfère désormais explicitement le mieux noté (à volume d'avis suffisant) plutôt que le moins cher par défaut, quand plusieurs fournisseurs correspondent visuellement — réduit la fréquence à laquelle ce cas se présente en amont.
Contexte : quand le candidat vient d'un scan API (--scan-mode api), chasse_orchestrateur.py
écrit désormais dans la Col S (notes-sourcing) un bloc "Données marché (Minea)" avec des chiffres
réels déjà captés sur CETTE pub/boutique précise (zéro appel supplémentaire, contrairement à
check-trend/check-ads-age ci-dessus qui restent des signaux complémentaires par mot-clé, plus
génériques). Si ce bloc est présent en Col S, il DOIT être lu et cité dans --preuve-2-1 — ce
n'est pas une donnée décorative, c'est un signal de rentabilité/momentum réel à interpréter,
jamais à recopier tel quel sans lecture.
Grille d'interprétation (raisonnement de media buyer, pas des seuils durs) :
duree_jours_pub) — combien de temps une pub tourne sans êtrecheck-ads-age si doute.annonceur_pubs_actives/annonceur_pubs_total) —boutique_revenu_journalier_usd) — ordre de grandeur deboutique_visites_totales / boutique_nb_produits) —Absent en scan DOM : ces champs n'existent que via le scan API Minea (option-a-scan-api).
S'ils sont absents de la Col S, ce n'est pas un signal négatif — juste une donnée non disponible
pour ce candidat, à ne pas confondre avec "aucune tendance".
Courbe de croissance boutique (ajouté 23/08/2026) : quand présente en Col S ("tendance
boutique 1 mois: X%, 3 mois: Y%"), c'est une vraie mesure Minea (pas une estimation qualitative) :
- Croissance sur 1 mois ET 3 mois : momentum confirmé et durable, signal très positif.
- Déclin sur 3 mois MAIS croissance sur 1 mois récent : lecture la plus intéressante — peut
indiquer un nouveau produit/angle qui relance une boutique en perte de vitesse. À croiser avec
Pivot Potential : si LA pub jugée ici est récente (duree_jours_pub faible), c'est peut-être
elle qui explique ce rebond — bon candidat pour un Pivot Avatar/Mécanisme.
- Croissance sur 3 mois MAIS déclin sur 1 mois récent : ralentissement en cours, à surveiller,
pas forcément disqualifiant si le produit jugé a son propre Pivot Potential documenté.
- Déclin sur les deux fenêtres : signal négatif net sur LA BOUTIQUE — mais rappel du principe
central de cette section (Saturation Marketing ≠ Saturation Produit) : une boutique en déclin
général peut décliner pour des raisons qui n'ont rien à voir avec CE produit précis (mauvaise
gestion, autres produits qui flanchent). Ne jamais disqualifier uniquement sur ce signal seul,
toujours le croiser avec le reste du Pivot Potential.
Précision de Raphael (23/08/2026) suite à un cas réel : la Col J (Note fournisseur) peut être
vide alors que le sourcing a réellement réussi (le fournisseur vérifié visuellement n'affichait
simplement pas de note visible sur son annonce — cas réel, ligne 57, tronçonneuse SEESII). Avant
ce jour, product_judge.py verdict refusait alors totalement de juger (erreur bloquante,
sys.exit(1)), sans même produire un verdict partiel — alors que ce n'est pas une DONNÉE
FAUSSE ni une preuve manquante par négligence, juste une information indisponible chez CE
fournisseur précis.
Principe retenu : une donnée FAUSSE ou une preuve qu'on aurait dû chercher et qu'on invente
= toujours interdit (VERROU ANTI-FABRICATION, inchangé). Une donnée réellement absente malgré un
sourcing sérieux = ne doit jamais bloquer tout le jugement ni être traitée comme une
disqualification automatique. Si Col J est vide alors que le sourcing a réussi (Statut='À
tester'), product_judge.py verdict doit désormais marquer l'Étape 2.3 comme "NON ÉVALUÉ (note
indisponible chez ce fournisseur)" dans la trace Col X et continuer sur les filtres suivants,
au lieu de bloquer. Le verdict final reste possible (Validé/Disqualifié selon les autres
filtres), avec ce point signalé explicitement pour vérification humaine — jamais silencieux.