Server MCP

Dai al tuo agente IA l'intelligence su annunci e negozi

Il server MCP di SellWinners espone i nostri dati come 73 strumenti. Punta qualsiasi client MCP all'endpoint, accedi da ChatGPT o Claude oppure aggiungi la tua chiave API, e il tuo agente potrà cercare annunci, esaminare negozi Shopify, cercarne i prodotti e recuperare le creatività da solo.

  • HTTP in streaming
  • Accesso per ChatGPT e Claude, oppure la tua chiave API
  • Condivide i crediti del tuo piano
# 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
Come si collega

Tre passaggi per la prima chiamata del tuo agente

01

Accedi o crea una chiave

Inizia gratis, poi accedi da ChatGPT o Claude, oppure crea una chiave nella tua dashboard. Il piano Free include anche il server MCP: 150 crediti al mese, 10 richieste al minuto, i primi 10 risultati di ogni ricerca.

02

Aggiungi il server al tuo client

Incolla la configurazione qui sotto in Cursor, VS Code, Claude o in qualsiasi client che supporti MCP remoto.

03

Chiedi al tuo agente

Prova «trova i migliori annunci video di scarpe da running di questo mese». Il tuo agente sceglie da solo lo strumento giusto.

Configurazione

Configuralo nel tuo client

ChatGPT e Claude ti fanno accedere; altrove, sostituisci YOUR_API_KEY con una chiave della tua dashboard.

No API key: these sign in with your SellWinners account.
Il piano Free include anche il server MCP: 150 crediti al mese, 10
richieste al minuto, i primi 10 risultati di ogni ricerca.

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

73 strumenti, pronti all'uso

Apri uno strumento per vedere gli argomenti che accetta. Quelli evidenziati sono obbligatori.

Individuazione

3 strumenti
lookupConverti il nome di un marchio, il dominio di un negozio o l'id di una pagina Facebook in id da usare con gli altri strumenti
3 argomenti
qtexttypetextlimitnumber
lookup_filter_idsId per i filtri degli strumenti di ricerca
7 argomenti
typetextquerytextscope_tracked_pageslistscope_domaintextstatustextlimitnumbersnapshot_datetext
list_saved_viewsLe ricerche che hai salvato nelle pagine elenco del sito, pronte per gli strumenti di ricerca
1 argomento
contexttext

Negozi

17 strumenti
search_shopsCerca o sfoglia i negozi Shopify
48 argomenti
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_shopsConcorrenti di un negozio (id o dominio)
10 argomenti
shoptextlimitnumbersort_bytextordertextoffsetnumberseasontextfiltersobjectmarkettextexclude_shopslistdetailtext
find_winning_productsI prodotti che vendono di più ora in una nicchia
5 argomenti
nichetextkeywordslistcountrytextmax_resultsnumberdetailtext
search_productsCerca o sfoglia i prodotti dei negozi per prezzo, vendite, unità vendute, paesi di vendita, annunci, copertura, recensioni, data di lancio, valuta o paese del negozio
37 argomenti
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_imageTrova i prodotti dei negozi simili a un'immagine (un URL di immagine o il file), con i loro negozi
12 argomenti
image_urltextimage_base64textsort_bytextordertextmax_per_shopnumberfiltersobjectpagenumberlimitnumbersearch_idtextdetailtextoffsetnumbergroup_brandstrue / false
search_shops_by_imageTrova i negozi che vendono ciò che mostra un'immagine, con i prodotti più simili
7 argomenti
image_urltextimage_base64textsearch_idtextlimitnumberoffsetnumbergroup_brandstrue / falseproducts_per_shopnumber
get_productUn prodotto con la scheda completa: foto, opzioni e varianti
2 argomenti
product_idtexturltext
get_product_adsGli annunci Meta che rimandano alla pagina di un prodotto
5 argomenti
product_idtextstatustextpagenumberlimitnumberdetailtext
analyze_productUn prodotto, i suoi ultimi annunci e una lettura dei suoi segnali
3 argomenti
product_idtexturltexttop_adsnumber
product_launch_radarProdotti lanciati di recente, ordinati per vendite o pressione pubblicitaria
34 argomenti
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_linkCrea (o restituisci) il link pubblico di un prodotto
2 argomenti
product_idtextconfirmtrue / false
delete_product_share_linkRimuovi il link pubblico di un prodotto
2 argomenti
product_idtextconfirmtrue / false
brief_competitorUn profilo sintetico di un concorrente (id, dominio o nome del negozio)
11 argomenti
competitortextsectionslistmax_productsnumbermax_emailsnumbermax_adsnumbershoptextad_rank_windowtextad_rank_sorttextmax_current_ranknumbermin_rank_deltanumbersnapshot_datetext
shop_reportUn report su un negozio: il suo feed, le sue pagine Facebook, la stagione Q4, una landing page, la classifica dei suoi annunci o i suoi test creativi
19 argomenti
shoptextreporttextyearnumberdate_fromtextdate_totexturltextadvertiser_idtextmodetextdaysnumberad_idslistdatetextas_oftextmedia_typetextstatustextkeywordslistsnapshot_datetextpagenumberlimitnumberdetailtext
compare_shopsUn dato di più negozi a confronto
3 argomenti
shopslistmetrictextsnapshot_datetext
market_overviewL'intero mercato, giorno per giorno, o in una stagione Q4
5 argomenti
kindtextyearnumberdate_fromtextdate_totextlimitnumber
detect_shopify_storeSe un negozio usa Shopify, il suo tema e le app Shopify che carica
1 argomento
urltext

Annunci e media

8 strumenti
search_adsCerca annunci Meta (Facebook / Instagram) per parole nel testo, marchio o landing page
97 argomenti
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 scheda completa di un annuncio Meta (o di un annuncio Google o di un post TikTok)
1 argomento
ad_identifiertext
creative_inspiration_packIspirazione creativa per una nicchia
5 argomenti
nichetextkeywordslistfocustextmax_adsnumbertrend_signaltext
search_google_ads_libraryCerca annunci Google
57 argomenti
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_libraryCerca annunci e post organici TikTok
66 argomenti
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_linkCrea (o restituisce) il link pubblico a un annuncio
2 argomenti
ad_idtextconfirmtrue / false
delete_ad_share_linkRimuovi il link pubblico a un annuncio
2 argomenti
ad_idtextconfirmtrue / false
write_ad_hooksScrivi tre brevi frasi di apertura (hook) per l'annuncio di un prodotto, per Meta, TikTok o entrambi
7 argomenti
nichetextproducttextangletextplatformtextlanguagetextregeneratetextidempotency_keytext

Inserzionisti ed email

5 strumenti
search_advertisersCerca inserzionisti (pagine Facebook)
26 argomenti
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 scheda di un inserzionista, o i suoi annunci attivi e la copertura giorno per giorno
4 argomenti
advertiser_idtextviewtextdaysnumbersnapshot_datetext
search_emailsCerca le email di marketing dei marchi per parole nell'oggetto, nel mittente o nel contenuto
11 argomenti
querytextshoptextcampaign_typetextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtexttimeframetextintenttext
get_email_htmlL'HTML grezzo di un'email (usa prima search_emails per trovare l'id)
4 argomenti
email_idtextinclude_htmltrue / falseshoptexthtml_partnumber
analyze_shop_emailsLa strategia email di un negozio
2 argomenti
shoptextmax_emailsnumber

Marchi monitorati

14 strumenti
list_tracked_brandsI marchi che monitori, con i contatori dei loro annunci attivi
6 argomenti
pagenumberlimitnumberfolder_idslistnametextsort_bytextfolder_idnumber
add_to_brandtrackerInizia a monitorare un marchio
5 argomenti
facebook_page_idtextwebsite_idtextshop_idtextdomaintextfolder_idnumber
delete_from_brandtrackerSmetti di monitorare un marchio
3 argomenti
brandtracker_idtextconfirmtrue / falseworkspace_link_idnumber
list_brandtracker_foldersLe tue cartelle del monitoraggio
create_brandtracker_folderCrea una cartella del monitoraggio
1 argomento
nametext
rename_brandtracker_folderRinomina una cartella del monitoraggio
2 argomenti
folder_idnumbernametext
delete_brandtracker_folderElimina una cartella del monitoraggio
3 argomenti
folder_idnumberactiontextconfirmtrue / false
move_tracked_brandsSposta i marchi monitorati in una cartella (folder_id=null li toglie da qualsiasi cartella)
3 argomenti
brandtracker_idslistfolder_idnumberworkspace_link_idslist
get_brand_activityCosa ha fatto un marchio monitorato su Meta, TikTok, Google ed email
11 argomenti
brandtracker_idtextbrandtextviewtextsourcetextsincetextuntiltextdaytexttypeslistpagenumberlimitnumberdetailtext
analyze_tracked_brandUn'analisi approfondita di un marchio monitorato
4 argomenti
brandtracker_idtextbrandtextsnapshot_datetextdetailtext
analyze_brand_changesCosa è cambiato per un marchio monitorato in un periodo (1d, 7d, 14d, 30d; per 1d le posizioni guadagnate si leggono su 7d, per 14d gli hook su 30d, i test creativi sono gli ultimi)
6 argomenti
brandtracker_idtextbrandtextperiodtextfocustextsnapshot_datetextdetailtext
get_brandtracker_scaling_adsGli annunci di un marchio monitorato che hanno guadagnato più posizioni, con lo storico delle posizioni
32 argomenti
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_transcriptsScript video di un marchio monitorato, raggruppati per testo
9 argomenti
brandtracker_idtextbrandtexttime_periodtextpagenumberlimitnumbereu_onlytrue / falseordertextsort_bytextsnapshot_datetext
daily_radarRiepilogo giornaliero dei tuoi marchi monitorati
4 argomenti
folder_idslistfocustextevent_typeslistfolder_idnumber

Bacheche

14 strumenti
list_boardsLe tue bacheche
8 argomenti
scopetextstatetextkindtextsurfacetextparent_board_idtextroot_onlytrue / falsepagenumberlimitnumber
get_boardUna bacheca
1 argomento
board_idtext
create_boardCrea una bacheca
6 argomenti
nametextkindtextsurfacetextdescriptiontextvisibilitytextparent_board_idtext
update_boardRinomina una bacheca, cambiane la descrizione o la visibilità
4 argomenti
board_idtextnametextdescriptiontextvisibilitytext
move_boardSposta una bacheca sotto una bacheca cartella (parent_board_id=null la porta al livello principale)
2 argomenti
board_idtextparent_board_idtext
archive_boardArchivia una bacheca e tutto ciò che contiene (restore_board la ripristina)
2 argomenti
board_idtextconfirmtrue / false
restore_boardRipristina una bacheca archiviata
1 argomento
board_idtext
list_board_itemsGli elementi salvati in una bacheca
3 argomenti
board_idtextpagenumberlimitnumber
find_saved_itemsCerca tutto ciò che hai salvato, in ogni bacheca e nei tuoi preferiti
13 argomenti
querytextsource_typeslistboard_idtextscopetextstatetextsaved_fromtextsaved_totextsort_bytextordertextpagenumberlimitnumberinclude_itemstrue / falsedetailtext
add_board_itemSalva un elemento in una bacheca raccolta
5 argomenti
board_idtextsource_typetextsource_idtextsource_indextextpositionnumber
move_board_itemSposta un elemento salvato in un'altra bacheca
4 argomenti
board_idtextitem_idtexttarget_board_idtextpositionnumber
remove_board_itemRimuovi un elemento salvato da una bacheca
3 argomenti
board_idtextitem_idtextconfirmtrue / false
create_board_share_linkCrea un link pubblico a una bacheca
2 argomenti
board_idtextconfirmtrue / false
delete_board_share_linkRimuovi i link pubblici a una bacheca
2 argomenti
board_idtextconfirmtrue / false

Preferiti

10 strumenti
list_favoritesI tuoi annunci, negozi o email salvati
6 argomenti
kindtextscopetextfolder_idtextpagenumberlimitnumberdetailtext
add_favorite_itemSalva un annuncio, un negozio o un'email
4 argomenti
kindtextitem_idtextscopetextfolder_idtext
move_favorite_itemSposta un preferito salvato in una cartella (folder_id=null lo toglie da qualsiasi cartella)
4 argomenti
kindtextfavorite_idtextscopetextfolder_idtext
remove_favorite_itemRimuovi un preferito salvato, tramite il suo id (favorite_id) o l'id dell'elemento salvato (item_id)
5 argomenti
kindtextscopetextfavorite_idtextitem_idtextconfirmtrue / false
create_favorite_folderCrea una cartella di preferiti
4 argomenti
kindtextnametextscopetextparent_idtext
update_favorite_folderRinomina una cartella di preferiti, o spostala (move=true con parent_id, null per il livello principale)
6 argomenti
kindtextfolder_idtextscopetextnametextparent_idtextmovetrue / false
delete_favorite_folderElimina una cartella di preferiti
6 argomenti
kindtextfolder_idtextmodetextscopetexttarget_folder_idtextconfirmtrue / false
set_favorite_folder_visibilityRendi privata o condivisa una cartella di preferiti
4 argomenti
kindtextfolder_idtextvisibilitytextscopetext
create_favorite_folder_share_linkCrea un link pubblico a una cartella di preferiti
4 argomenti
kindtextfolder_idtextscopetextconfirmtrue / false
delete_favorite_folder_share_linkRimuovi i link pubblici a una cartella di preferiti
4 argomenti
kindtextfolder_idtextscopetextconfirmtrue / false

Account

2 strumenti
usage_getIl tuo piano, i suoi crediti e quanti ne restano
check_creditsQuanti crediti ti restano questo mese (stessa risposta di usage_get)
Una chiamata a uno strumento costa i risultati che restituisce, dai crediti mensili del tuo piano, condivisi con l'API REST. 1 credito = 1 risultato restituito: i dettagli di un marchio, un annuncio o una riga di un elenco. Un risultato vuoto è gratuito. Le chiamate non riuscite, usage_get e check_credits non costano nulla. Il server espone anche tre risorse: sellwinners://me, sellwinners://usage e sellwinners://openapi.

Risoluzione dei problemi

  • 401, oppure il client ti chiede di accedere di nuovo: la chiave è stata revocata o digitata male, oppure l'accesso è scaduto. Crea una nuova chiave in Chiavi API, oppure ricollega l'app.
  • Uno strumento risponde insufficient_credits: i crediti di questo mese sono esauriti. La chiamata non è stata eseguita e non è costata nulla; la risposta indica il giorno in cui i crediti si rinnovano. Con i piani a pagamento puoi aggiungere crediti nella pagina di fatturazione.
  • 403 plan_not_eligible: il piano non include questo strumento o il server MCP. La risposta indica la funzionalità; i piani sono nella pagina dei prezzi.
  • Uno strumento risponde rate_limited: il limite di richieste al minuto, condiviso dall'area di lavoro. La chiamata non è stata eseguita e non è costata nulla; attendi i secondi indicati nella risposta, poi riprova.
  • Un'app collegata ha smesso di funzionare: scollegala da Impostazioni, MCP, App collegate, poi collegala di nuovo. Un collegamento inutilizzato per 60 giorni termina da solo.
  • Altro: scrivi all'assistenza indicando l'ora della chiamata e il nome dello strumento.