Servidor MCP

Dê ao seu agente de IA inteligência de anúncios e lojas

O servidor MCP do SellWinners expõe nossos dados como 73 ferramentas. Aponte qualquer cliente MCP para o endpoint, entre pelo ChatGPT ou pelo Claude ou adicione sua chave de API, e seu agente pode pesquisar anúncios, inspecionar lojas Shopify, pesquisar os produtos delas e puxar criativos sozinho.

  • HTTP streamable
  • Login para o ChatGPT e o Claude, ou sua chave de API
  • Compartilha os créditos do seu plano
# 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
Como ele se conecta

Três passos até a primeira chamada do seu agente

01

Entre ou crie uma chave

Comece grátis e depois entre pelo ChatGPT ou pelo Claude, ou crie uma chave no seu painel. O plano Free também inclui o servidor MCP: 150 créditos por mês, 10 requisições por minuto, os primeiros 10 resultados de cada busca.

02

Adicione o servidor ao seu cliente

Cole a configuração abaixo no Cursor, no VS Code, no Claude ou em qualquer cliente compatível com MCP remoto.

03

Pergunte ao seu agente

Experimente «encontre os melhores anúncios em vídeo de tênis de corrida deste mês». Seu agente escolhe sozinho a ferramenta certa.

Configuração

Configure no seu cliente

O ChatGPT e o Claude usam login; nos outros, substitua YOUR_API_KEY por uma chave do seu painel.

No API key: these sign in with your SellWinners account.
O plano Free também inclui o servidor MCP: 150 créditos por mês,
10 requisições por minuto, os primeiros 10 resultados de cada
busca.

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

73 ferramentas, prontas para usar

Abra uma ferramenta para ver os argumentos que ela aceita. Os destacados são obrigatórios.

Descoberta

3 ferramentas
lookupConverter um nome de marca, um domínio de loja ou um ID de página do Facebook em IDs que você pode usar com as outras ferramentas
3 argumentos
qtexttypetextlimitnumber
lookup_filter_idsIDs para os filtros das ferramentas de busca
7 argumentos
typetextquerytextscope_tracked_pageslistscope_domaintextstatustextlimitnumbersnapshot_datetext
list_saved_viewsAs buscas que você salvou nas páginas de lista do site, prontas para as ferramentas de busca
1 argumento
contexttext

Lojas

17 ferramentas
search_shopsPesquisar ou navegar pelas lojas 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_shopsConcorrentes de uma loja (ID ou domínio)
10 argumentos
shoptextlimitnumbersort_bytextordertextoffsetnumberseasontextfiltersobjectmarkettextexclude_shopslistdetailtext
find_winning_productsProdutos que estão vendendo agora em um nicho
5 argumentos
nichetextkeywordslistcountrytextmax_resultsnumberdetailtext
search_productsPesquisar ou navegar pelos produtos das lojas por preço, vendas, unidades vendidas, países de venda, anúncios, alcance, avaliações, data de lançamento, moeda ou país da loja
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 produtos das lojas parecidos com uma imagem (uma URL de imagem ou o arquivo), com as lojas deles
12 argumentos
image_urltextimage_base64textsort_bytextordertextmax_per_shopnumberfiltersobjectpagenumberlimitnumbersearch_idtextdetailtextoffsetnumbergroup_brandstrue / false
search_shops_by_imageEncontre as lojas que vendem o que uma imagem mostra, com os produtos mais parecidos
7 argumentos
image_urltextimage_base64textsearch_idtextlimitnumberoffsetnumbergroup_brandstrue / falseproducts_per_shopnumber
get_productUm produto com a ficha completa: fotos, opções e variantes
2 argumentos
product_idtexturltext
get_product_adsOs anúncios da Meta que apontam para a página de um produto
5 argumentos
product_idtextstatustextpagenumberlimitnumberdetailtext
analyze_productUm produto, seus últimos anúncios e uma leitura dos sinais
3 argumentos
product_idtexturltexttop_adsnumber
product_launch_radarProdutos lançados recentemente, ordenados por vendas ou pressão publicitária
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_linkCriar (ou devolver) o link público de um produto
2 argumentos
product_idtextconfirmtrue / false
delete_product_share_linkRemover o link público de um produto
2 argumentos
product_idtextconfirmtrue / false
brief_competitorUm resumo compacto sobre um concorrente (ID, domínio ou nome da loja)
11 argumentos
competitortextsectionslistmax_productsnumbermax_emailsnumbermax_adsnumbershoptextad_rank_windowtextad_rank_sorttextmax_current_ranknumbermin_rank_deltanumbersnapshot_datetext
shop_reportUm relatório sobre uma loja: o feed, as páginas do Facebook, a temporada do Q4, uma página de destino, o ranking de anúncios ou os testes de criativos
19 argumentos
shoptextreporttextyearnumberdate_fromtextdate_totexturltextadvertiser_idtextmodetextdaysnumberad_idslistdatetextas_oftextmedia_typetextstatustextkeywordslistsnapshot_datetextpagenumberlimitnumberdetailtext
compare_shopsUm indicador de várias lojas lado a lado
3 argumentos
shopslistmetrictextsnapshot_datetext
market_overviewO mercado inteiro, dia a dia, ou ao longo de uma temporada do Q4
5 argumentos
kindtextyearnumberdate_fromtextdate_totextlimitnumber
detect_shopify_storeSe uma loja roda na Shopify, o tema dela e os apps da Shopify que ela carrega
1 argumento
urltext

Anúncios e mídia

8 ferramentas
search_adsPesquisar anúncios da Meta (Facebook / Instagram) por palavras no texto, na marca ou na 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_adO registro completo de um anúncio da Meta (ou de um anúncio do Google ou de um post do TikTok)
1 argumento
ad_identifiertext
creative_inspiration_packInspiração criativa para um nicho
5 argumentos
nichetextkeywordslistfocustextmax_adsnumbertrend_signaltext
search_google_ads_libraryPesquisar anúncios do 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_libraryPesquise anúncios e posts orgânicos do 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_linkCriar (ou retornar) o link público de um anúncio
2 argumentos
ad_idtextconfirmtrue / false
delete_ad_share_linkRemover o link público de um anúncio
2 argumentos
ad_idtextconfirmtrue / false
write_ad_hooksEscrever três frases curtas de abertura (ganchos) para um anúncio de um produto, para Meta, TikTok ou ambos
7 argumentos
nichetextproducttextangletextplatformtextlanguagetextregeneratetextidempotency_keytext

Anunciantes e e-mails

5 ferramentas
search_advertisersPesquisar anunciantes (páginas do 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_advertiserO registro de um anunciante, ou os anúncios ativos e o alcance dele dia a dia
4 argumentos
advertiser_idtextviewtextdaysnumbersnapshot_datetext
search_emailsPesquisar e-mails de marketing das marcas por palavras no assunto, no remetente ou no conteúdo
11 argumentos
querytextshoptextcampaign_typetextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtexttimeframetextintenttext
get_email_htmlO HTML bruto de um e-mail (use search_emails antes para encontrar o ID)
4 argumentos
email_idtextinclude_htmltrue / falseshoptexthtml_partnumber
analyze_shop_emailsA estratégia de e-mail de uma loja
2 argumentos
shoptextmax_emailsnumber

Marcas monitoradas

14 ferramentas
list_tracked_brandsAs marcas que você monitora, com os contadores de anúncios ativos
6 argumentos
pagenumberlimitnumberfolder_idslistnametextsort_bytextfolder_idnumber
add_to_brandtrackerComeçar a monitorar uma marca
5 argumentos
facebook_page_idtextwebsite_idtextshop_idtextdomaintextfolder_idnumber
delete_from_brandtrackerParar de monitorar uma marca
3 argumentos
brandtracker_idtextconfirmtrue / falseworkspace_link_idnumber
list_brandtracker_foldersSuas pastas de monitores
create_brandtracker_folderCriar uma pasta de monitores
1 argumento
nametext
rename_brandtracker_folderRenomear uma pasta de monitores
2 argumentos
folder_idnumbernametext
delete_brandtracker_folderExcluir uma pasta de monitores
3 argumentos
folder_idnumberactiontextconfirmtrue / false
move_tracked_brandsMover marcas monitoradas para uma pasta (folder_id=null as tira de qualquer pasta)
3 argumentos
brandtracker_idslistfolder_idnumberworkspace_link_idslist
get_brand_activityO que uma marca monitorada fez na Meta, no TikTok, no Google e por e-mail
11 argumentos
brandtracker_idtextbrandtextviewtextsourcetextsincetextuntiltextdaytexttypeslistpagenumberlimitnumberdetailtext
analyze_tracked_brandUma análise aprofundada de uma marca monitorada
4 argumentos
brandtracker_idtextbrandtextsnapshot_datetextdetailtext
analyze_brand_changesO que mudou para uma marca monitorada em um período (1d, 7d, 14d, 30d; as posições ganhas são lidas em 7d para 1d, os ganchos em 30d para 14d, e os testes de criativos são os mais recentes)
6 argumentos
brandtracker_idtextbrandtextperiodtextfocustextsnapshot_datetextdetailtext
get_brandtracker_scaling_adsOs anúncios de uma marca monitorada que mais ganharam posições, com o histórico de posições
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_transcriptsRoteiros de vídeo de uma marca monitorada, agrupados por texto
9 argumentos
brandtracker_idtextbrandtexttime_periodtextpagenumberlimitnumbereu_onlytrue / falseordertextsort_bytextsnapshot_datetext
daily_radarResumo diário das suas marcas monitoradas
4 argumentos
folder_idslistfocustextevent_typeslistfolder_idnumber

Quadros

14 ferramentas
list_boardsSeus quadros
8 argumentos
scopetextstatetextkindtextsurfacetextparent_board_idtextroot_onlytrue / falsepagenumberlimitnumber
get_boardUm quadro
1 argumento
board_idtext
create_boardCriar um quadro
6 argumentos
nametextkindtextsurfacetextdescriptiontextvisibilitytextparent_board_idtext
update_boardRenomear um quadro, alterar a descrição ou a visibilidade dele
4 argumentos
board_idtextnametextdescriptiontextvisibilitytext
move_boardMover um quadro para dentro de um quadro pasta (parent_board_id=null o leva para o nível superior)
2 argumentos
board_idtextparent_board_idtext
archive_boardArquivar um quadro e tudo o que há dentro dele (restore_board o traz de volta)
2 argumentos
board_idtextconfirmtrue / false
restore_boardRestaurar um quadro arquivado
1 argumento
board_idtext
list_board_itemsOs itens salvos em um quadro
3 argumentos
board_idtextpagenumberlimitnumber
find_saved_itemsPesquisar tudo o que você salvou, em todos os quadros e nos seus favoritos
13 argumentos
querytextsource_typeslistboard_idtextscopetextstatetextsaved_fromtextsaved_totextsort_bytextordertextpagenumberlimitnumberinclude_itemstrue / falsedetailtext
add_board_itemSalvar um item em um quadro de coleção
5 argumentos
board_idtextsource_typetextsource_idtextsource_indextextpositionnumber
move_board_itemMover um item salvo para outro quadro
4 argumentos
board_idtextitem_idtexttarget_board_idtextpositionnumber
remove_board_itemRemover um item salvo de um quadro
3 argumentos
board_idtextitem_idtextconfirmtrue / false
create_board_share_linkCriar um link público para um quadro
2 argumentos
board_idtextconfirmtrue / false
delete_board_share_linkRemover os links públicos de um quadro
2 argumentos
board_idtextconfirmtrue / false

Favoritos

10 ferramentas
list_favoritesSeus anúncios, lojas ou e-mails salvos
6 argumentos
kindtextscopetextfolder_idtextpagenumberlimitnumberdetailtext
add_favorite_itemSalvar um anúncio, uma loja ou um e-mail
4 argumentos
kindtextitem_idtextscopetextfolder_idtext
move_favorite_itemMover um favorito salvo para uma pasta (folder_id=null o tira de qualquer pasta)
4 argumentos
kindtextfavorite_idtextscopetextfolder_idtext
remove_favorite_itemRemover um favorito salvo, pelo próprio ID (favorite_id) ou pelo ID do registro salvo (item_id)
5 argumentos
kindtextscopetextfavorite_idtextitem_idtextconfirmtrue / false
create_favorite_folderCriar uma pasta de favoritos
4 argumentos
kindtextnametextscopetextparent_idtext
update_favorite_folderRenomear uma pasta de favoritos ou movê-la (move=true com parent_id, null para o nível superior)
6 argumentos
kindtextfolder_idtextscopetextnametextparent_idtextmovetrue / false
delete_favorite_folderExcluir uma pasta de favoritos
6 argumentos
kindtextfolder_idtextmodetextscopetexttarget_folder_idtextconfirmtrue / false
set_favorite_folder_visibilityTornar uma pasta de favoritos privada ou compartilhada
4 argumentos
kindtextfolder_idtextvisibilitytextscopetext
create_favorite_folder_share_linkCriar um link público para uma pasta de favoritos
4 argumentos
kindtextfolder_idtextscopetextconfirmtrue / false
delete_favorite_folder_share_linkRemover os links públicos de uma pasta de favoritos
4 argumentos
kindtextfolder_idtextscopetextconfirmtrue / false

Conta

2 ferramentas
usage_getSeu plano, os créditos dele e quantos restam
check_creditsQuantos créditos você ainda tem neste mês (a mesma resposta de usage_get)
Uma chamada de ferramenta custa os resultados que retorna, debitados dos créditos mensais do seu plano, compartilhados com a API REST. 1 crédito = 1 resultado retornado: os detalhes de uma marca, um anúncio ou uma linha de uma lista. Um resultado vazio é gratuito. Chamadas com falha, usage_get e check_credits não custam nada. O servidor também expõe três recursos: sellwinners://me, sellwinners://usage e sellwinners://openapi.

Solução de problemas

  • 401, ou o cliente pede que você entre de novo: a chave foi revogada ou digitada errado, ou o login expirou. Crie uma nova chave em Chaves de API ou reconecte o app.
  • Uma ferramenta responde insufficient_credits: os créditos deste mês acabaram. A chamada não foi executada e não custou nada; a resposta informa o dia em que os créditos se renovam. Os planos pagos podem adicionar créditos na página de cobrança.
  • 403 plan_not_eligible: o plano não inclui esta ferramenta ou o servidor MCP. A resposta indica a funcionalidade; os planos estão na página de preços.
  • Uma ferramenta responde rate_limited: é o limite de requisições por minuto, compartilhado pelo espaço de trabalho. A chamada não foi executada e não custou nada; espere os segundos indicados na resposta e tente de novo.
  • Um app conectado parou de funcionar: desconecte-o em Configurações, MCP, Apps conectados e depois conecte-o de novo. Uma conexão sem uso por 60 dias termina sozinha.
  • Outro problema: escreva para o suporte com o horário da chamada e o nome da ferramenta.