MCP-server

Geef je AI-agent inzicht in advertenties en winkels

De MCP-server van SellWinners stelt onze data beschikbaar als 73 tools. Richt een MCP-client op het endpoint, log in vanuit ChatGPT of Claude of voeg je API-sleutel toe, en je agent kan zelf advertenties doorzoeken, Shopify-winkels bekijken, hun producten doorzoeken en creatives ophalen.

  • Streamable HTTP
  • Inloggen voor ChatGPT en Claude, of je API-sleutel
  • Deelt de credits van je abonnement
# 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
Zo maak je verbinding

Drie stappen naar de eerste aanroep van je agent

01

Log in of maak een sleutel aan

Begin gratis, log daarna in vanuit ChatGPT of Claude, of maak een sleutel aan in je dashboard. Het Free-abonnement omvat ook de MCP-server: 150 credits per maand, 10 verzoeken per minuut, de eerste 10 resultaten van elke zoekopdracht.

02

Voeg de server toe aan je client

Plak de configuratie hieronder in Cursor, VS Code, Claude of een andere client die externe MCP-servers ondersteunt.

03

Vraag het je agent

Probeer 'vind de beste videoadvertenties voor hardloopschoenen van deze maand'. Je agent kiest zelf de juiste tool.

Instellen

Stel het in je client in

ChatGPT en Claude loggen in; elders vervang je YOUR_API_KEY door een sleutel uit je dashboard.

No API key: these sign in with your SellWinners account.
Het Free-abonnement omvat ook de MCP-server: 150 credits per
maand, 10 verzoeken per minuut, de eerste 10 resultaten van elke
zoekopdracht.

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.
Tools

73 tools, klaar voor gebruik

Open een tool om te zien welke argumenten hij accepteert. Gemarkeerde argumenten zijn verplicht.

Ontdekken

3 tools
lookupEen merknaam, een winkeldomein of een Facebook-pagina-ID omzetten naar ID's die je met de andere tools kunt gebruiken
3 argumenten
qtexttypetextlimitnumber
lookup_filter_idsID's voor de filters van de zoektools
7 argumenten
typetextquerytextscope_tracked_pageslistscope_domaintextstatustextlimitnumbersnapshot_datetext
list_saved_viewsDe zoekopdrachten die je op de lijstpagina's van de website hebt opgeslagen, klaar voor de zoektools
1 argument
contexttext

Winkels

17 tools
search_shopsShopify-winkels zoeken of doorbladeren
48 argumenten
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_shopsConcurrenten van een winkel (ID of domein)
10 argumenten
shoptextlimitnumbersort_bytextordertextoffsetnumberseasontextfiltersobjectmarkettextexclude_shopslistdetailtext
find_winning_productsProducten die nu verkopen in een niche
5 argumenten
nichetextkeywordslistcountrytextmax_resultsnumberdetailtext
search_productsWinkelproducten zoeken of doorbladeren op prijs, verkopen, verkochte eenheden, verkooplanden, advertenties, bereik, reviews, lanceringsdatum, valuta of land van de winkel
37 argumenten
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_imageWinkelproducten vinden die op een afbeelding lijken (een afbeeldings-URL of het bestand), met hun winkels
12 argumenten
image_urltextimage_base64textsort_bytextordertextmax_per_shopnumberfiltersobjectpagenumberlimitnumbersearch_idtextdetailtextoffsetnumbergroup_brandstrue / false
search_shops_by_imageVind de winkels die verkopen wat een afbeelding toont, met hun meest gelijkende producten
7 argumenten
image_urltextimage_base64textsearch_idtextlimitnumberoffsetnumbergroup_brandstrue / falseproducts_per_shopnumber
get_productEén product met de volledige fiche: foto's, opties en varianten
2 argumenten
product_idtexturltext
get_product_adsDe Meta-advertenties die naar de pagina van een product linken
5 argumenten
product_idtextstatustextpagenumberlimitnumberdetailtext
analyze_productEén product, de nieuwste advertenties en een lezing van de signalen
3 argumenten
product_idtexturltexttop_adsnumber
product_launch_radarOnlangs gelanceerde producten, gerangschikt op verkoop of advertentiedruk
34 argumenten
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_linkDe openbare link naar één product maken (of ophalen)
2 argumenten
product_idtextconfirmtrue / false
delete_product_share_linkDe openbare link naar één product verwijderen
2 argumenten
product_idtextconfirmtrue / false
brief_competitorEen beknopte briefing over één concurrent (winkel-ID, domein of naam)
11 argumenten
competitortextsectionslistmax_productsnumbermax_emailsnumbermax_adsnumbershoptextad_rank_windowtextad_rank_sorttextmax_current_ranknumbermin_rank_deltanumbersnapshot_datetext
shop_reportEén rapport over een winkel: de feed, de Facebook-pagina's, het Q4-seizoen, een landingspagina, de advertentieranking of de creativetests
19 argumenten
shoptextreporttextyearnumberdate_fromtextdate_totexturltextadvertiser_idtextmodetextdaysnumberad_idslistdatetextas_oftextmedia_typetextstatustextkeywordslistsnapshot_datetextpagenumberlimitnumberdetailtext
compare_shopsEén cijfer van meerdere winkels naast elkaar
3 argumenten
shopslistmetrictextsnapshot_datetext
market_overviewDe hele markt, dag voor dag, of over een Q4-seizoen
5 argumenten
kindtextyearnumberdate_fromtextdate_totextlimitnumber
detect_shopify_storeOf een winkel op Shopify draait, het thema en de Shopify-apps die de winkel laadt
1 argument
urltext

Advertenties en media

8 tools
search_adsMeta-advertenties (Facebook / Instagram) zoeken op woorden in de tekst, het merk of de landingspagina
97 argumenten
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_adHet volledige record van één Meta-advertentie (of van één Google-advertentie of TikTok-post)
1 argument
ad_identifiertext
creative_inspiration_packCreatieve inspiratie voor een niche
5 argumenten
nichetextkeywordslistfocustextmax_adsnumbertrend_signaltext
search_google_ads_libraryGoogle-advertenties zoeken
57 argumenten
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_libraryTikTok-advertenties en organische posts zoeken
66 argumenten
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_linkDe openbare link naar één advertentie maken (of teruggeven)
2 argumenten
ad_idtextconfirmtrue / false
delete_ad_share_linkDe openbare link naar één advertentie verwijderen
2 argumenten
ad_idtextconfirmtrue / false
write_ad_hooksDrie korte openingszinnen (hooks) schrijven voor een advertentie van een product, voor Meta, TikTok of allebei
7 argumenten
nichetextproducttextangletextplatformtextlanguagetextregeneratetextidempotency_keytext

Adverteerders en e-mails

5 tools
search_advertisersAdverteerders (Facebook-pagina's) zoeken
26 argumenten
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_advertiserHet record van één adverteerder, of de live advertenties en het bereik dag voor dag
4 argumenten
advertiser_idtextviewtextdaysnumbersnapshot_datetext
search_emailsMarketingmails van merken zoeken op woorden in het onderwerp, de afzender of de inhoud
11 argumenten
querytextshoptextcampaign_typetextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtexttimeframetextintenttext
get_email_htmlDe ruwe HTML van één e-mail (gebruik eerst search_emails om het ID te vinden)
4 argumenten
email_idtextinclude_htmltrue / falseshoptexthtml_partnumber
analyze_shop_emailsDe e-mailstrategie van een winkel
2 argumenten
shoptextmax_emailsnumber

Gevolgde merken

14 tools
list_tracked_brandsDe merken die je volgt, met hun tellers voor live advertenties
6 argumenten
pagenumberlimitnumberfolder_idslistnametextsort_bytextfolder_idnumber
add_to_brandtrackerEen merk gaan volgen
5 argumenten
facebook_page_idtextwebsite_idtextshop_idtextdomaintextfolder_idnumber
delete_from_brandtrackerEen merk niet meer volgen
3 argumenten
brandtracker_idtextconfirmtrue / falseworkspace_link_idnumber
list_brandtracker_foldersJe trackermappen
create_brandtracker_folderEen trackermap maken
1 argument
nametext
rename_brandtracker_folderEen trackermap hernoemen
2 argumenten
folder_idnumbernametext
delete_brandtracker_folderEen trackermap verwijderen
3 argumenten
folder_idnumberactiontextconfirmtrue / false
move_tracked_brandsGevolgde merken naar een map verplaatsen (folder_id=null haalt ze uit elke map)
3 argumenten
brandtracker_idslistfolder_idnumberworkspace_link_idslist
get_brand_activityWat een gevolgd merk deed op Meta, TikTok, Google en e-mail
11 argumenten
brandtracker_idtextbrandtextviewtextsourcetextsincetextuntiltextdaytexttypeslistpagenumberlimitnumberdetailtext
analyze_tracked_brandEen diepgaande blik op één gevolgd merk
4 argumenten
brandtracker_idtextbrandtextsnapshot_datetextdetailtext
analyze_brand_changesWat er voor een gevolgd merk veranderde in een periode (1d, 7d, 14d, 30d; gewonnen rang wordt bij 1d over 7d gelezen, hooks bij 14d over 30d, creativetests zijn de nieuwste)
6 argumenten
brandtracker_idtextbrandtextperiodtextfocustextsnapshot_datetextdetailtext
get_brandtracker_scaling_adsDe advertenties van een gevolgd merk die het meest in rang stegen, met hun ranggeschiedenis
32 argumenten
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_transcriptsVideoscripts van een gevolgd merk, gegroepeerd op tekst
9 argumenten
brandtracker_idtextbrandtexttime_periodtextpagenumberlimitnumbereu_onlytrue / falseordertextsort_bytextsnapshot_datetext
daily_radarDagelijks overzicht van je gevolgde merken
4 argumenten
folder_idslistfocustextevent_typeslistfolder_idnumber

Borden

14 tools
list_boardsJe borden
8 argumenten
scopetextstatetextkindtextsurfacetextparent_board_idtextroot_onlytrue / falsepagenumberlimitnumber
get_boardEén bord
1 argument
board_idtext
create_boardEen bord maken
6 argumenten
nametextkindtextsurfacetextdescriptiontextvisibilitytextparent_board_idtext
update_boardEen bord hernoemen, of de beschrijving of de zichtbaarheid ervan wijzigen
4 argumenten
board_idtextnametextdescriptiontextvisibilitytext
move_boardEen bord onder een mapbord plaatsen (parent_board_id=null verplaatst het naar het hoogste niveau)
2 argumenten
board_idtextparent_board_idtext
archive_boardEen bord archiveren met alles wat eronder valt (restore_board haalt het terug)
2 argumenten
board_idtextconfirmtrue / false
restore_boardEen gearchiveerd bord herstellen
1 argument
board_idtext
list_board_itemsDe items die op een bord zijn bewaard
3 argumenten
board_idtextpagenumberlimitnumber
find_saved_itemsAlles doorzoeken wat je hebt bewaard, op elk bord en in je favorieten
13 argumenten
querytextsource_typeslistboard_idtextscopetextstatetextsaved_fromtextsaved_totextsort_bytextordertextpagenumberlimitnumberinclude_itemstrue / falsedetailtext
add_board_itemEen item op een collectiebord bewaren
5 argumenten
board_idtextsource_typetextsource_idtextsource_indextextpositionnumber
move_board_itemEen bewaard item naar een ander bord verplaatsen
4 argumenten
board_idtextitem_idtexttarget_board_idtextpositionnumber
remove_board_itemEen bewaard item van een bord verwijderen
3 argumenten
board_idtextitem_idtextconfirmtrue / false
create_board_share_linkEen openbare link naar een bord maken
2 argumenten
board_idtextconfirmtrue / false
delete_board_share_linkDe openbare links naar een bord verwijderen
2 argumenten
board_idtextconfirmtrue / false

Favorieten

10 tools
list_favoritesJe bewaarde advertenties, winkels of e-mails
6 argumenten
kindtextscopetextfolder_idtextpagenumberlimitnumberdetailtext
add_favorite_itemEen advertentie, een winkel of een e-mail bewaren
4 argumenten
kindtextitem_idtextscopetextfolder_idtext
move_favorite_itemEen bewaarde favoriet naar een map verplaatsen (folder_id=null haalt hem uit elke map)
4 argumenten
kindtextfavorite_idtextscopetextfolder_idtext
remove_favorite_itemEen bewaarde favoriet verwijderen, op zijn eigen ID (favorite_id) of op het ID van het bewaarde record (item_id)
5 argumenten
kindtextscopetextfavorite_idtextitem_idtextconfirmtrue / false
create_favorite_folderEen favorietenmap maken
4 argumenten
kindtextnametextscopetextparent_idtext
update_favorite_folderEen favorietenmap hernoemen of verplaatsen (move=true met parent_id, null voor het hoogste niveau)
6 argumenten
kindtextfolder_idtextscopetextnametextparent_idtextmovetrue / false
delete_favorite_folderEen favorietenmap verwijderen
6 argumenten
kindtextfolder_idtextmodetextscopetexttarget_folder_idtextconfirmtrue / false
set_favorite_folder_visibilityEen favorietenmap privé of gedeeld maken
4 argumenten
kindtextfolder_idtextvisibilitytextscopetext
create_favorite_folder_share_linkEen openbare link naar een favorietenmap maken
4 argumenten
kindtextfolder_idtextscopetextconfirmtrue / false
delete_favorite_folder_share_linkDe openbare links naar een favorietenmap verwijderen
4 argumenten
kindtextfolder_idtextscopetextconfirmtrue / false

Account

2 tools
usage_getJe abonnement, de credits ervan en hoeveel er nog over zijn
check_creditsHoeveel credits je deze maand nog hebt (hetzelfde antwoord als usage_get)
Een toolaanroep kost de resultaten die hij teruggeeft, uit de maandelijkse credits van je abonnement, gedeeld met de REST API. 1 credit = 1 geretourneerd resultaat: de details van één merk, één advertentie of één rij van een lijst. Een leeg resultaat is gratis. Mislukte aanroepen, usage_get en check_credits kosten niets. De server biedt ook drie resources: sellwinners://me, sellwinners://usage en sellwinners://openapi.

Probleemoplossing

  • 401, of de client vraagt je opnieuw in te loggen: de sleutel is ingetrokken of verkeerd getypt, of de inlogsessie is afgelopen. Maak een nieuwe sleutel aan onder API-sleutels, of koppel de app opnieuw.
  • Een tool antwoordt insufficient_credits: de credits van deze maand zijn op. De aanroep is niet uitgevoerd en heeft niets gekost; het antwoord noemt de dag waarop de credits worden vernieuwd. Bij betaalde abonnementen kun je credits bijkopen op de factureringspagina.
  • 403 plan_not_eligible: het abonnement omvat deze tool of de MCP-server niet. Het antwoord noemt de functie; de abonnementen staan op de prijzenpagina.
  • Een tool antwoordt rate_limited: de snelheidslimiet per minuut, die de werkruimte deelt. De aanroep is niet uitgevoerd en heeft niets gekost; wacht het aantal seconden dat het antwoord noemt en probeer het opnieuw.
  • Een gekoppelde app werkt niet meer: ontkoppel hem onder Instellingen, MCP, Gekoppelde apps en koppel hem daarna opnieuw. Een koppeling die 60 dagen niet is gebruikt, vervalt vanzelf.
  • Iets anders: schrijf naar support met het tijdstip van de aanroep en de naam van de tool.