Un agent IA excelle dans la partie fastidieuse de la recherche e-commerce : lancer dix recherches, ouvrir les résultats, les comparer et rédiger ce qu'ils ont en commun. Ce qui lui manque, à lui seul, ce sont les données. Demandez à un assistant conversationnel quelles boutiques progressent dans une niche : il ne peut que deviner à partir de ce qu'il a appris pendant son entraînement.
MCP règle ce problème en donnant à l'agent des outils qu'il peut appeler pour obtenir des données en direct. Connectez un agent au serveur MCP de SellWinners et il peut rechercher lui-même des boutiques Shopify, des publicités et des e-mails marketing, puis vous remettre un tableau ou un brief. Voici comment fonctionne MCP, comment connecter votre agent, les prompts qui donnent de bons résultats et comment les appels sont décomptés de votre offre.
MCP, en termes simples
MCP signifie Model Context Protocol. C'est un standard ouvert qui permet de connecter des assistants IA à des outils et à des données externes.
Il comporte deux côtés. Un serveur MCP publie une liste d'outils : le nom de chacun, ce qu'il fait et les arguments qu'il accepte. Un client MCP est l'application avec laquelle vous dialoguez, comme Claude Desktop, Cursor ou VS Code. Le client présente la liste des outils au modèle. Quand votre question nécessite des données, le modèle choisit un outil et renseigne les arguments, le client exécute l'appel, et le résultat revient au modèle, qui le lit avant de répondre ou d'appeler l'outil suivant.
Pour la recherche, cela change le travail. Vous posez une question en langage courant, l'agent choisit et enchaîne les outils, et vous examinez la réponse. Vous n'écrivez pas de code, et l'agent travaille avec les mêmes données que l'application web et l'API REST de SellWinners.
Ce que l'agent peut faire avec SellWinners
Le serveur expose le produit sous forme d'outils prêts à l'emploi. Voici ceux que vous utiliserez le plus pour la recherche :
| Outil | À quoi ça sert |
|---|---|
lookup | Convertit un nom de marque, un domaine de boutique ou un ID de page Facebook en ID utilisés par les autres outils |
search_shops | Recherche ou parcourt les boutiques Shopify avec des filtres |
find_winning_products | Les produits qui se vendent en ce moment dans une niche |
find_similar_shops | Les concurrents d'une boutique, par ID ou par domaine |
brief_competitor | Un brief concis sur un concurrent |
search_ads | Recherche des publicités Meta par mots du texte, de la marque ou de la page de destination |
scan_ad | La fiche complète d'une publicité Meta |
creative_inspiration_pack | De l'inspiration créative pour une niche |
search_google_ads_library | Recherche des publicités Google |
search_tiktok_library | Recherche des publicités et des publications organiques TikTok |
search_emails | Recherche les e-mails marketing des marques |
analyze_shop_emails | La stratégie e-mail d'une boutique |
analyze_brand_changes | Ce qui a changé pour une marque suivie sur une période |
usage_get | Votre offre, vos crédits mensuels et combien vous en avez utilisé |
Il y en a d'autres pour suivre des marques, enregistrer des éléments dans des tableaux et des favoris, et partager. La page MCP liste chaque outil avec ses arguments.
Comment connecter votre agent à SellWinners
- Créez une clé API. Inscrivez-vous, puis créez une clé dans votre tableau de bord. Les comptes Free créent aussi des clés : l'offre Free comprend l'application web et le serveur MCP (150 crédits par mois), sans l'API (voir les offres et leurs prix). Créez une clé réservée à votre agent, pour pouvoir la révoquer séparément plus tard.
- Ajoutez le serveur à votre client. Votre client a besoin de trois choses : l'URL de l'endpoint indiquée sur la page MCP, le transport HTTP streamable et votre clé dans un en-tête
X-API-Key(ouAuthorization: Bearersuivi de la clé). La page MCP propose des configurations prêtes à l'emploi pour Cursor, VS Code et Claude Desktop. Claude Desktop se connecte via la passerellemcp-remote, qui nécessite Node.js. - Vérifiez que tout fonctionne. Demandez à votre agent : « Combien de mes crédits SellWinners ai-je utilisés ce mois-ci ? » Il devrait appeler
usage_getoucheck_credits, et aucun des deux ne coûte de crédit.
Les autres clients et frameworks d'agents fonctionnent s'ils prennent en charge les serveurs MCP distants en HTTP streamable avec un en-tête personnalisé. Si vous utilisez un autre assistant, ChatGPT par exemple, vérifiez si votre version vous permet d'ajouter un serveur MCP distant avec un en-tête personnalisé. Si c'est le cas, ces trois mêmes valeurs suffisent.
Des prompts qui fonctionnent
Les agents donnent le meilleur d'eux-mêmes avec des questions précises : nommez la niche, le marché, le nombre de résultats souhaités et la forme de la réponse. Vous pouvez nommer des outils pour orienter l'agent, ou lui laisser le choix.
Recherche de produits
Utilisez find_winning_products pour « toilettage pour chiens ». Utilisez ensuite search_shops pour trouver les boutiques Shopify de cette niche qui vendent aux États-Unis avec au moins 20 000 visites mensuelles, triées par croissance du trafic sur 30 jours. Donnez-moi un tableau du top 10 avec la boutique, les visites mensuelles, la croissance, la meilleure vente et son prix.
Poursuivez avec « pour les trois premières, utilisez brief_competitor et dites-moi ce qu'elles ont en commun ». Avant de miser sur un produit gagnant potentiel, passez vos propres coûts au prix du marché dans le calculateur de marge bénéficiaire.
Recherche sur les publicités des concurrents
Utilisez search_ads pour lister les publicités Meta actives de [domaine du concurrent] diffusées depuis au moins 30 jours, triées par portée. Pour chacune, donnez l'accroche d'ouverture, le titre, l'appel à l'action, la page de destination et les jours de diffusion. Résumez ensuite les trois angles qui reviennent le plus.
Cela transforme une recherche dans une bibliothèque publicitaire en brief créatif. Demandez la même marque avec search_tiktok_library et search_google_ads_library pour comparer les canaux, ou utilisez creative_inspiration_pack sur toute une niche quand vous avez besoin de nouvelles accroches.
Analyses détaillées de boutiques
Donnez-moi un brief sur [domaine du concurrent] avec brief_competitor. Utilisez ensuite find_similar_shops trié par visites mensuelles et comparez les cinq premières boutiques dans un tableau : visites mensuelles, croissance sur 30 jours, publicités actives, nombre de produits. Terminez avec analyze_shop_emails pour la première boutique : à quelle fréquence elle envoie des e-mails, quels jours et avec quelles promotions.
Le guide pour analyser n'importe quelle boutique Shopify liste tout ce qui mérite d'être vérifié dans une analyse détaillée.
Assurer la veille
Ajoutez [domaine du concurrent] à mon suivi de marques.
Puis, une fois par semaine, demandez :
Utilisez analyze_brand_changes sur [domaine du concurrent] pour les 7 derniers jours. Quelles nouvelles publicités a-t-il lancées, et lesquelles ont gagné des places ?
Le suivi des marques de votre choix fait partie des offres payantes. L'agent peut aussi enregistrer ce qu'il trouve : demandez-lui de créer un tableau et d'y ajouter les cinq meilleures publicités avec create_board et add_board_item.
Comment les appels d'outils consomment vos crédits
- Un appel d'outil coûte les résultats qu'il renvoie. 1 crédit = 1 résultat renvoyé : les informations d'une marque, une publicité ou une ligne d'une liste. Un résultat vide est gratuit. Les appels MCP sont décomptés des crédits mensuels de votre offre, les mêmes que ceux de l'API REST.
- Certains appels sont gratuits. Les appels échoués ne coûtent rien, pas plus que
usage_get,check_credits,lookupetlookup_filter_ids. Les appels bloqués par la limite de débit et ceux dont les paramètres sont rejetés ne coûtent rien non plus. - Une question peut entraîner plusieurs appels. Le prompt d'analyse détaillée ci-dessus en fait au moins trois :
brief_competitor,find_similar_shopsetanalyze_shop_emails. Chacun coûte les résultats qu'il renvoie, et unlookuppréalable ne coûte rien. Demandez moins de résultats pour dépenser moins. - L'application web n'est pas décomptée. Naviguer et vérifier des résultats dans l'application n'utilise aucun de vos crédits.
- Les crédits sont mensuels. Ils se renouvellent le 1er du mois (UTC). Une fois qu'ils sont épuisés, les appels suivants sont refusés jusqu'au renouvellement, sauf si le propriétaire de votre espace de travail achète des crédits de recharge ou passe à une offre supérieure. Une limite de débit par minute, partagée par tout l'espace de travail, s'applique aussi.
Les bonnes pratiques de la recherche avec un agent
- Demandez les sources. Faites indiquer à l'agent quel outil il a appelé, avec quels filtres, et lister les domaines ou les ID derrière chaque constat pour que vous puissiez les ouvrir.
- Tenez-le aux données. Demandez-lui de n'utiliser que les chiffres issus des résultats d'outils et de dire clairement quand une recherche n'a rien donné. Cela l'empêche de combler les trous par des suppositions.
- Vérifiez ce qui guide une décision. Avant de commander du stock ou de briefer une équipe créative, ouvrez les boutiques clés dans la page Boutiques de l'application et les publicités clés dans sa page Publicités.
- Gardez en tête ce qui est estimé. Le trafic, les ventes et les dépenses publicitaires des autres marques sont des estimations. Utilisez-les pour comparer, pas comme des chiffres exacts.
- Cadrez vos prompts. Un marché, une limite de résultats et un format de sortie clair consomment moins d'appels que « dites-moi tout sur les produits pour animaux ».
- Lisez avant de confirmer. Les outils qui suppriment ou partagent quelque chose ne s'exécutent qu'avec une confirmation explicite : vérifiez donc ce que l'agent propose avant d'accepter.
- Enregistrez les prompts qui marchent. Un bon prompt d'analyse détaillée ou de recherche publicitaire devient un modèle que vous réutilisez chaque semaine.
Le faire avec SellWinners : agent, application et API
Une seule clé API couvre les trois points d'accès, et l'agent en fait partie. Utilisez chacun pour ce qu'il fait le mieux :
- L'application web pour parcourir et vérifier : filtrez les boutiques sur la page Boutiques, lisez les publicités sur la page Publicités, suivez des marques dans vos suivis de marques et gardez vos trouvailles sur vos tableaux.
- L'agent via MCP pour les questions qui demandent d'assembler plusieurs recherches : explorations de niche, analyses détaillées, briefs publicitaires et résumés hebdomadaires de ce qui a changé.
- L'API REST pour les tâches qui s'exécutent toujours de la même façon, comme un export quotidien. La documentation de l'API liste chaque endpoint.
Pour voir les données derrière chaque outil, commencez par Boutiques, Bibliothèque de publicités, Analyse de boutique et Suivi de marques.
À retenir
- MCP permet à un agent IA d'appeler des outils pour obtenir des données en direct au lieu de deviner à partir de son entraînement.
- La connexion demande trois valeurs : l'URL de l'endpoint, le transport HTTP streamable et votre clé API dans un en-tête.
- Les prompts précis (niche, marché, nombre de résultats, format de sortie) donnent les meilleures réponses et consomment moins d'appels.
- Un appel d'outil coûte les résultats qu'il renvoie, sur vos crédits mensuels, partagés avec l'API REST. Les vérifications de consommation, les appels lookup et les appels échoués sont gratuits.
- Demandez les sources, limitez l'agent aux résultats des outils et vérifiez les chiffres clés dans l'application web avant d'agir.