Serveur MCP

Donnez à votre agent IA l'intelligence des publicités et des boutiques

Le serveur MCP de SellWinners expose nos données sous forme de 73 outils. Pointez n'importe quel client MCP vers l'endpoint, connectez-vous depuis ChatGPT ou Claude ou ajoutez votre clé API, et votre agent peut rechercher des publicités, examiner des boutiques Shopify, rechercher leurs produits et récupérer des visuels de lui-même.

  • HTTP streamable
  • Connexion pour ChatGPT et Claude, ou votre clé API
  • Partage les crédits de votre offre
# Endpoint
https://mcp.sellwinners.com/mcp

# Transport
streamable HTTP

# Auth
OAuth sign-in (ChatGPT, Claude)
# or X-API-Key: YOUR_API_KEY
# or Authorization: Bearer YOUR_API_KEY
Comment il se connecte

Trois étapes jusqu'au premier appel de votre agent

01

Connectez-vous ou créez une clé

Commencez gratuitement, puis connectez-vous depuis ChatGPT ou Claude, ou créez une clé dans votre tableau de bord. L'offre Free inclut aussi le serveur MCP : 150 crédits par mois, 10 requêtes par minute, les 10 premiers résultats de chaque recherche.

02

Ajoutez le serveur à votre client

Collez la configuration ci-dessous dans Cursor, VS Code, Claude ou tout client compatible avec les serveurs MCP distants.

03

Interrogez votre agent

Essayez « trouvez les meilleures publicités vidéo pour des chaussures de running ce mois-ci ». Votre agent choisit seul le bon outil.

Configuration

Configurez-le dans votre client

ChatGPT et Claude passent par une connexion ; ailleurs, remplacez YOUR_API_KEY par une clé de votre tableau de bord.

No API key: these sign in with your SellWinners account.
L'offre Free inclut aussi le serveur MCP : 150 crédits par mois,
10 requêtes par minute, les 10 premiers résultats de chaque
recherche.

1. In ChatGPT (an app or a connector in developer mode) or in
   Claude (Customize → Connectors → Add custom connector; on Team or
   Enterprise an Owner adds it and you select Connect),
   add this server URL:  https://mcp.sellwinners.com/mcp
2. Choose OAuth if asked. A SellWinners window opens:
   log in, then select Allow.
3. Ask: "Find the top video ads for running shoes this month".

Disconnect any time: Settings → MCP → Connected apps.
Outils

73 outils, prêts à l'emploi

Ouvrez un outil pour voir les arguments qu'il accepte. Ceux qui sont mis en évidence sont obligatoires.

Découverte

3 outils
lookupConvertir un nom de marque, un domaine de boutique ou un ID de page Facebook en ID utilisables avec les autres outils
3 arguments
qtexttypetextlimitnumber
lookup_filter_idsID pour les filtres des outils de recherche
7 arguments
typetextquerytextscope_tracked_pageslistscope_domaintextstatustextlimitnumbersnapshot_datetext
list_saved_viewsLes recherches enregistrées sur les pages de liste du site, prêtes pour les outils de recherche
1 argument
contexttext

Boutiques

17 outils
search_shopsRechercher ou parcourir les boutiques Shopify
48 arguments
querytextmatch_modetextcountrytextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtextcreation_countrytextcreation_countrieslistexclude_creation_countrieslistcreation_date_fromtextcreation_date_totextmin_active_adsnumbermax_active_adsnumbermin_monthly_visitsnumbermax_monthly_visitsnumbermin_products_countnumbermax_products_countnumberads_time_periodtexttraffic_growthlistads_growthlistvisitor_countrytextmain_market_countrieslistmarket_countrieslistexclude_market_countrieslistniche_idnumberlanguageslistcurrencieslisttheme_idslistpixel_idslistexclude_pixel_idslistshopify_app_idslistexclude_shopify_app_idslistis_shopify_plustrue / falsemin_trustpilot_ratingnumbermax_trustpilot_ratingnumbermin_trustpilot_review_countnumbermax_trustpilot_review_countnumbermin_monthly_salesnumbermax_monthly_salesnumbermin_units_soldnumbermax_units_soldnumberhas_tiktoktrue / falseexclude_currencieslistsocial_networkslistshopify_plantext
find_similar_shopsConcurrents d'une boutique (ID ou domaine)
10 arguments
shoptextlimitnumbersort_bytextordertextoffsetnumberseasontextfiltersobjectmarkettextexclude_shopslistdetailtext
find_winning_productsLes produits qui se vendent en ce moment dans une niche
5 arguments
nichetextkeywordslistcountrytextmax_resultsnumberdetailtext
search_productsRechercher ou parcourir les produits des boutiques par prix, ventes, unités vendues, pays de vente, publicités, portée, avis, date de lancement, devise ou pays de la boutique
37 arguments
querytextsearch_intextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtextshoptextshop_idtextmin_pricenumbermax_pricenumbermin_monthly_revenuenumbermax_monthly_revenuenumbermin_monthly_units_soldnumbermax_monthly_units_soldnumbermin_active_adsnumbermax_active_adsnumberads_launched_periodtextmin_ads_launchednumbermax_ads_launchednumbermin_ad_sharenumbermax_ad_sharenumbermin_eu_ad_spendnumbermax_eu_ad_spendnumbermin_ratingnumbermin_reviewsnumbersubscriptiontextpartnershiptrue / falseselling_countrieslistmain_selling_countrytextexclude_selling_countrieslistshop_countrieslistcurrencieslistmin_shop_monthly_visitsnumbermax_shop_monthly_visitsnumbershop_created_aftertext
search_products_by_imageTrouver les produits des boutiques qui ressemblent à une image (URL d'image ou fichier), avec leurs boutiques
12 arguments
image_urltextimage_base64textsort_bytextordertextmax_per_shopnumberfiltersobjectpagenumberlimitnumbersearch_idtextdetailtextoffsetnumbergroup_brandstrue / false
search_shops_by_imageTrouver les boutiques qui vendent ce que montre une image, avec leurs produits les plus proches
7 arguments
image_urltextimage_base64textsearch_idtextlimitnumberoffsetnumbergroup_brandstrue / falseproducts_per_shopnumber
get_productUn produit avec sa fiche complète : photos, options et variantes
2 arguments
product_idtexturltext
get_product_adsLes publicités Meta qui renvoient vers la page d'un produit
5 arguments
product_idtextstatustextpagenumberlimitnumberdetailtext
analyze_productUn produit, ses dernières publicités et une lecture de ses signaux
3 arguments
product_idtexturltexttop_adsnumber
product_launch_radarProduits lancés récemment, classés par ventes ou pression publicitaire
34 arguments
querytextdaysnumberrank_bytextlimitnumberfiltersobjectdetailtextshop_idtextmin_pricenumbermax_pricenumbermin_monthly_revenuenumbermax_monthly_revenuenumbermin_monthly_units_soldnumbermax_monthly_units_soldnumbermin_active_adsnumbermax_active_adsnumberads_launched_periodtextmin_ads_launchednumbermax_ads_launchednumbermin_ad_sharenumbermax_ad_sharenumbermin_eu_ad_spendnumbermax_eu_ad_spendnumbermin_ratingnumbermin_reviewsnumbersubscriptiontextpartnershiptrue / falseselling_countrieslistmain_selling_countrytextexclude_selling_countrieslistshop_countrieslistcurrencieslistmin_shop_monthly_visitsnumbermax_shop_monthly_visitsnumbershop_created_aftertext
create_product_share_linkCréer (ou renvoyer) le lien public d'un produit
2 arguments
product_idtextconfirmtrue / false
delete_product_share_linkSupprimer le lien public d'un produit
2 arguments
product_idtextconfirmtrue / false
brief_competitorUne fiche compacte sur un concurrent (ID de boutique, domaine ou nom)
11 arguments
competitortextsectionslistmax_productsnumbermax_emailsnumbermax_adsnumbershoptextad_rank_windowtextad_rank_sorttextmax_current_ranknumbermin_rank_deltanumbersnapshot_datetext
shop_reportUn rapport sur une boutique : son fil, ses pages Facebook, sa saison T4, une page de destination, son classement publicitaire ou ses tests de visuels
19 arguments
shoptextreporttextyearnumberdate_fromtextdate_totexturltextadvertiser_idtextmodetextdaysnumberad_idslistdatetextas_oftextmedia_typetextstatustextkeywordslistsnapshot_datetextpagenumberlimitnumberdetailtext
compare_shopsUn même indicateur pour plusieurs boutiques côte à côte
3 arguments
shopslistmetrictextsnapshot_datetext
market_overviewL'ensemble du marché, jour par jour, ou sur une saison T4
5 arguments
kindtextyearnumberdate_fromtextdate_totextlimitnumber
detect_shopify_storeSi une boutique tourne sous Shopify, son thème et les applications Shopify qu'elle charge
1 argument
urltext

Publicités et médias

8 outils
search_adsRechercher des publicités Meta (Facebook / Instagram) par mots du texte, de la marque ou de la page de destination
97 arguments
querytextkeywordslistmedia_typetextcountrytextstatustextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtextcategory_idslistad_countriesobjectmain_countrieslistmin_traffic_growth_percentnumbertraffic_growth_periodtexttraffic_growthlistads_growthlistpage_reach_growthlistad_reach_growthlistad_languagetextlanguagetextad_languageslistctalistshopify_app_idslistexclude_shopify_app_idslistpixel_idslistexclude_pixel_idslisttheme_idslistcreated_aftertextcreated_beforetextlast_seen_aftertextlast_seen_beforetextmin_days_runningnumbermax_days_runningnumbermin_duplicatesnumbermax_duplicatesnumbermax_ad_ordernumberad_rank_modetextad_rank_basistextmax_ad_rank_valuenumbergrowth_ranklistrank_delta_windowtextmin_rank_deltanumbermin_description_lengthnumbermax_description_lengthnumbermin_video_durationnumbermax_video_durationnumbermin_reachnumbermax_reachnumberreach_periodtextmin_agenumbermax_agenumbersextextpartnerstrue / falsemin_trafficnumbermax_trafficnumbermin_active_adsnumbermax_active_adsnumbermin_productsnumbermax_productsnumbermin_best_seller_pricenumbermax_best_seller_pricenumberads_time_periodtextshop_created_aftertextshop_created_beforetextshop_creation_countriesobjectmarketobjectshopify_plustextmin_spendnumbermax_spendnumbercpmnumberspend_periodtextmin_spend_per_pagenumbermax_spend_per_pagenumberspend_per_page_periodtextmin_facebook_likesnumbermax_facebook_likesnumbermin_instagram_followersnumbermax_instagram_followersnumbermin_reach_per_pagenumbermax_reach_per_pagenumberreach_per_page_periodtexttechnologieslisttracked_pageslistmax_ads_per_brandnumbertrend_signaltextactive_onlytrue / falseexclude_formatslistexclude_ad_languageslistage_rangeslistexclude_age_rangeslistexclude_theme_idslistmin_page_ads_launchednumbermax_page_ads_launchednumberpage_ads_launched_periodtextshopify_stores_onlytrue / false
scan_adLa fiche complète d'une publicité Meta (ou d'une publicité Google ou d'une publication TikTok)
1 argument
ad_identifiertext
creative_inspiration_packDe l'inspiration créative pour une niche
5 arguments
nichetextkeywordslistfocustextmax_adsnumbertrend_signaltext
search_google_ads_libraryRechercher des publicités Google
57 arguments
querytextkeywordsliststatustextcountrytextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtextpublished_aftertextpublished_beforetextfirst_seen_aftertextfirst_seen_beforetextmin_days_runningnumbermax_days_runningnumberplatformtextplatformslistaudience_countrytextaudience_countrieslistexclude_audience_countrieslistformattextformatslistwebsite_idtextwebsite_idslisteu_onlytrue / falsemin_reachnumbermax_reachnumbermin_advertiser_reachnumbermax_advertiser_reachnumberremarketingtrue / falseinterest_targetingtrue / falsemain_market_countrieslistexclude_theme_idslistmin_trafficnumbermax_trafficnumbermin_productsnumbermax_productsnumbermin_best_seller_pricenumbermax_best_seller_pricenumbershop_creation_aftertextshop_creation_beforetextshop_creation_countrieslistexclude_shop_creation_countrieslistmarket_countrieslistexclude_market_countrieslistniche_idslistpixelslistexclude_pixelslistshopify_appslistexclude_shopify_appslistthemeslisttraffic_growthlistsnapshot_datetexthide_non_eu_uk_adstrue / falsehide_low_reach_adstrue / falsehide_low_impression_adstrue / false
search_tiktok_libraryRechercher des publicités et des publications organiques TikTok
66 arguments
querytextkeywordslisttypetextcountrytextdomaintexthandletextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtextsearch_intextsearch_areatextitem_typetextstatustextmedia_typetextmedia_typeslistlanguagetextlanguageslistcountrieslistcategorieslisthashtagslisttiktok_page_idtexttiktok_page_idslistwebsite_idtexthas_shop_linkedtextpublished_aftertextpublished_beforetextupdated_aftertextupdated_beforetextmin_days_runningnumbermax_days_runningnumbermin_viewsnumbermax_viewsnumbermin_followersnumbermin_profile_viewsnumbermax_followersnumbermax_profile_viewsnumberprofile_created_aftertextprofile_created_beforetextmin_profile_ads_sharenumbermax_profile_ads_sharenumbermin_profile_postsnumbermax_profile_postsnumbermarket_countrieslistmain_market_countrieslistexclude_market_countrieslistshop_creation_countrieslistexclude_shop_creation_countrieslistmin_trafficnumbermax_trafficnumbermin_productsnumbermax_productsnumbermin_best_seller_pricenumbermax_best_seller_pricenumbershop_creation_aftertextshop_creation_beforetextshopify_appslistexclude_shopify_appslistthemeslistexclude_theme_idslistpixelslistexclude_pixelslistis_pinnedtrue / falsetrend_signaltext
create_ad_share_linkCréer (ou renvoyer) le lien public d'une publicité
2 arguments
ad_idtextconfirmtrue / false
delete_ad_share_linkSupprimer le lien public d'une publicité
2 arguments
ad_idtextconfirmtrue / false
write_ad_hooksRédiger trois courtes phrases d'ouverture (accroches) pour une publicité d'un produit, pour Meta, TikTok ou les deux
7 arguments
nichetextproducttextangletextplatformtextlanguagetextregeneratetextidempotency_keytext

Annonceurs et e-mails

5 outils
search_advertisersRechercher des annonceurs (pages Facebook)
26 arguments
querytextkeywordslistsearch_intextcountrytextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtextcategory_idslisttimeframetextexclude_age_rangeslistmarket_countrieslistmain_market_countrieslistexclude_market_countrieslistshop_creation_countrieslistexclude_shop_creation_countrieslistmin_productsnumbermax_productsnumbershop_creation_aftertextshop_creation_beforetextshopify_appslistexclude_shopify_appslistthemeslistexclude_theme_idslist
scan_advertiserLa fiche d'un annonceur, ou ses publicités actives et sa portée jour par jour
4 arguments
advertiser_idtextviewtextdaysnumbersnapshot_datetext
search_emailsRechercher les e-mails marketing des marques par mots de l'objet, de l'expéditeur ou du contenu
11 arguments
querytextshoptextcampaign_typetextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtexttimeframetextintenttext
get_email_htmlLe HTML brut d'un e-mail (utilisez d'abord search_emails pour trouver l'ID)
4 arguments
email_idtextinclude_htmltrue / falseshoptexthtml_partnumber
analyze_shop_emailsLa stratégie e-mail d'une boutique
2 arguments
shoptextmax_emailsnumber

Marques suivies

14 outils
list_tracked_brandsLes marques que vous suivez, avec leurs compteurs de publicités actives
6 arguments
pagenumberlimitnumberfolder_idslistnametextsort_bytextfolder_idnumber
add_to_brandtrackerCommencer à suivre une marque
5 arguments
facebook_page_idtextwebsite_idtextshop_idtextdomaintextfolder_idnumber
delete_from_brandtrackerArrêter de suivre une marque
3 arguments
brandtracker_idtextconfirmtrue / falseworkspace_link_idnumber
list_brandtracker_foldersVos dossiers de suivi
create_brandtracker_folderCréer un dossier de suivi
1 argument
nametext
rename_brandtracker_folderRenommer un dossier de suivi
2 arguments
folder_idnumbernametext
delete_brandtracker_folderSupprimer un dossier de suivi
3 arguments
folder_idnumberactiontextconfirmtrue / false
move_tracked_brandsDéplacer des marques suivies dans un dossier (folder_id=null les sort de tout dossier)
3 arguments
brandtracker_idslistfolder_idnumberworkspace_link_idslist
get_brand_activityCe qu'une marque suivie a fait sur Meta, TikTok, Google et par e-mail
11 arguments
brandtracker_idtextbrandtextviewtextsourcetextsincetextuntiltextdaytexttypeslistpagenumberlimitnumberdetailtext
analyze_tracked_brandUne analyse approfondie d'une marque suivie
4 arguments
brandtracker_idtextbrandtextsnapshot_datetextdetailtext
analyze_brand_changesCe qui a changé pour une marque suivie sur une période (1d, 7d, 14d, 30d ; le rang gagné se lit sur 7d pour 1d, les accroches sur 30d pour 14d, les tests de visuels sont les plus récents)
6 arguments
brandtracker_idtextbrandtextperiodtextfocustextsnapshot_datetextdetailtext
get_brandtracker_scaling_adsLes publicités d'une marque suivie qui ont gagné le plus de places, avec l'historique de leur rang
32 arguments
brandtracker_idtextbrandtextad_rank_windowtextad_rank_sorttextmax_current_ranknumbermin_rank_deltanumberpagenumberlimitnumberdetailtextfacebook_page_idtextall_facebook_pagestrue / falseordertextgrowth_ranklistquerytextkeywordslistmedia_typetextstatustextcreated_aftertextcreated_beforetextmin_days_runningnumbermax_days_runningnumbermin_duplicatesnumbermax_duplicatesnumberad_languagetextad_languageslistad_countriesobjectmain_countrieslistctalistad_copy_hasheslistpartnerstrue / falsepartner_idslisthide_low_impressionstrue / false
get_brandtracker_transcriptsScripts vidéo d'une marque suivie, regroupés par texte
9 arguments
brandtracker_idtextbrandtexttime_periodtextpagenumberlimitnumbereu_onlytrue / falseordertextsort_bytextsnapshot_datetext
daily_radarSynthèse quotidienne de vos marques suivies
4 arguments
folder_idslistfocustextevent_typeslistfolder_idnumber

Tableaux

14 outils
list_boardsVos tableaux
8 arguments
scopetextstatetextkindtextsurfacetextparent_board_idtextroot_onlytrue / falsepagenumberlimitnumber
get_boardUn tableau
1 argument
board_idtext
create_boardCréer un tableau
6 arguments
nametextkindtextsurfacetextdescriptiontextvisibilitytextparent_board_idtext
update_boardRenommer un tableau, modifier sa description ou sa visibilité
4 arguments
board_idtextnametextdescriptiontextvisibilitytext
move_boardDéplacer un tableau dans un tableau dossier (parent_board_id=null le place au premier niveau)
2 arguments
board_idtextparent_board_idtext
archive_boardArchiver un tableau et tout ce qu'il contient (restore_board le restaure)
2 arguments
board_idtextconfirmtrue / false
restore_boardRestaurer un tableau archivé
1 argument
board_idtext
list_board_itemsLes éléments enregistrés dans un tableau
3 arguments
board_idtextpagenumberlimitnumber
find_saved_itemsRechercher dans tout ce que vous avez enregistré, dans chaque tableau et dans vos favoris
13 arguments
querytextsource_typeslistboard_idtextscopetextstatetextsaved_fromtextsaved_totextsort_bytextordertextpagenumberlimitnumberinclude_itemstrue / falsedetailtext
add_board_itemEnregistrer un élément dans un tableau collection
5 arguments
board_idtextsource_typetextsource_idtextsource_indextextpositionnumber
move_board_itemDéplacer un élément enregistré vers un autre tableau
4 arguments
board_idtextitem_idtexttarget_board_idtextpositionnumber
remove_board_itemRetirer un élément enregistré d'un tableau
3 arguments
board_idtextitem_idtextconfirmtrue / false
create_board_share_linkCréer un lien public vers un tableau
2 arguments
board_idtextconfirmtrue / false
delete_board_share_linkSupprimer les liens publics d'un tableau
2 arguments
board_idtextconfirmtrue / false

Favoris

10 outils
list_favoritesVos publicités, boutiques ou e-mails enregistrés
6 arguments
kindtextscopetextfolder_idtextpagenumberlimitnumberdetailtext
add_favorite_itemEnregistrer une publicité, une boutique ou un e-mail
4 arguments
kindtextitem_idtextscopetextfolder_idtext
move_favorite_itemDéplacer un favori enregistré dans un dossier (folder_id=null le sort de tout dossier)
4 arguments
kindtextfavorite_idtextscopetextfolder_idtext
remove_favorite_itemRetirer un favori enregistré, par son propre ID (favorite_id) ou par l'ID de l'élément enregistré (item_id)
5 arguments
kindtextscopetextfavorite_idtextitem_idtextconfirmtrue / false
create_favorite_folderCréer un dossier de favoris
4 arguments
kindtextnametextscopetextparent_idtext
update_favorite_folderRenommer un dossier de favoris, ou le déplacer (move=true avec parent_id, null pour le premier niveau)
6 arguments
kindtextfolder_idtextscopetextnametextparent_idtextmovetrue / false
delete_favorite_folderSupprimer un dossier de favoris
6 arguments
kindtextfolder_idtextmodetextscopetexttarget_folder_idtextconfirmtrue / false
set_favorite_folder_visibilityRendre un dossier de favoris privé ou partagé
4 arguments
kindtextfolder_idtextvisibilitytextscopetext
create_favorite_folder_share_linkCréer un lien public vers un dossier de favoris
4 arguments
kindtextfolder_idtextscopetextconfirmtrue / false
delete_favorite_folder_share_linkSupprimer les liens publics d'un dossier de favoris
4 arguments
kindtextfolder_idtextscopetextconfirmtrue / false

Compte

2 outils
usage_getVotre offre, ses crédits et combien il en reste
check_creditsCombien de crédits il vous reste ce mois-ci (même réponse que usage_get)
Un appel d'outil coûte les résultats qu'il renvoie, prélevés sur les crédits mensuels de votre offre, partagés avec l'API REST. 1 crédit = 1 résultat renvoyé : les détails d'une marque, une publicité ou une ligne d'une liste. Un résultat vide est gratuit. Les appels échoués, usage_get et check_credits ne coûtent rien. Le serveur expose aussi trois ressources : sellwinners://me, sellwinners://usage et sellwinners://openapi.

Dépannage

  • 401, ou le client vous demande de vous reconnecter : la clé a été révoquée ou mal saisie, ou la connexion a expiré. Créez une nouvelle clé dans Clés API, ou reconnectez l'application.
  • Un outil répond insufficient_credits : les crédits du mois sont épuisés. L'appel n'a pas été exécuté et n'a rien coûté ; la réponse indique le jour où les crédits se renouvellent. Les offres payantes peuvent ajouter des crédits sur la page de facturation.
  • 403 plan_not_eligible : l'offre n'inclut pas cet outil ou le serveur MCP. La réponse nomme la fonctionnalité ; les offres sont présentées sur la page des tarifs.
  • Un outil répond rate_limited : la limite de débit par minute, partagée par l'espace de travail, est atteinte. L'appel n'a pas été exécuté et n'a rien coûté ; attendez le nombre de secondes indiqué dans la réponse, puis réessayez.
  • Une application connectée ne fonctionne plus : déconnectez-la dans Paramètres, MCP, Applications connectées, puis connectez-la à nouveau. Une connexion inutilisée pendant 60 jours prend fin d'elle-même.
  • Autre problème : écrivez à l'assistance en indiquant l'heure de l'appel et le nom de l'outil.