Document de référence canonique, mis à jour le 19/08/2026 (remplace la version du
18/08/2026, entièrement obsolète — cette nuit-là le script était en cours de construction,
cette version décrit le système RÉELLEMENT construit et testé en conditions réelles).
En cas de doute ou de reprise dans une nouvelle conversation (Claude OU Antigravity), se
référer à CE schéma avant de re-décider quoi que ce soit — ne jamais réinventer le flux
de mémoire, et ne jamais supposer qu'une étape marquée ✅ ici a pu changer sans relire le
code réel (tools/chasse_orchestrateur.py) en cas de doute.Script réel :
tools/chasse_orchestrateur.py. Toute la mission tient en UNE commande :
python tools/chasse_orchestrateur.py run --mission <nom> --objectif <N>.
Principe de base (à ne jamais perdre de vue) : tous les scripts métier existent déjà
et sont testés individuellement. Le travail de l'orchestrateur est de les enchaîner
mécaniquement dans le bon ordre, avec le bon prompt au bon moment — jamais de décision
de séquencement prise en conversation live (ni par Claude, ni par Antigravity).
Décision de Raphael le 19/08/2026 : si le quota hebdomadaire de Claude s'épuise pendant
une absence de Raphael, Antigravity doit pouvoir reprendre la suite (corriger/étendre ce
code, ET faire tourner elle-même les étapes qui dépendaient jusque-là de Claude). Ce
document doit donc être lisible et actionnable sans aucun contexte de conversation
préalable — c'est le point d'entrée si Antigravity reprend seule.
Décision de Raphael : quand il demande "lance une chasse pour N produits" sans préciser de
filtres (mot-clé, fenêtre, pays), il ne veut jamais avoir à spécifier ces paramètres lui-même —
il délègue ce choix à l'IA (Claude), avec cette règle stricte : l'IA raisonne UNE SEULE FOIS,
avant le lancement, puis les paramètres choisis sont figés et transmis tels quels au script —
jamais de re-décision en cours d'exécution.
Mécanique :
1. Avant setup, l'IA appelante lit python tools/chasse_strategie.py resume --limit 10 —
historique réel des dernières chasses (paramètres utilisés + indicateurs de qualité réels :
taux d'élimination au Tri Croisé, produits retenus).
2. L'IA raisonne (casquette "media buyer expérimenté") : garder la même combinaison si elle
marche encore bien, varier --query/--jours en priorité si le taux d'élimination grimpe ou
si les derniers produits retenus se répètent trop dans la même niche, ou tenter une
exploration ponctuelle même sans signal négatif (ne jamais rester figé indéfiniment). --country
n'est PAS un levier de rotation par défaut — voir précision ci-dessous.
3. python tools/chasse_strategie.py record --mission <nom> --jours <str> [--query <str>]
[--country <str>] --justification "<raisonnement>" — fige la décision par écrit.
4. Lance chasse_orchestrateur.py run --mission <nom> --objectif <N> --jours <str> [--query <str>]
[--country <str>] avec EXACTEMENT ces paramètres.
5. Clôture automatique (depuis le 24/08/2026, ne dépend plus de l'IA appelante) :
chasse_orchestrateur.py appelle lui-même chasse_strategie.py cloturer --mission <nom> à
l'étape 11->FIN de cmd_run (et dans cmd_mission_close pour une clôture manuelle/de secours)
— calcule les indicateurs réels (relit le state.json) pour nourrir la décision de la PROCHAINE
chasse. Correctif suite à un oubli réel le 24/08/2026 (mission chasse-5produits-20260824-suite
jamais clôturée dans l'historique jusqu'à vérification manuelle) : la fiabilité de ce mécanisme
ne doit plus dépendre de la mémoire de session de l'IA. Best-effort, silencieux si la mission
n'a jamais été record-ée en amont (ne bloque jamais la vraie clôture de la mission).
--country (ajouté 24/08/2026, existait dans minea_api_client.py mais jamais exposé plus
haut, toujours figé sur "US"). Précision de Raphael (24/08/2026) : rester sur "US" par défaut
dans l'immense majorité des cas — les US sont le marché témoin où naissent la plupart des
tendances dropshipping avant de se diffuser ailleurs, ce n'est pas un marché parmi d'autres à
faire tourner. Le vrai levier de diversification au quotidien reste --query/--jours, JAMAIS
--country en premier réflexe. --country n'est utile qu'en exploration ponctuelle et rare,
limitée aux autres grands marchés anglophones Tier 1 (GB, CA, AU) si vraiment recherché — jamais
comme rotation systématique, jamais vers un marché non-anglophone par défaut.
Ce module (tools/chasse_strategie.py) n'automatise PAS la décision elle-même (pas de seuil
figé "si taux > X% alors changer") — il fournit juste les données réelles pour que l'IA
appelante décide en connaissance de cause. La décision reste un raisonnement explicite, écrit
dans --justification, jamais un calcul caché.
--triage-executor antigravity_only (nouveau, symétrique à --judge-executor_triage_claude) au lieu de l'essayer puis attendre 180s de timeout--judge-executor
antigravity_only pour une mission garantie zéro dispatch Claude de bout en bout :chasse_orchestrateur.py run --mission <nom> --objectif <N> --judge-executor
antigravity_only --triage-executor antigravity_only.--scan-mode produits (chasse_orchestrateur.py, minea_scraper.pycmd_option_c_scan_produits, minea_api_client.py _call_search_products) : sourcesearch-ads et "Boutiques"/search-shopsexcludeBigShops: true (exclut lesdom/api sans les remplacer,antigravity_triage.py,chasse_orchestrateur.py). Avant ce correctif, le Tri Croisé était une boîte noire — laMOTIF <index>: <raison> dans le prompt partagéMOTIF_LINE_RE/_parse_motifs côté Antigravity, champ motifs ajouté au contratstate.json (tri_croise.claude_motif /tri_croise.antigravity_motif par candidat). Motivé par une demande réelle de Raphael aprèschasse_strategie.py cloturer appelé automatiquement par chasse_orchestrateur.py à lacmd_run + cmd_mission_close) — ne dépend plus de la mémoire derecord/cloturer dans--scan-mode passe par défaut de dom à api (chasse_orchestrateur.py, sous-commandesscan et run) — le scan API Minea (minea_scraper.py option-a-scan-api) est maintenantdom (scroll+lecture--scan-mode dom, jamais_source_candidate) : nouvel ordre de priorité — 1) recherche par imagesearchbyimage_sourcing.py), 2) natif Minea, 3) RapidAPIproject_sourcing_image_search_extension_vs_natif.SOP_Juge_Produit_scriptee_DRAFT.md section "Données Marché Minea".product_judge.py Étape 2.3 : une note fournisseur vide (sourcing réussi mais note nonSOP_Juge_Produit.md.common.write_row_fields : avertissement ajouté dans le code — primitive interne àtracker_writer.py/product_judge.py, jamais à appeler directement depuis un script de debug.CLAUDE.md (routage "lance la chasse") pointait encore vers l'ancienne SOP 100% manuelle,| Couleur | Acteur | Rôle |
|---|---|---|
| 🔧 Bleu | Orchestrateur (script Python, chasse_orchestrateur.py) |
Séquence tout mécaniquement. Ne juge jamais rien lui-même. Tourne en subprocess, aucune IA ne le pilote en conversation. |
| 🟣 Violet | Claude | Sollicité via CLI headless (claude -p ..., processus séparé de toute conversation) — jamais besoin de présence humaine NI d'une conversation Claude Code active. |
| 🟢 Vert | Antigravity | Sollicitée via l'appel direct intégré (common.run_antigravity_direct, CLI headless agy -p ... avec proxy SOCKS5 + permissions auto-approuvées) — remplace depuis le 14/10/2026 l'ancien système IDU d'injection CDP/CTP dans sa fenêtre UI (port 9333, cdp_inject_antigravity.py). Mêmes outils (terminal/fichiers/navigateur) qu'en mode agentique, appel bloquant cette fois (plus de polling DOM). S'applique à l'ensemble des étapes : Tri Croisé, Filtre Visuel Vidéo et Juge Produit en repli. |
| ⚪ Gris | Raphael | Déclenche la mission (une seule commande). N'intervient plus ensuite sauf garde-fou ou décision explicite qu'il a demandé à garder (aucune aujourd'hui — tout le pipeline est allé de bout en bout sans lui le 19/08/2026). |
| # | Étape | Script réel | Statut |
|---|---|---|---|
| 0 | Initialisation mission : garde-fous reset, watchdog démarré/vérifié, task_running.json écrit (pour que task_watchdog.py sache qu'une mission scriptée est active) |
chasse_orchestrateur.py setup |
✅ Construit, testé. |
| 1 | Scan Minea (Option A, fenêtre --jours) avec détection dynamique de fin de page réelle (hauteur de page + nouvelles cartes, plus de compteur de scrolls fixe) |
minea_scraper.py option-a-scan |
✅ Reconstruit le 19/08/2026. Sort arret_raison : limite_candidats_atteinte / budget_temps_epuise (garde-fou pur, 150s) / fond_de_page_atteint (seul signal fiable de fenêtre épuisée). |
| 1→2a/2b | Tri Croisé (lot entier) : prompt → Claude headless → décision, puis antigravity_triage.py cross-triage réconcilie avec la décision Antigravity (appel direct headless CLI agy -p, sans CDP/CTP). Accord ELIMINE → éliminé. Désaccord → GARDE par défaut. |
chasse_orchestrateur.py triage |
✅ Construit, testé. |
| 2→9 | Pour CHAQUE candidat shortlisté, traitement unitaire strict (un seul en vol à la fois, jusqu'au bout — jamais en lot) : audit concurrent + plancher prix → extraction média → sourcing natif puis secours RapidAPI → jugement visuel dual-IA (Claude frames + Antigravity vidéo complète via CLI headless direct agy -p) → réconciliation → écriture Tracker. Boucle jusqu'à objectif/garde-fou/épuisement de fenêtre (avec échelle d'escalade automatique : 5,15 → 1,5 → 15,30 → 30,60, seulement après 3 fond_de_page_atteint CONFIRMÉS sur la fenêtre courante). |
chasse_orchestrateur.py run (boucle principale) |
✅ Construit, testé en conditions réelles le 19/08/2026 (mission chasse-4produits-20260819, 4/4 lignes écrites, 0 intervention manuelle). |
| ⚠️ Sourcing échoué (natif + secours) | Écrit quand même la ligne au Tracker (Prix d'achat/lien vides, Statut "À sourcer") — pas un rejet, juste "pas encore sourcé". Ne compte pas dans l'objectif tant que le Juge n'est pas passé en Mode RÉSERVE. | tracker_writer.py --sourcing-statut echoue |
✅ Construit, testé. |
| 9→10 | Dispatch mécanique du Juge, un candidat à la fois (Traitement Unitaire), sans AUCUNE décision prise en conversation — ni par Claude ni par Antigravity. Voir section dédiée ci-dessous, c'est le point le plus important pour la continuité. | _run_judge_chain() dans chasse_orchestrateur.py (appelé automatiquement en fin de run, ou manuellement via chasse_orchestrateur.py judge) |
✅ Construit et testé le 19/08/2026, avec repli automatique Antigravity si Claude échoue/timeout (ajouté ce soir même). |
| 10 | Jugement approfondi 7 filtres, un par produit | product_judge.py (appelé PAR le Juge dispatché, pas directement par l'orchestrateur) |
Inchangé, utilisé tout le week-end. |
| 10→11 | Rapport final (classe Validé/Disqualifié, seulement après que le Juge a écrit un vrai verdict) | report_generator.py generate --tracking-prefix ... |
✅ Construit, testé. Envoie sur Telegram tout seul. |
| 📊 Stats | Dashboard statistique des rejets (Pre-Tracker + Post-Tracker) | stats_rejets.py regenerate |
✅ Construit le 19/08/2026. Génère rapport_stats_rejets_dashboard.html et envoie sur Telegram tout seul. |
| 11→FIN | Clôture mécanique : arrête le watchdog, supprime task_running.json, statut mission → mission_cloturee |
(fin de cmd_run, inline) |
✅ Construit, testé. |
Résumé opérationnel : depuis le 19/08/2026, python tools/chasse_orchestrateur.py run --mission <nom> --objectif <N> suffit — TOUT s'enchaîne (scan → tri → sourcing → jugement visuel → Tracker → Juge → rapport → clôture), sans qu'aucune IA n'ait besoin d'être en conversation pour décider quoi que ce soit. cmd_run gère lui-même la reprise d'une mission déjà commencée (relance sur le state.json existant).
C'est l'étape la plus critique pour la continuité pendant une absence de Claude (quota
épuisé), donc détaillée à part.
Comment ça marche (_run_judge_chain()) : pour chaque ligne écrite au Tracker et pas
encore jugée, dans l'ordre, un seul candidat à la fois :
claude -p ... en headless, isolé de toute conversation —SOP_Juge_Produit_scriptee_DRAFT.md) et demandeproduct_judge.py check-eligible/verdict (ou -reserve si le sourcing aJUDGE_TIMEOUT_SEC) que ce fichier apparaisse.common.run_antigravity_direct, CLI headless agy -p ... — depuis le 14/10/2026,product_judge.py elle-même exactement commeJUDGE_TIMEOUT_SEC_ANTIGRAVITY (15 min) ; le fichier"timeout", candidat à rejuger manuellement plus tard.Piloter quel agent utiliser — champ judge_executor du state.json de la mission,
3 valeurs possibles (réglable à setup, à run, ou à tout moment via judge) :
- auto (défaut) : Claude d'abord, repli Antigravity automatique si besoin. C'est le
mode normal, à ne pas changer sauf raison précise.
- antigravity_only : saute directement Antigravity, sans passer par Claude. À utiliser
explicitement si le quota Claude est connu épuisé — évite d'attendre 20 min pour rien
avant le repli, sur CHAQUE candidat.
- claude_only : aucun repli (debug/comparaison uniquement).
Commandes utiles pour Antigravity si elle reprend seule :
# Rejuger un candidat resté en "timeout" (ex: après une coupure) :
python tools/chasse_orchestrateur.py judge --mission <nom> --candidate-id <id> --judge-executor antigravity_only
# Basculer TOUTE une mission sur Antigravity pour la suite (avant de relancer run) :
python tools/chasse_orchestrateur.py run --mission <nom> --objectif <N> --judge-executor antigravity_only
Important pour Antigravity : si tu es toi-même l'agent dispatché (processus CLI headless direct agy recevant le prompt qui commence par "Tu es le Juge Produit (agent antigravity)..."), suis-le
exactement comme un Cas C isolé de la SOP — n'ajoute PAS de contexte que tu aurais sur la
chasse en cours par ailleurs, c'est délibérément cloisonné.
"a_evaluer" de TOUTES les missions passées (pipelines/*/state.json), pasrun s'arrête aujourd'hui dès que N lignesstatut == "tracker_ecrit"), pas dès que N sont VALIDÉES par"Valide"), pas encore câblé.exclusion_detectee (signal calculé dans minea_scraper.py mais jamais consommé) :option-b-scan, Boutiques Tendances) : jamais câblée dans l'orchestrateurtools/stats_rejets.py — 11/11 disqualifications du Juge sont sur le filtre 2.1scan, triage, source (test isolé sourcing, n'écrit rien au Tracker), guardrail-check,
status (dump l'état complet d'une mission), judge (voir ci-dessus), mission-close
(clôture manuelle/secours — run le fait déjà tout seul en temps normal).