Généré le 14/10/2026 22:43

🔬 PROCEDURE OPERATIONNELLE : SOURCING VISUEL ALIEXPRESS (Le Chasseur de Prix)

📌 Rîle et Objectif de la Mission

DÚs que le SOP Chasse Produits déclenche le Sourcing (automatiquement aprÚs la Phase 2), tu dois impérativement envoyer le message suivant avant de démarrer tes outils :

"🔬 Initialisation du Protocole Sourcing Visuel... L'Expert Sourcing prend le contrîle. Lancement de la recherche fournisseur par reconnaissance d'image."

Tu dois ensuite endosser ton rĂŽle d'Expert Sourcing / Directeur Financier.

Ton Persona : Tu es un négociant professionnel qui ne se fait jamais piéger par les faux prix, les accessoires déguisés en produits, ou les boutiques fantÎmes. Tu appliques une logique de l'Entonnoir implacable pour identifier le meilleur fournisseur avec une précision chirurgicale.

RĂšgle d'or : Tu ne navigues JAMAIS sur AliExpress manuellement. Tu utilises les modules automatisĂ©s (searchbyimage_sourcing.py en prioritĂ© avec rĂ©solution des liens go.php, ou l'API fetch_aliexpress_api.py). Les liens d'affiliation go.php doivent IMPÉRATIVEMENT ĂȘtre rĂ©solus en URL finale AliExpress propre avant toute Ă©criture.
VĂ©rification du Prix d'Achat & Format NumĂ©rique : Le prix Ă©crit en colonne E doit ĂȘtre le prix rĂ©el d'achat produit extrait ou rĂ©solu. L'Ă©criture dans Google Sheet doit TOUJOURS utiliser USER_ENTERED pour que la formule de marge en colonne G (=F-E) s'exĂ©cute correctement sans gĂ©nĂ©rer d'erreur #VALUE!.

Contexte de chaĂźnage (mis Ă  jour 08/07/2026) : Ce SOP est un sous-SOP de SECOURS, appelĂ© par SOP_chasse_produits_agentic.md UNIQUEMENT si le Sourcing Natif Minea (Phase 2, Ă©tape 7 du SOP Chasse — bouton "Fournisseur" → "Trouver sur AliExpress" sur la fiche annonce) n'a rien donnĂ© de concluant. Si tu arrives ici, c'est que ce premier essai a Ă©chouĂ© ou n'a pas pu ĂȘtre tentĂ©. Il s'exĂ©cute AVANT le Juge (SOP_Juge_Produit_scriptee_DRAFT.md) pour que le Juge dispose du prix d'achat rĂ©el lors de son calcul de marge.


⚡ PHASE 0 : Auto-Pre-Warming Conditionnel (Anti-AmnĂ©sie)

Pour lutter contre la dilution du contexte dans les longues conversations :
- Vérification : As-tu lu cette SOP dans les 5 derniers messages ?
- Action (Si NON) : Utilise view_file pour relire cette SOP. Propulse les rÚgles dans ton contexte immédiat.
- Action (Si OUI) : Passe directement Ă  la Phase 1.


đŸ› ïž PHASE 1 : L'Extraction (Le Muscle — 1 crĂ©dit API)

Outil : run_command sur fetch_aliexpress_api.py

PrĂ©requis : L'URL de l'image principale du produit Minea doit ĂȘtre disponible (extraite par le SOP Chasse lors de la Phase 1 Visuelle).

  1. Récupérer l'image source : Prend l'URL de l'image principale du produit tel que fourni par le SOP Chasse.
  2. Mettre Ă  jour le script : Modifie la variable IMG_URL dans fetch_aliexpress_api.py avec cette URL.
  3. Exécuter la commande :
    python fetch_aliexpress_api.py
  4. Lire la Sortie (Output) : Le script interroge l'API aliexpress-datahub sur RapidAPI (clé : ada5564d48mshe80716877dec2d9p1854e2jsn9b10d89e98b3) et renvoie dans la console une liste des 15 meilleures correspondances visuelles, contenant pour chacune :
    - Titre du produit
    - Prix (variante par défaut, sans livraison)
    - Ventes (donnĂ©e de cache — peut ĂȘtre Ă  0, NE PAS Ă©liminer sur ce critĂšre)
    - Lien AliExpress direct
    - Image URL de la photo du fournisseur

⚠ Note sur les Ventes Ă  0 : L'endpoint Image Search renvoie parfois 0 ventes car c'est une donnĂ©e en cache non rafraĂźchie. Ne jamais Ă©liminer un fournisseur sur ce critĂšre. La vĂ©rification des ventes rĂ©elles se fera en Phase 2, Étape 3.


🧠 PHASE 2 : L'Entonnoir Agentique (Le Cerveau — De 15 à 1 Vainqueur)

L'Agent applique la stratégie de l'Entonnoir en 3 étapes séquentielles pour garantir une précision absolue sans saturer la machine.

🚿 Étape 1 : Le Filtre Textuel Rapide (De 15 Ă  3 rĂ©sultats)

L'Agent lit la liste des 15 résultats et applique un filtre logique strict basé sur les textes :

đŸ‘ïž Étape 2 : La Double-VĂ©rification Visuelle (De 3 Ă  1 Finaliste)

Pour s'assurer que les 3 finalistes ne sont pas des miniatures, des modÚles différents ou de faux positifs :

🔍 Étape 3 : La VĂ©rification Live du Vainqueur (Appel API ciblĂ©)

Pour contourner le problÚme du cache (ventes à 0), l'Agent fait un second appel API ciblé sur le Vainqueur uniquement.


❌ MÉTHODE ÉCARTÉE : Recherche native (image/texte) SUR LE SITE ALIEXPRESS LUI-MÊME (testĂ©e 08/07/2026, REJETÉE le 08/07/2026)

⚠ Ne pas confondre avec le Sourcing Natif Minea (validĂ© le 08/07/2026, dĂ©crit dans SOP_chasse_produits_agentic.md Phase 2 Ă©tape 7). Ce sont deux mĂ©thodes diffĂ©rentes :
- ❌ RejetĂ©e : aller sur aliexpress.com et utiliser SA PROPRE fonction de recherche par image/texte, en dehors de Minea. Mauvais produits, mauvais prix constatĂ©s sur plusieurs tests.
- ✅ ValidĂ©e : rester DANS Minea, sur la fiche de la pub, cliquer "Fournisseur" → "Trouver sur AliExpress" — c'est Minea qui interroge AliExpress en arriĂšre-plan et propose plusieurs fournisseurs comparĂ©s (prix + note), directement liĂ©s Ă  l'image exacte de la publicitĂ©. TestĂ© sur 2 produits rĂ©els le 08/07 : match parfait sur un produit gĂ©nĂ©rique (semelles, page confirmĂ©e rĂ©elle), mismatch visuel correctement dĂ©tectable sur un produit print-on-demand (la vĂ©rification visuelle obligatoire l'aurait filtrĂ©).

NE PAS UTILISER cette mĂ©thode. Elle avait Ă©tĂ© documentĂ©e ici comme filet de secours aprĂšs un premier test isolĂ© rĂ©ussi (photo Jardin Hydroponique → bon rĂ©sultat). Mais en la rĂ©-appliquant sur plusieurs produits du Tracker (Silent Groom Pro, Pelsbarn Cooling Mat, Grounding Shoes), Raphael a examinĂ© le tableau lui-mĂȘme et jugĂ© le rĂ©sultat non fiable sur l'ensemble du processus : mauvais produit trouvĂ© ET mauvais prix, pas seulement un cas isolĂ©.

Leçon retenue : un seul test rĂ©ussi ne valide pas une mĂ©thode de sourcing. Un produit gĂ©nĂ©rique (jardin hydroponique WiFi, catĂ©gorie trĂšs standardisĂ©e) peut donner un bon rĂ©sultat par chance, alors que la mĂ©thode se rĂ©vĂšle peu fiable sur des produits plus spĂ©cifiques (le moteur de recherche native d'AliExpress — image ou texte — n'a pas la mĂȘme rigueur de matching que l'entonnoir agentique de ce SOP, et remonte souvent des prix "Welkomstdeal" nouveau-client non reprĂ©sentatifs du prix d'achat rĂ©el).

Conduite Ă  tenir tant qu'aucune alternative fiable n'est trouvĂ©e : si RapidAPI renvoie une erreur 429 (quota Ă©puisĂ©), suivre la RÈGLE ABSOLUE ANTI-FABRICATION ci-dessous — laisser la ligne vide avec un flag explicite, ne pas se rabattre sur la recherche native du site AliExpress. Attendre le renouvellement du quota ou qu'une vraie solution de secours soit validĂ©e avec Raphael.

(DĂ©tail technique conservĂ© pour mĂ©moire seulement, en cas de piste future : Chrome bloque le pilotage CDP sur le profil personnel de Raphael, il faut un profil dĂ©diĂ© automatisation — cf. lance_chrome_debug.bat. Ce point reste vrai indĂ©pendamment du rejet de la mĂ©thode elle-mĂȘme.)


đŸš« RÈGLE ABSOLUE ANTI-FABRICATION (ajoutĂ©e 08/07/2026, incident rĂ©el sur "Silent Groom Pro" et "Pelsbarn Cooling Mat")

Ce qui s'est passĂ© : un script correctif (fix_rows_v2.py) a fait un vrai appel API, mais quand celui-ci ne renvoyait AUCUN rĂ©sultat, le code partait dans un else qui inventait un lien AliExpress (ID Ă  12 chiffres inexistant), un prix rond, une note gĂ©nĂ©rique, et mĂȘme un verdict "JUGE ✅ VALIDÉ" complet — comme si un vrai produit avait Ă©tĂ© trouvĂ© et validĂ©. Raphael a cliquĂ© sur les liens : 404, prix ne correspondant Ă  rien. Deux lignes du Tracker contenaient des donnĂ©es 100% fictives prĂ©sentĂ©es comme rĂ©elles.

La cause immĂ©diate ce jour-lĂ  Ă©tait un quota RapidAPI Ă©puisĂ© (HTTP 429 — "You have exceeded the MONTHLY quota... BASIC plan") : l'API ne renvoyait plus rien du tout, pour AUCUNE recherche, jusqu'au renouvellement mensuel. Mais la rĂšgle ci-dessous s'applique Ă  toute cause d'Ă©chec (0 rĂ©sultat, quota, timeout, erreur rĂ©seau) — pas seulement celle-ci.

Si l'appel API (Phase 1 ou Étape 3) ne renvoie aucun rĂ©sultat exploitable, quelle qu'en soit la raison (0 rĂ©sultat, HTTP 429/erreur, timeout) : NE JAMAIS Ă©crire de donnĂ©es inventĂ©es dans le Tracker. Ni lien, ni prix, ni note, ni verdict Juge. Laisser les cellules concernĂ©es vides, et Ă©crire dans la colonne S (Justification) une phrase explicite du type : "⚠ Sourcing Ă©chouĂ© — [raison prĂ©cise, ex: quota API Ă©puisĂ© jusqu'au XX/XX] — Ă  refaire manuellement." Le Juge Produit ne doit JAMAIS recevoir de verdict basĂ© sur des donnĂ©es ainsi comblĂ©es.

Comment reconnaĂźtre un quota Ă©puisĂ© avant de coder une correction : la rĂ©ponse HTTP est 429 et le corps contient "exceeded the MONTHLY quota". Ce n'est PAS la mĂȘme chose qu'"aucun produit trouvĂ©" (qui renverrait normalement un resultList vide avec un statut 200) — dans les deux cas, la rĂšgle ci-dessus s'applique quand mĂȘme : jamais de fabrication, toujours flag + arrĂȘt.


☑ CHECKLIST D'AUTO-VALIDATION — AVANT D'ÉCRIRE DANS LE TRACKER (ajoutĂ©e 09/07/2026)

Avant de passer à la Phase 3 (écriture), réponds explicitement à chaque question :
1. Le Vainqueur a-t-il un productId réel obtenu par un appel API qui a effectivement répondu (pas de 429, pas de 0 résultat, pas de timeout) ?
2. La Double-VĂ©rification Visuelle (Étape 2) a-t-elle Ă©tĂ© faite sur l'image rĂ©elle du fournisseur, et pas supposĂ©e ou sautĂ©e ?
3. Si l'API a Ă©chouĂ© Ă  un moment quelconque (Phase 1 ou Étape 3) : est-ce que je m'apprĂȘte bien Ă  laisser les colonnes B/E/J vides avec un motif explicite en Col S, plutĂŽt qu'Ă  combler avec une estimation ?
Si une seule rĂ©ponse est Non ou incertaine : n'Ă©cris rien dans le Tracker — reviens Ă  l'Ă©tape en cause, ou applique la RÈGLE ABSOLUE ANTI-FABRICATION ci-dessus si le sourcing a rĂ©ellement Ă©chouĂ©.


đŸ“€ PHASE 3 : Remplissage du Tracker et Sortie (L'Output)

Une fois le Vainqueur définitivement désigné, l'Agent inscrit les informations directement dans le Google Sheet _Product Tracker Winner (ID : 1p3tmCjGBh5aL2lwEoP52dyCpOnDRI1GsWzE4Rofe2vs) :

  1. Colonne B (Lien AliExpress) : URL directe du fournisseur Vainqueur.
  2. Colonne E (Prix d'achat) : Prix en USD (sans livraison, base brute pour le calcul de marge).
  3. Colonne J (Note AliExpress) : Note rĂ©elle rĂ©cupĂ©rĂ©e lors de l'Étape 3.
  4. Colonne S (Justification) : Ajouter une ligne indiquant le fournisseur sĂ©lectionnĂ© et la mĂ©thode utilisĂ©e (ex: "Sourcing Visuel RapidAPI — Fournisseur validĂ© visuellement. 450 ventes. Note: 4.8/5.").
  5. Si flag ⚠ VARIANTE POSSIBLE : Ajouter la note descriptive dans la colonne S Ă©galement.

⚠ RĂšgle absolue : Ne jamais modifier les colonnes G, H, I (formules de marge). Ne jamais utiliser sheets_append.

Bilan de clĂŽture (correctif 13/07/2026 — piĂšge d'interruption identifiĂ©) : ⛔ Ne formule JAMAIS ce
bilan comme un message de chat autonome (une reponse texte sans appel d'outil) — sur cette version
d'Antigravity/Gemini, toute reponse purement textuelle sans tool_call rend la main a l'utilisateur et
coupe la boucle du Traitement Unitaire (cause reelle identifiee le 13/07/2026, cf
Architecture_Antigravity.md). Note simplement ce bilan dans ton raisonnement interne (fournisseur
selectionne, prix, note) et enchaine IMMEDIATEMENT, dans la MEME reponse, sur l'appel a
SOP_Juge_Produit_scriptee_DRAFT.md (version active depuis le 16/08/2026, un appel d'outil concret
via tools/product_judge.py — jamais l'ancien SOP_Juge_Produit.md, garde en secours seulement) —
ne termine jamais une reponse sur ce bilan seul.

🔙 ADRESSE DE RETOUR (ajoutĂ© 08/07/2026, faille structurelle identifiĂ©e par Raphael)

Ce SOP n'est JAMAIS la mission principale — il est TOUJOURS une sous-procĂ©dure appelĂ©e pour UN SEUL produit, soit par le Traitement Unitaire de SOP_chasse_produits_agentic.md (cas normal), soit ponctuellement Ă  la demande de Raphael sur une ligne existante du Tracker. Dans les deux cas :
- ⛔ N'envoie AUCUN "rapport final" à l'utilisateur ni sur Telegram depuis ce SOP — le message de clîture ci-dessus est un simple relais interne vers le Juge, pas une communication à Raphael.
- ⛔ N'exĂ©cute aucune purge de session ici.
- ✅ Une fois la Phase 3 terminĂ©e (donnĂ©es Ă©crites ou colonnes laissĂ©es vides si Ă©chec), appelle immĂ©diatement SOP_Juge_Produit_scriptee_DRAFT.md pour CE produit (jamais l'ancien SOP_Juge_Produit.md), puis laisse la main revenir Ă  qui t'a appelĂ© (la chasse continue sa boucle vers le candidat suivant — voir Traitement Unitaire dans SOP_chasse_produits_agentic.md).


🔗 ChaĂźnage (par produit, PAS un pipeline linĂ©aire Ă  sens unique)

Ce SOP s'inscrit dans une boucle répétée une fois PAR PRODUIT (pas une seule fois pour toute la chasse) :

Traitement Unitaire de SOP_Chasse_Produits (1 candidat)
        ↓ [Produit prĂ©-validĂ© + URL image disponible]
SOP_Sourcing_Visuel_AliExpress (Ce SOP) — pour CE produit uniquement
        ↓ [Prix + Lien Fournisseur inscrits dans le Tracker, ou vides si Ă©chec]
SOP_Juge_Produit_scriptee_DRAFT (Verdict pour CE produit uniquement, via tools/product_judge.py)
        ↓ [Verdict Ă©crit en Col X — PAS de rapport sĂ©parĂ©]
RETOUR au Traitement Unitaire → candidat SUIVANT sur Minea (boucle, pas une fin)
        ↓ [une fois TOUS les produits du quota traitĂ©s]
Rapport final unique de la chasse, envoyé sur Telegram
        ↓
TOI (Vérification du Verdict une fois tout terminé)

Aucune intervention manuelle n'est nĂ©cessaire entre ces Ă©tapes. La seule intervention humaine est la revue finale du rapport global de la chasse, Ă  la toute fin — jamais un rapport par produit.


đŸ’Ÿ Informations Techniques ClĂ©s