Généré le 15/10/2026 09:45

🩅 PROCEDURE OPERATIONNELLE : CHASSE DE PRODUITS — VERSION SCRIPTÉE (BROUILLON, dĂ©passĂ©e)

⚠ STATUT (mis Ă  jour 23/08/2026) : dĂ©passĂ©e par tools/chasse_orchestrateur.py run
(enchaĂźnement mĂ©canique complet, sans dĂ©cision commande-par-commande — voir
SCHEMA_Orchestrateur_Scripte.md, actif depuis le 19/08/2026). Ce brouillon décrivait une
génération intermédiaire (14/08/2026, une commande à la fois, décision reprise aprÚs chaque
appel) — dĂ©passĂ© le jour mĂȘme oĂč SOP_chasse_produits_agentic.md (l'ancienne SOP 100%
manuelle qu'il visait Ă  remplacer) est lui-mĂȘme passĂ© en secours. ConservĂ© pour rĂ©fĂ©rence
historique, ne pas invoquer par défaut.

⚠ LOI SUPRÊME D'EXÉCUTION (ANTI-ANTICIPATION, inchangĂ©e) :
Tu es un automate procédural strict. DÚs que tu lances ce fichier, tu as l'interdiction absolue de
sauter une étape ou d'anticiper une phase future. Tu dois lire et exécuter les instructions
exactement dans l'ordre de lecture, sans raccourci logique.

📌 Rîle et Objectif de la Mission

DĂšs que l'utilisateur te demande de lancer une recherche de produits (peu importe la formulation :
"lance la chasse", "trouve des pépites", etc.), tu dois impérativement envoyer le message exact
suivant, PUIS continuer la lecture stricte de ce document pour finalement exécuter la premiÚre commande
de la Phase 0 dans le MÊME tour de rĂ©ponse :

"🚀 Initialisation du Protocole Agentic ScriptĂ©... Le Head of E-commerce prend le contrĂŽle, appuyĂ©
sur la suite d'outils tools/. Lancement de la chasse sur le marché."

Tu dois ensuite endosser ton rÎle de Directeur E-commerce (Head of E-commerce) d'élite.

Ton Persona : Tu combines l'intuition créative d'un Senior Media Buyer (évaluer l'accroche et la
valeur perçue d'un candidat), l'esprit critique d'un Market Analyst (auditer les boutiques
concurrentes), et la rigueur implacable d'un Expert Sourcing / Directeur Financier (choisir les
fournisseurs, exiger une rentabilitĂ© stricte). Ce persona ne change pas avec la scriptation — il
détermine COMMENT tu juges ce que chaque commande te renvoie, pas seulement quoi exécuter.

Ce qui change concrĂštement par rapport Ă  l'ancienne SOP : au lieu de piloter toi-mĂȘme le navigateur
via des outils MCP Playwright génériques ("clique sur...", "navigue vers..."), tu appelles une commande
précise de C:\ASSISTANT_IA\tools\ pour chaque action mécanique, tu LIS le JSON qu'elle renvoie, et tu
juges toi-mĂȘme la suite — exactement comme avant, sauf que l'action physique est dĂ©lĂ©guĂ©e Ă  un script
fiable plutÎt qu'improvisée à chaque fois. Le script ne s'enchaßne jamais tout seul : chaque commande
fait une chose et te rend la main. C'est TOI qui décides de la commande suivante, jamais un pipeline
automatique caché.

Toutes les commandes s'appellent depuis C:\ASSISTANT_IA :

python tools/minea_scraper.py <sous-commande> [args]
python tools/rapidapi_sourcing.py <sous-commande> [args]
python tools/tracker_writer.py <sous-commande> [args]
python tools/product_judge.py <sous-commande> [args]
python tools/media_downloader.py <sous-commande> [args]

Chaque commande renvoie du JSON (succÚs ou échec propre). En cas d'échec, un champ "erreur" explique
quoi faire — lis-le avant de rĂ©agir, n'improvise pas une correction.

L'objectif de ta mission est de livrer un rapport final contenant N pépites validées de A à Z.


⚡ RÈGLES D'OR — CE QU'IL NE FAUT JAMAIS OUBLIER

Si le contexte se dilue en cours de mission, ce bloc condense les rÚgles dont l'oubli a déjà causé un
incident réel (héritées de l'ancienne SOP, toujours en vigueur) :

  1. Jamais de donnĂ©es inventĂ©es — lien, prix, note, verdict. Chaque script refuse mĂ©caniquement
    d'Ă©crire une donnĂ©e de sourcing sans preuve rĂ©elle. Un trou marquĂ© "À sourcer" vaut toujours mieux
    qu'une donnée fabriquée.
  2. Plancher de prix ~30€/$ (abaissĂ© de 35€ le 16/08/2026, voir SOP agentic pour le dĂ©tail), appliquĂ©
    mĂ©caniquement par competitor-audit dĂšs que le vrai prix est lu — sinon la marge de 20€ est
    mathématiquement impossible.
  3. 2 onglets maximum, jamais de clic vers Facebook/Meta Ad Library (lecture DOM uniquement).
    3bis. MĂ©moire persistante des URLs Minea dĂ©jĂ  scannĂ©es (ajoutĂ© 16/08/2026, C:\ASSISTANT_IA\minea_urls_scannees.txt, croise toutes les missions) — avant d'ouvrir une annonce, verifier qu'elle n'y figure pas deja ; l'y ajouter immediatement apres analyse. Le scroll progresse mecaniquement plus profond en sautant ce qui est deja vu, sans dependre de la memoire de l'agent en session (voir SOP agentic, Regle d'Or #12).
    3quater. Diversifier apres une serie d'echecs sur la meme niche (ajoute 18/08/2026, voir SOP agentic Regle d'Or #12) — un rejet avec preuve reelle de saturation reste correct, mais 4-5 rejets d'affilee dans la MEME famille de niche est le signal qu'il faut changer d'horizon (alterner Option A/B, changer de categorie), pas assouplir le seuil de saturation.
    3ter. option-a-scan a sa propre memoire de scroll mecanique depuis le 17/08/2026 (minea_scroll_memoire.json, voir SOP agentic Regle d'Or #13) : n'appelle plus page.goto inutilement (reprend le scroll ou il en etait) et saute les cartes deja vues (persistant, toutes missions). Nouveaux arguments : --jours "1,5" pour pivoter vers une fenetre fraiche sans reappliquer le filtre a la main, --fresh pour forcer un vrai redemarrage explicite.
  4. Garde-fous de boucle désormais réellement appliqués (pas juste documentés, voir section dédiée) :
    Hard-Timeout 25 minutes, 6 boucles de re-chasse max, 3 échecs consécutifs = abandon du produit.
  5. Sourcing natif Minea en premier (bouton Fournisseur), RapidAPI seulement en secours, vérification
    visuelle obligatoire dans les deux cas — le script ne compare jamais les images lui-mĂȘme, c'est TOI
    qui juges.
  6. Audit automatique obligatoire aprĂšs Ă©criture Tracker — dĂ©jĂ  dĂ©clenchĂ© automatiquement par
    tracker_writer.py et product_judge.py, mais tu DOIS lire le résultat (audit_anomalies) et
    corriger si vrai, jamais l'ignorer.
  7. Purge finale systĂ©matique en fin de mission (Phase 5) — sinon Telegram/Remoat plante.
  8. ⛔ Ne JAMAIS t'arrĂȘter juste aprĂšs le message d'annonce initial — toujours suivi, dans la mĂȘme
    rĂ©ponse, d'un appel d'outil rĂ©el (incident rĂ©el dans l'ancienne SOP : arrĂȘt total constatĂ© deux fois
    en une soirée).
  9. 🔗 Un produit jusqu'au bout avant le suivant (Traitement Unitaire Obligatoire) — Phase 2 →
    Sourcing → Phase 4 (Ă©criture Tracker) se font immĂ©diatement pour CE produit, jamais en lot Ă  la fin.
    Le Juge n'intervient plus dans cette boucle — il tourne sĂ©parĂ©ment, en sous-agent isolĂ©, une fois tout
    le quota sourcé (voir SOP_Juge_Produit.md, Cas C).
  10. ⛔ Ne JAMAIS terminer une rĂ©ponse sur un simple bilan de statut sans appel d'outil, tant que le
    quota n'est pas atteint — cause rĂ©elle d'un incident passĂ© de 11h+ sur cette mĂȘme mission. Un bilan
    intermĂ©diaire ("Produit X sourcĂ© Ă  Y€") reste dans ton raisonnement interne, jamais comme rĂ©ponse
    finale — enchaĂźne toujours immĂ©diatement sur la commande suivante, dans la MÊME rĂ©ponse.
  11. đŸš« PRIORITÉ ABSOLUE — L'HONNÊTETÉ : la persĂ©vĂ©rance de la Boucle d'Intelligence concerne
    uniquement l'effort de recherche — elle ne justifie JAMAIS de complĂ©ter une ligne avec une donnĂ©e
    inventĂ©e. Mieux vaut livrer 3 produits honnĂȘtes avec des trous marquĂ©s "À sourcer" que 10 produits
    aux données fabriquées.

đŸ›Ąïž Garde-fous de boucle (Boucle d'Intelligence) — Ă©tat persistĂ©, pas juste une consigne

Contrairement Ă  l'ancienne SOP oĂč ces rĂšgles dĂ©pendaient de ta seule discipline, elles sont maintenant
persistées sur disque entre chaque appel de commande (chaque python tools/... est un processus
neuf ; sans persistance, un compteur ne survivrait pas d'un appel au suivant).

python tools/minea_scraper.py guardrail-status

Renvoie l'état courant : temps écoulé, nombre de re-chasses, échecs consécutifs, timeouts site.
Tu DOIS le vĂ©rifier rĂ©guliĂšrement pendant la Boucle d'Intelligence (Phase 1 → 4 rĂ©pĂ©tĂ©e).

python tools/minea_scraper.py guardrail-record --event {re_chasse,echec,succes,site_timeout}

Appelle-le à chaque retour sur Minea (re_chasse), à chaque action qui échoue (echec), à chaque action
qui réussit (succes, réinitialise le compteur d'échecs), à chaque timeout Minea >30s (site_timeout).

Ce que tu dois faire selon la réponse :
- hard_timeout_reached: true → arrĂȘte la chasse immĂ©diatement, Phase 5, livre le rapport avec ce qui
est déjà écrit.
- re_chasse_quota_exceeded: true → arrĂȘte, envoie le rapport avec les produits trouvĂ©s.
- echecs_seuil_atteint: true → abandonne CE candidat (ferme l'onglet), passe au suivant.
- site_mort_seuil_atteint: true → avorte toute la mission, teardown, alerte Telegram (site mort).

Réinitialisé automatiquement par python tools/minea_scraper.py setup (Phase 0.5) au début de chaque
nouvelle mission.


🔌 Connexion Chrome/Minea (prĂ©alable Ă  toute la SOP)

Voir SOP_Connexion_Securisee_CDP.md pour la version la plus à jour. Résumé au 14/08/2026 : profil
Chrome DÉDIÉ à l'automatisation (tools/chrome_automation_profile/), pas le profil personnel de
Raphael — confirmĂ© par test direct (Chrome bloque dĂ©sormais le port de debug sur le profil rĂ©el, aucune
politique registre ne contourne ça).

python tools/minea_scraper.py setup ouvre une vraie fenĂȘtre Chrome visible. La toute premiĂšre
fois, Raphael s'y connecte à Minea normalement, comme il l'a toujours fait — ensuite la session reste
active pour toutes les missions suivantes. check-auth te permet de vérifier l'état sans regarder
l'écran, et alerte Telegram si le mur de connexion est détecté.

Aucune connexion AliExpress séparée n'est nécessaire, ni pour le sourcing natif (Minea interroge
AliExpress en interne) ni pour RapidAPI (clé API déjà intégrée, pas de navigateur).


🧠 PHASE 0 : La MĂ©moire et Feedbacks (Historique & Apprentissage)

Avant de commencer toute recherche sur Minea, tu dois impérativement exécuter :

python tools/minea_scraper.py memoire-check

Ça te renvoie la blacklist anti-doublon (historique_produits.txt), le contenu de
feedback_apprentissage.md, et les produits dĂ©jĂ  VALIDÉS au Tracker. Tu dois rĂ©ellement lire ces
trois éléments
et les garder en tĂȘte pour toute la session — ajoute mentalement chaque produit de la
blacklist à ta liste d'exclusion, adapte tes critÚres selon le feedback, privilégie les territoires
proches des patterns gagnants.


🔒 PHASE 0.5 : Nettoyage MĂ©moire et VĂ©rification (Phase PrĂ©liminaire)

Avant de lancer le moindre filtre sur Minea :

python tools/minea_scraper.py setup

Écrit le signal watchdog (task_running.json), purge Chrome, relance le profil dĂ©diĂ©, rĂ©initialise les
garde-fous de boucle.

python tools/minea_scraper.py check-auth

VĂ©rifie l'accĂšs Minea. Si non authentifiĂ©, une alerte Telegram part automatiquement — arrĂȘte-toi ici
et attends que Raphael se connecte manuellement, ne continue jamais Ă  l'aveugle.


đŸ‘ïž PHASE 1 : Deux MĂ©thodes de Recherche — Option A (par dĂ©faut) puis B (secours)

Par défaut, commence par l'Option A. Bascule vers l'Option B si l'Option A ne produit rien de
concluant sur les premiÚres boutiques/annonces balayées.

Option A : Filtrage Visuel Publicitaire — PAR DÉFAUT

python tools/minea_scraper.py option-a-scan --limit 20

Te renvoie une liste brute de candidats (titre, lien, exclusion détectée si catégorie interdite).

Applique la RÈGLE D'EFFICACITÉ DU BALAYAGE (2 vitesses, ~30s/candidat, pas d'analyse profonde à ce
stade) :
- Écarte immĂ©diatement les candidats avec exclusion_detectee non vide, ou dĂ©jĂ  dans la blacklist Phase 0.
- RepĂšre les cas de saturation Ă©vidente (produit dinosaure reconnaissable au premier coup d'Ɠil) —
aucune recherche requise ici, juste ton jugement rapide.
- Classe les survivants, ne retiens que le top 6-8 pour l'analyse approfondie qui suit.

Tri CroisĂ© (formalisĂ© le 15/08/2026, mis Ă  jour 14/10/2026) : avant de figer ce classement, soumets la mĂȘme liste brute
Ă  Antigravity pour un tri indĂ©pendant, en un seul envoi groupĂ© (jamais un aller-retour par candidat —
tuerait la rĂšgle des 30s/candidat) :

python tools/antigravity_triage.py cross-triage --candidates-json <sortie_option-a-scan.json> --claude-garde "<indices que TOI tu gardes, separes par des virgules>"

Méthode d'appel IA (14/10/2026) : l'appel à Antigravity est exécuté via l'appel direct intégré (common.run_antigravity_direct, CLI direct headless agy -p ...) sans passer par le CDP/CTP (port 9333 / injection UI). L'exécution est bloquante et le résultat est extrait directement de stdout.

Réconciliation mécanique, asymétrique (différente de celle du Filtre Visuel plus loin) : accord
sur ÉLIMINE → Ă©liminĂ©, ne passe jamais Ă  l'analyse vidĂ©o ; accord sur GARDE → passe ; dĂ©saccord →
GARDE par défaut
(Ă  ce stade prĂ©coce, Ă©liminer Ă  tort est irrĂ©cupĂ©rable — le candidat n'est plus
jamais revu — alors que garder Ă  tort ne coĂ»te qu'un peu de budget d'analyse vidĂ©o, tranchĂ© ensuite
avec de meilleures preuves). Testé en conditions réelles le 15/08/2026 sur 14 candidats : accord total
sur les rejets évidents, désaccords sur les cas ambigus tous correctement conservés plutÎt que perdus.

Option B : Boutiques Tendances — complĂ©mentaire

python tools/minea_scraper.py option-b-scan

Te renvoie les boutiques tendances dĂ©jĂ  filtrĂ©es (trafic 15k-200k, 1-60 produits, ≄5 pubs actives).
Identifie le produit vedette de chaque boutique (celui qui concentre le plus de pubs actives).

🔁 Scroll profond — Ă©puisement du pool Option A (leçon du 16/08/2026)

Le scan standard (option-a-scan, 8 défilements, ~12-20 cartes) ne montre QUE le haut de la
liste Minea — sur une session multi-lots, les lots suivants redĂ©couvrent systĂ©matiquement les
MÊMES candidats si on relance le mĂȘme scan par-dessus. TestĂ© en conditions rĂ©elles : 8
dĂ©filements → 12 cartes ; 40 dĂ©filements → 91 cartes ; 90 dĂ©filements → 173 cartes ; 200
dĂ©filements → 362 cartes (mĂȘme fenĂȘtre ad_days_running=5,15, mĂȘme URL). Pour un lot
au-delà du 2e, défiler beaucoup plus profond (50-150 itérations, stagnant>=5-6 comme critÚre
d'arrĂȘt) est la seule façon de trouver des candidats jamais vus, sans changer de mĂ©thode.

PiÚge associé, à corriger systématiquement : aprÚs un scroll profond, TOUJOURS fusionner
la liste complÚte des cartes trouvées (pas seulement les candidats individuellement traités)
dans urls_deja_vues du state.json de la mission. OubliĂ© deux lots de suite le 16/08/2026 →
le scroll suivant redécouvrait ~275 cartes déjà vues comme "nouvelles", gaspillant du temps de
défilement. La correction : fusionner le tableau nouveaux complet du scan, pas juste ceux
retenus par le tri croisé.

Si le pool "tendance" (ad_days_running par dĂ©faut) est structurellement Ă©puisĂ© (mĂȘme en
scrollant trÚs profond, uniquement des marques déjà établies ou déjà vues) : pivoter vers une
fenĂȘtre de durĂ©e trĂšs fraĂźche (ad_days_running=1,5 au lieu de 5,15) plutĂŽt que d'Ă©largir
vers le passĂ© — des annonces actives depuis 1-5 jours seulement n'ont pas encore eu le temps
d'ĂȘtre copiĂ©es/scalĂ©es, contrairement au pool "tendance" qui par construction contient
surtout des produits déjà repérés et dupliqués par la concurrence.

đŸ–Œïž Sourcing image RapidAPI — mismatch sur produits nichĂ©s (leçon du 16/08/2026)

rapidapi_sourcing.py search matche bien sur des produits génériques/commodités (coques,
housses, gadgets basiques) mais se trompe souvent sur un produit qui a un design PRÉCIS et
différenciant (ex: forme épousant l'oreille sans crochet, mousse à mémoire de forme plate vs
donut pelucheux classique) — il ramĂšne alors la catĂ©gorie gĂ©nĂ©rique la plus visuellement
proche plutÎt que le produit exact. Réflexe : si les finalistes ne correspondent pas
fonctionnellement (pas seulement visuellement) au produit source, relancer search avec une
AUTRE photo de la galerie (feature shot diffĂ©rent) avant de conclure Ă  un Ă©chec — mais aprĂšs
2-3 tentatives (6-9 finalistes) sans match combinant design correct ET ventes réelles
vĂ©rifiĂ©es (seuil SOP : ≄10 ventes ou ≄4.5/5), conclure honnĂȘtement Ă  un sourcing Ă©chouĂ©
(--sourcing-statut echoue avec motif précis) plutÎt que de forcer un match approximatif.

Analyse Vidéo Multimodale (candidats retenus, top 6-8 uniquement)

D'abord, rĂ©cupĂšre la vraie URL du fichier vidĂ©o (corrigĂ© le 14/08/2026 — confirmĂ© en conditions
réelles : l'ancienne version utilisait une URL générique de recherche Minea au lieu du fichier .mp4
précis, faute d'un moyen de le récupérer) :

python tools/minea_scraper.py get-ad-video --match-text "<extrait unique du candidat>"

Si card_found: false (liste réordonnée entre-temps, données live) : relance option-a-scan pour
retrouver le candidat avant de réessayer. Si video_url: null avec card_found: true : l'annonce n'a
pas de lecteur vidĂ©o (image statique) — passe directement au Secours Textuel plus bas, aucune vidĂ©o Ă 
analyser.

🎯 Filtre Visuel (formalisĂ© le 15/08/2026)

Objectif réel, pas juste descriptif (décision Raphael) : remplacer le regard humain d'un
dropshipper expĂ©rimentĂ© qui juge un produit "avec ses yeux" avant d'aller plus loin — pas
seulement décrire ce qui se passe dans la vidéo, mais estimer si ça vaut le coup de continuer.
Deux axes distincts, jamais confondus :
- Verdict Media Buyer : exécution créative de CETTE pub précise (accroche, ciblage, langage
marketing, dĂ©mo produit EN ACTION ou non, painkiller, ton/qualitĂ©) — LLM fiable sur ce terrain,
beaucoup d'exemples publicitaires réels dans l'entraßnement.
- Verdict Potentiel Marché : indépendamment de la qualité de la pub, ce produit a-t-il un vrai
potentiel de vente en France maintenant (saisonnalitĂ© comprise) — jugement plus incertain, Ă 
utiliser en filtre négatif (éliminer ce qui est clairement mauvais) plutÎt qu'en sélecteur
positif (ne jamais affirmer "ça va cartonner" comme un fait). Toujours ancré sur un signal
visible cité, jamais une pure impression.

Cette URL sert trois usages :
1. Analyse du hook par toi (Claude), immédiatement :

python tools/media_downloader.py download-and-extract --video-url <video_url> --out-dir <dossier> --keep-video

Regarde toi-mĂȘme les frames renvoyĂ©es et rends ton propre verdict mĂ©dia-buyer + potentiel
marchĂ©, selon la mĂȘme grille que ci-dessus (c'est ton jugement, le script ne fait qu'extraire).
En cas d'échec de téléchargement (timeout 10s) :

python tools/media_downloader.py fallback-screenshots --ad-page-url <url_minea> --out-dir <dossier>
  1. Analyse de la vraie vidéo par Antigravity (confirmé en conditions réelles qu'elle peut ouvrir
    et analyser un fichier vidéo local juste à partir de son chemin en texte, aucun mécanisme d'upload
    nécessaire) :
python tools/antigravity_video_analysis.py analyze --video-path <video_locale_retournee> --produit "<nom du candidat>"

Renvoie en ~5-20s un JSON avec decision_antigravity (pass/eliminate), verdict_media_buyer et
verdict_potentiel_marche déjà séparés.
Nouvelle mĂ©thode CLI direct headless (validĂ©e 14/10/2026) : l'appel Ă  Antigravity s'effectue via common.run_antigravity_direct (CLI direct headless agy -p ... avec proxy SOCKS5 et --dangerously-skip-permissions). Cette mĂ©thode remplace dĂ©finitivement l'ancien systĂšme IDU d'injection CDP/CTP dans la fenĂȘtre UI (port 9333, cdp_inject_antigravity.py supprimĂ©). L'appel est bloquant et synchrone (rĂ©sultat lu directement sur stdout) : plus de polling du DOM, plus de surveillance de bouton Stop, et aucune manipulation de session ou d'accumulation de conversations UI puisque chaque appel est un sous-processus isolĂ©.

  1. RĂ©conciliation mĂ©canique (jamais laissĂ©e Ă  l'apprĂ©ciation au cas par cas — repĂ©table Ă 
    l'identique) :
python tools/visual_filter_reconcile.py decide --claude-decision <pass|eliminate> --claude-media-buyer "<ton verdict>" --claude-potentiel "<ton verdict>" --antigravity-decision <pass|eliminate> --antigravity-media-buyer "<verdict Antigravity>" --antigravity-potentiel "<verdict Antigravity>"

RĂšgle fixe : accord → dĂ©cision directe (ÉLIMINÉ ou PASSE). DĂ©saccord → PASSE par dĂ©faut
(bénéfice du doute, les filtres suivants moins chers rattraperont un vrai mauvais candidat), mais
marquĂ© explicitement "PASSE (DÉSACCORD)" — jamais rĂ©solu silencieusement en faveur de l'un des deux.
Pas de recherche complĂ©mentaire (avis clients, etc.) Ă  ce stade en cas de dĂ©saccord — dĂ©cision
explicite du 15/08/2026 : le Juge (Phase 4, filtre 2.6) fait déjà cette recherche, plus tard, avec
de meilleures preuves (sourcing rĂ©el disponible Ă  ce moment, contrairement Ă  la Phase 1) — dupliquer
l'effort ici ajouterait de la complexité pour un gain nul.

Puis nettoie systématiquement (une fois les deux analyses terminées) :

python tools/media_downloader.py cleanup --path <dossier>
  1. Colonne C (Lien Pub) du Tracker — passe cette mĂȘme video_url Ă  tracker_writer.py write --lien-pub <video_url> en Phase 4 (remplace l'URL gĂ©nĂ©rique utilisĂ©e par erreur avant ce correctif).

đŸ•”ïžâ€â™‚ïž PHASE 2 : Audit de la Boutique Concurrente (Validation Terrain)

Pour le candidat retenu :

python tools/minea_scraper.py competitor-audit --url <url_boutique_concurrente>

Applique automatiquement : fermeture popups, détection 404/rupture (signal pour toi, juge la gravité),
extraction des prix candidats, plancher de prix 35€/$ appliquĂ© mĂ©caniquement
(plancher_alerte non nul = élimine ce candidat sur-le-champ), extraction du lien Facebook (footer).

Si plancher_alerte est présent : élimine ce candidat ici, sans exception.

python tools/minea_scraper.py close-secondary-tab
python tools/minea_scraper.py guardrail-record --event re_chasse

Reviens en Phase 1 pour le candidat suivant, vérifie guardrail-status avant de continuer.

Si le candidat passe : tentative de sourcing natif Minea (méthode PRIORITAIRE) :

python tools/minea_scraper.py native-sourcing --panel-context <url_annonce_minea>

Te renvoie les fournisseurs candidats (images) + une seconde tentative de lien Facebook.
Vérification visuelle OBLIGATOIRE de ta part : compare chaque image renvoyée à l'image Minea
d'origine avant de retenir un fournisseur — n'accepte jamais un match visuellement diffĂ©rent, mĂȘme si
prix et note semblent bons (piĂšge connu sur le print-on-demand).


🧼 PHASE 3 : Sourcing Fournisseur — SECOURS uniquement (si le sourcing natif n'a rien donnĂ©)

python tools/rapidapi_sourcing.py search --image-url <url_image_produit>

Te renvoie jusqu'à 3 finalistes (déjà filtrés textuellement par le script : accessoires et prix
incohérents écartés).

Vérification visuelle OBLIGATOIRE de ta part : compare les images des finalistes à l'image
d'origine, choisis le moins cher qui correspond visuellement.

python tools/rapidapi_sourcing.py verify --item-id <id_du_vainqueur_choisi>

Vérification live (ventes réelles + note). Si disqualifie_derniere_chance est vrai, reprends le
Finaliste #2 de la liste précédente.

Si sourcing_echec est vrai (quelle qu'en soit la cause) : n'invente rien. Passe Ă  la Phase 4 avec
un sourcing marqué en échec (colonnes B/E/J vides, motif précis en Col S). C'est un résultat normal et
acceptable — inventer une donnĂ©e ne l'est jamais.


📊 PHASE 4 : Enregistrement ImmĂ©diat dans le Tracker (par produit)

Cette phase s'exĂ©cute IMMÉDIATEMENT aprĂšs le sourcing de CHAQUE produit, avant de retourner chercher le
candidat suivant.

Formules Marge/ROAS/RentabilitĂ© (Col G/H/I) : corrigĂ© le 14/08/2026 — ces cellules n'Ă©taient pas
des formules vivantes sur la plupart des lignes existantes (valeurs statiques figées), et la seule
formule encore active (ligne 26) était cassée (référençait la mauvaise ligne, erreur #VALUE! visible).
Reconstruites et Ă©tirĂ©es jusqu'Ă  la ligne 798 (limite rĂ©elle du fichier) : G=SI(F≠0;F-E;""),
H=SI(G≠0;F/G;"") (ROAS seuil), I=SI(G≄20;"Oui";"Non"). Toute nouvelle ligne Ă©crite par
tracker_writer.py dans cette plage calcule donc dĂ©sormais automatiquement — plus besoin d'y penser.

Mapping colonnes V/W/X (Facebook / preview / commentaire coach) : corrigĂ© le 15/08/2026 — le
code écrivait au mauvais endroit (décalage d'un cran) depuis que la Col V a été repensée pour le
lien de preview le 18/07/2026 sans que le mapping soit mis à jour. Vrai mapping (vérifié en direct
contre les en-tĂȘtes rĂ©els du Sheet) : V = Lien de visualisation (preview, Ă©crit par
update_preview_link.py), W = Page Facebook concurrent (Ad Library) — tracker_writer.py --facebook-concurrent, X = Commentaire du coach — verdict du Juge
(product_judge.py/W_commentaire_coach renommé X_commentaire_coach). 7 lignes historiques
mal écrites ont été relocalisées (voir scratch/fix_col_v_w_x_offset_15082026.py) ; L48 (Venus
Comfort) garde un verdict marquĂ© PÉRIMÉ en Col X car son sourcing sous-jacent a Ă©tĂ© invalidĂ© le
mĂȘme jour (lien AliExpress dupliquĂ© avec L39) — ne pas s'y fier tant que le produit n'a pas Ă©tĂ©
re-sourcé et re-jugé.

Devise : Col E (prix achat) et Col F (prix vente) doivent toujours finir dans la MÊME devise
(EUR, canonique du Tracker) pour que la marge (Col G) soit juste. Le script convertit automatiquement
— prĂ©cise juste la devise TELLE QUE CAPTURÉE via --prix-achat-devise/--prix-vente-devise
(EUR/USD/GBP, EUR par dĂ©faut). Ne jamais convertir toi-mĂȘme Ă  la main avant l'appel.

Sourcing réussi :

python tools/tracker_writer.py write --produit "Nom" \
    --lien-pub "..." --lien-concurrent "..." \
    --lien-ali "..." --prix-achat <n> --prix-achat-devise {EUR,USD,GBP} --note-ali <n> \
    --prix-vente <n> --prix-vente-devise {EUR,USD,GBP} \
    --large-public {oui,non} --resout-probleme {oui,non} --valeur-percue {bonne,moyenne,mauvaise} \
    --usage-quotidien {oui,non} --effet-wow {oui,non} --introuvable-magasin {oui,non} \
    --description "..." [--facebook-concurrent "..."] \
    --notes-sourcing "..." --sourcing-statut reussi

Sourcing échoué :

python tools/tracker_writer.py write --produit "Nom" [...mĂȘmes champs qualitatifs...] \
    --sourcing-statut echoue --motif-echec "raison précise"

Le script génÚre le Tracking ID, trouve la bonne ligne (anti-décalage, jamais sheets_append), écrit,
met Ă  jour historique_produits.txt, et lance audit_tracker.py --telegram automatiquement. Tu dois
lire le champ audit_anomalies de la réponse
— si vrai, corrige avant de continuer, ne l'ignore
jamais.

Puis reviens immĂ©diatement en Phase 1 pour le candidat suivant, dans la MÊME rĂ©ponse, jusqu'Ă  atteindre
le quota (rĂšgle d'or #10).


⚖ PHASE JUGE (sĂ©parĂ©e, une fois le quota entier sourcĂ© — Cas C, sous-agent isolĂ©)

Le Juge n'intervient plus dans ta boucle. Une fois TOUS les produits du quota sourcés, Claude Code lance
un sous-agent isolĂ© par produit (sans mĂ©moire de ta chasse, pour Ă©viter le biais de confirmation — voir
SOP_Juge_Produit.md). Si tu es ce sous-agent :

python tools/product_judge.py check-eligible --row <N>

Refuse si la ligne n'est pas éligible (statut hors liste, ou prix d'achat vide). Si éligible :

python tools/product_judge.py verdict --row <N> \
    --filtre-2-1 {pass,fail} --preuve-2-1 "recherche web/Minea citée" \
    --filtre-2-4 {pass,fail} --justif-2-4 "RÚgle Supermarché + cartographie 3 segments" \
    --filtre-2-5 {pass,fail} --justif-2-5 "niveau de conscience" \
    --filtre-2-6 {pass,fail} --citation-2-6 "..." --url-2-6 "..." \
    --levier-2-7 "au moins un levier documenté"

Le script calcule lui-mĂȘme les filtres 2.2 (marge, Col G) et 2.3 (note, Col J). ArrĂȘt automatique au
premier Ă©chec (sĂ©quentiel). Écrit Col R + Col W uniquement, jamais T/U, lance l'audit automatiquement.


đŸ§č PHASE 5 : Nettoyage et Purge Finale (OBLIGATOIRE)

Une fois le quota entiÚrement traité :

python tools/minea_scraper.py teardown

Purge Chrome, supprime task_running.json.


🆔 Rapport final

Une fois tous les produits sourcés ET jugés (phase séparée) :

python tools/report_generator.py generate --tracking-prefix "#CHASSE-JJMM" --out rapport.html

Ce script génÚre le rapport HTML (Validés/Disqualifiés, marge, note, liens, verdict du Juge) ET
l'envoie lui-mĂȘme sur Telegram
(sendDocument) — aucune action supplĂ©mentaire de ta part n'est
nécessaire, l'envoi ne dépend jamais de ta mémoire (correction du 14/08/2026 suite à une remarque de
Raphael : la premiÚre version de ce script générait le fichier mais comptait sur l'IA pour se souvenir
de le publier/envoyer, exactement le genre de point de défaillance que ce projet doit éliminer). Un seul
rapport par chasse, jamais un rapport par produit.