Servidor MCP

Dale a tu agente de IA inteligencia sobre anuncios y tiendas

El servidor MCP de SellWinners expone nuestros datos como 73 herramientas. Apunta cualquier cliente MCP al endpoint, inicia sesión desde ChatGPT o Claude o añade tu clave de API, y tu agente podrá buscar anuncios, examinar tiendas Shopify, buscar sus productos y obtener creatividades por sí solo.

  • Streamable HTTP
  • Inicio de sesión para ChatGPT y Claude, o tu clave de API
  • Comparte los créditos de tu plan
# 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
Cómo se conecta

Tres pasos hasta la primera llamada de tu agente

01

Inicia sesión o crea una clave

Empieza gratis y luego inicia sesión desde ChatGPT o Claude, o crea una clave en tu panel. El plan Free también incluye el servidor MCP: 150 créditos al mes, 10 solicitudes por minuto, los primeros 10 resultados de cada búsqueda.

02

Añade el servidor a tu cliente

Pega la configuración de abajo en Cursor, VS Code, Claude o cualquier cliente compatible con MCP remoto.

03

Pregunta a tu agente

Prueba con «encuentra los mejores anuncios de vídeo de zapatillas de running de este mes». Tu agente elige la herramienta adecuada por sí solo.

Configuración

Configúralo en tu cliente

ChatGPT y Claude inician sesión; en los demás, sustituye YOUR_API_KEY por una clave de tu panel.

No API key: these sign in with your SellWinners account.
El plan Free también incluye el servidor MCP: 150 créditos al mes,
10 solicitudes por minuto, los primeros 10 resultados de cada
búsqueda.

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

73 herramientas, listas para usar

Abre una herramienta para ver los argumentos que admite. Los resaltados son obligatorios.

Descubrimiento

3 herramientas
lookupConvierte el nombre de una marca, el dominio de una tienda o el id de una página de Facebook en ids que puedes usar con las demás herramientas
3 argumentos
qtexttypetextlimitnumber
lookup_filter_idsIds para los filtros de las herramientas de búsqueda
7 argumentos
typetextquerytextscope_tracked_pageslistscope_domaintextstatustextlimitnumbersnapshot_datetext
list_saved_viewsLas búsquedas que guardaste en las páginas de listas del sitio, preparadas para las herramientas de búsqueda
1 argumento
contexttext

Tiendas

17 herramientas
search_shopsBuscar o explorar tiendas de Shopify
48 argumentos
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_shopsCompetidores de una tienda (id o dominio)
10 argumentos
shoptextlimitnumbersort_bytextordertextoffsetnumberseasontextfiltersobjectmarkettextexclude_shopslistdetailtext
find_winning_productsProductos que se están vendiendo ahora en un nicho
5 argumentos
nichetextkeywordslistcountrytextmax_resultsnumberdetailtext
search_productsBuscar o explorar productos de tiendas por precio, ventas, unidades vendidas, países de venta, anuncios, alcance, reseñas, fecha de lanzamiento, moneda o país de la tienda
37 argumentos
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_imageEncontrar productos de tiendas que se parecen a una imagen (una URL de imagen o el archivo), con sus tiendas
12 argumentos
image_urltextimage_base64textsort_bytextordertextmax_per_shopnumberfiltersobjectpagenumberlimitnumbersearch_idtextdetailtextoffsetnumbergroup_brandstrue / false
search_shops_by_imageEncuentra las tiendas que venden lo que muestra una imagen, con sus productos más parecidos
7 argumentos
image_urltextimage_base64textsearch_idtextlimitnumberoffsetnumbergroup_brandstrue / falseproducts_per_shopnumber
get_productUn producto con su ficha completa: fotos, opciones y variantes
2 argumentos
product_idtexturltext
get_product_adsLos anuncios de Meta que enlazan a la página de un producto
5 argumentos
product_idtextstatustextpagenumberlimitnumberdetailtext
analyze_productUn producto, sus últimos anuncios y una lectura de sus señales
3 argumentos
product_idtexturltexttop_adsnumber
product_launch_radarProductos lanzados recientemente, ordenados por ventas o presión publicitaria
34 argumentos
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_linkCrear (o devolver) el enlace público de un producto
2 argumentos
product_idtextconfirmtrue / false
delete_product_share_linkEliminar el enlace público de un producto
2 argumentos
product_idtextconfirmtrue / false
brief_competitorUn informe breve sobre un competidor (id de tienda, dominio o nombre)
11 argumentos
competitortextsectionslistmax_productsnumbermax_emailsnumbermax_adsnumbershoptextad_rank_windowtextad_rank_sorttextmax_current_ranknumbermin_rank_deltanumbersnapshot_datetext
shop_reportUn informe sobre una tienda: su feed, sus páginas de Facebook, su temporada Q4, una página de destino, su ranking de anuncios o sus pruebas creativas
19 argumentos
shoptextreporttextyearnumberdate_fromtextdate_totexturltextadvertiser_idtextmodetextdaysnumberad_idslistdatetextas_oftextmedia_typetextstatustextkeywordslistsnapshot_datetextpagenumberlimitnumberdetailtext
compare_shopsUna misma cifra de varias tiendas, una al lado de otra
3 argumentos
shopslistmetrictextsnapshot_datetext
market_overviewTodo el mercado, día a día o durante una temporada Q4
5 argumentos
kindtextyearnumberdate_fromtextdate_totextlimitnumber
detect_shopify_storeSi una tienda funciona con Shopify, su tema y las apps de Shopify que carga
1 argumento
urltext

Anuncios y medios

8 herramientas
search_adsBuscar anuncios de Meta (Facebook / Instagram) por palabras del texto, la marca o la página de destino
97 argumentos
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 ficha completa de un anuncio de Meta (o de un anuncio de Google o una publicación de TikTok)
1 argumento
ad_identifiertext
creative_inspiration_packInspiración creativa para un nicho
5 argumentos
nichetextkeywordslistfocustextmax_adsnumbertrend_signaltext
search_google_ads_libraryBuscar anuncios de Google
57 argumentos
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_libraryBuscar anuncios y publicaciones orgánicas de TikTok
66 argumentos
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_linkCrear (o devolver) el enlace público a un anuncio
2 argumentos
ad_idtextconfirmtrue / false
delete_ad_share_linkEliminar el enlace público a un anuncio
2 argumentos
ad_idtextconfirmtrue / false
write_ad_hooksEscribir tres frases de apertura cortas (ganchos) para el anuncio de un producto, para Meta, TikTok o ambos
7 argumentos
nichetextproducttextangletextplatformtextlanguagetextregeneratetextidempotency_keytext

Anunciantes y emails

5 herramientas
search_advertisersBuscar anunciantes (páginas de Facebook)
26 argumentos
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 ficha de un anunciante, o sus anuncios activos y su alcance día a día
4 argumentos
advertiser_idtextviewtextdaysnumbersnapshot_datetext
search_emailsBuscar emails de marketing de marcas por palabras del asunto, el remitente o el contenido
11 argumentos
querytextshoptextcampaign_typetextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtexttimeframetextintenttext
get_email_htmlEl HTML sin procesar de un email (usa antes search_emails para encontrar el id)
4 argumentos
email_idtextinclude_htmltrue / falseshoptexthtml_partnumber
analyze_shop_emailsLa estrategia de email de una tienda
2 argumentos
shoptextmax_emailsnumber

Marcas en seguimiento

14 herramientas
list_tracked_brandsLas marcas que sigues, con sus contadores de anuncios activos
6 argumentos
pagenumberlimitnumberfolder_idslistnametextsort_bytextfolder_idnumber
add_to_brandtrackerEmpezar a seguir una marca
5 argumentos
facebook_page_idtextwebsite_idtextshop_idtextdomaintextfolder_idnumber
delete_from_brandtrackerDejar de seguir una marca
3 argumentos
brandtracker_idtextconfirmtrue / falseworkspace_link_idnumber
list_brandtracker_foldersTus carpetas de seguimiento
create_brandtracker_folderCrear una carpeta de seguimiento
1 argumento
nametext
rename_brandtracker_folderRenombrar una carpeta de seguimiento
2 argumentos
folder_idnumbernametext
delete_brandtracker_folderEliminar una carpeta de seguimiento
3 argumentos
folder_idnumberactiontextconfirmtrue / false
move_tracked_brandsMover marcas en seguimiento a una carpeta (folder_id=null las saca de cualquier carpeta)
3 argumentos
brandtracker_idslistfolder_idnumberworkspace_link_idslist
get_brand_activityLo que ha hecho una marca en seguimiento en Meta, TikTok, Google y email
11 argumentos
brandtracker_idtextbrandtextviewtextsourcetextsincetextuntiltextdaytexttypeslistpagenumberlimitnumberdetailtext
analyze_tracked_brandUn análisis a fondo de una marca en seguimiento
4 argumentos
brandtracker_idtextbrandtextsnapshot_datetextdetailtext
analyze_brand_changesQué ha cambiado en una marca en seguimiento durante un periodo (1d, 7d, 14d, 30d; las posiciones ganadas se leen sobre 7d para 1d, los ganchos sobre 30d para 14d, y las pruebas creativas son las más recientes)
6 argumentos
brandtracker_idtextbrandtextperiodtextfocustextsnapshot_datetextdetailtext
get_brandtracker_scaling_adsLos anuncios de una marca en seguimiento que más posiciones han ganado, con su historial de posiciones
32 argumentos
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_transcriptsGuiones de vídeo de una marca en seguimiento, agrupados por texto
9 argumentos
brandtracker_idtextbrandtexttime_periodtextpagenumberlimitnumbereu_onlytrue / falseordertextsort_bytextsnapshot_datetext
daily_radarResumen diario de todas tus marcas en seguimiento
4 argumentos
folder_idslistfocustextevent_typeslistfolder_idnumber

Tableros

14 herramientas
list_boardsTus tableros
8 argumentos
scopetextstatetextkindtextsurfacetextparent_board_idtextroot_onlytrue / falsepagenumberlimitnumber
get_boardUn tablero
1 argumento
board_idtext
create_boardCrear un tablero
6 argumentos
nametextkindtextsurfacetextdescriptiontextvisibilitytextparent_board_idtext
update_boardRenombrar un tablero, cambiar su descripción o su visibilidad
4 argumentos
board_idtextnametextdescriptiontextvisibilitytext
move_boardMover un tablero dentro de un tablero carpeta (parent_board_id=null lo lleva al nivel superior)
2 argumentos
board_idtextparent_board_idtext
archive_boardArchivar un tablero y todo lo que contiene (restore_board lo recupera)
2 argumentos
board_idtextconfirmtrue / false
restore_boardRestaurar un tablero archivado
1 argumento
board_idtext
list_board_itemsLos elementos guardados en un tablero
3 argumentos
board_idtextpagenumberlimitnumber
find_saved_itemsBuscar todo lo que has guardado, en todos los tableros y en tus favoritos
13 argumentos
querytextsource_typeslistboard_idtextscopetextstatetextsaved_fromtextsaved_totextsort_bytextordertextpagenumberlimitnumberinclude_itemstrue / falsedetailtext
add_board_itemGuardar un elemento en un tablero de colección
5 argumentos
board_idtextsource_typetextsource_idtextsource_indextextpositionnumber
move_board_itemMover un elemento guardado a otro tablero
4 argumentos
board_idtextitem_idtexttarget_board_idtextpositionnumber
remove_board_itemQuitar un elemento guardado de un tablero
3 argumentos
board_idtextitem_idtextconfirmtrue / false
create_board_share_linkCrear un enlace público a un tablero
2 argumentos
board_idtextconfirmtrue / false
delete_board_share_linkEliminar los enlaces públicos a un tablero
2 argumentos
board_idtextconfirmtrue / false

Favoritos

10 herramientas
list_favoritesTus anuncios, tiendas o emails guardados
6 argumentos
kindtextscopetextfolder_idtextpagenumberlimitnumberdetailtext
add_favorite_itemGuardar un anuncio, una tienda o un email
4 argumentos
kindtextitem_idtextscopetextfolder_idtext
move_favorite_itemMover un favorito guardado a una carpeta (folder_id=null lo saca de cualquier carpeta)
4 argumentos
kindtextfavorite_idtextscopetextfolder_idtext
remove_favorite_itemQuitar un favorito guardado, por su propio id (favorite_id) o por el id del registro guardado (item_id)
5 argumentos
kindtextscopetextfavorite_idtextitem_idtextconfirmtrue / false
create_favorite_folderCrear una carpeta de favoritos
4 argumentos
kindtextnametextscopetextparent_idtext
update_favorite_folderRenombrar una carpeta de favoritos o moverla (move=true con parent_id, null para el nivel superior)
6 argumentos
kindtextfolder_idtextscopetextnametextparent_idtextmovetrue / false
delete_favorite_folderEliminar una carpeta de favoritos
6 argumentos
kindtextfolder_idtextmodetextscopetexttarget_folder_idtextconfirmtrue / false
set_favorite_folder_visibilityHacer privada o compartida una carpeta de favoritos
4 argumentos
kindtextfolder_idtextvisibilitytextscopetext
create_favorite_folder_share_linkCrear un enlace público a una carpeta de favoritos
4 argumentos
kindtextfolder_idtextscopetextconfirmtrue / false
delete_favorite_folder_share_linkEliminar los enlaces públicos a una carpeta de favoritos
4 argumentos
kindtextfolder_idtextscopetextconfirmtrue / false

Cuenta

2 herramientas
usage_getTu plan, sus créditos y cuántos te quedan
check_creditsCuántos créditos te quedan este mes (la misma respuesta que usage_get)
Una llamada a una herramienta cuesta los resultados que devuelve, de los créditos mensuales de tu plan, compartidos con la API REST. 1 crédito = 1 resultado devuelto: los datos de una marca, un anuncio o una fila de una lista. Un resultado vacío es gratis. Las llamadas fallidas, usage_get y check_credits no cuestan nada. El servidor también expone tres recursos: sellwinners://me, sellwinners://usage y sellwinners://openapi.

Solución de problemas

  • 401, o el cliente te pide que vuelvas a iniciar sesión: la clave se revocó o se escribió mal, o la sesión terminó. Crea una clave nueva en Claves de API o vuelve a conectar la app.
  • Una herramienta responde insufficient_credits: se han agotado los créditos de este mes. La llamada no se ejecutó y no costó nada; la respuesta indica el día en que se renuevan los créditos. Los planes de pago pueden añadir créditos en la página de facturación.
  • 403 plan_not_eligible: el plan no incluye esta herramienta o el servidor MCP. La respuesta indica la función; los planes están en la página de precios.
  • Una herramienta responde rate_limited: el límite de peticiones por minuto, compartido por el espacio de trabajo. La llamada no se ejecutó y no costó nada; espera los segundos que indica la respuesta y vuelve a intentarlo.
  • Una app conectada ha dejado de funcionar: desconéctala en Ajustes, MCP, Aplicaciones conectadas, y vuelve a conectarla. Una conexión sin usar durante 60 días termina sola.
  • Otra cosa: escribe a soporte con la hora de la llamada y el nombre de la herramienta.