Pelayan MCP

Beri ejen AI anda risikan iklan dan kedai

Pelayan MCP SellWinners mendedahkan data kami sebagai 73 alat. Halakan mana-mana klien MCP ke endpoint, log masuk daripada ChatGPT atau Claude atau tambah kunci API anda, dan ejen anda boleh mencari iklan, memeriksa kedai Shopify, mencari produk mereka dan mengambil kreatif dengan sendirinya.

  • Streamable HTTP
  • Log masuk untuk ChatGPT dan Claude, atau kunci API anda
  • Berkongsi kredit pelan anda
# 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
Cara ia bersambung

Tiga langkah ke panggilan ejen pertama anda

01

Log masuk atau cipta kunci

Mula percuma, kemudian log masuk daripada ChatGPT atau Claude, atau cipta kunci dalam papan pemuka anda. Pelan Free turut menyertakan pelayan MCP: 150 kredit sebulan, 10 permintaan seminit, 10 hasil pertama bagi setiap carian.

02

Tambah pelayan ke klien anda

Tampal konfigurasi di bawah ke dalam Cursor, VS Code, Claude atau mana-mana klien yang menyokong MCP jauh.

03

Tanya ejen anda

Cuba 'cari iklan video teratas untuk kasut lari bulan ini'. Ejen anda memilih alat yang sesuai dengan sendirinya.

Persediaan

Sediakannya dalam klien anda

ChatGPT dan Claude menggunakan log masuk; di tempat lain, gantikan YOUR_API_KEY dengan kunci daripada papan pemuka anda.

No API key: these sign in with your SellWinners account.
Pelan Free turut menyertakan pelayan MCP: 150 kredit sebulan, 10
permintaan seminit, 10 hasil pertama bagi setiap carian.

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

73 alat, sedia digunakan

Buka alat untuk melihat argumen yang diterimanya. Yang diserlahkan wajib diisi.

Penemuan

3 alat
lookupPadankan nama jenama, domain kedai atau id halaman Facebook kepada id yang boleh digunakan dengan alat lain
3 argumen
qtexttypetextlimitnumber
lookup_filter_idsId untuk penapis alat carian
7 argumen
typetextquerytextscope_tracked_pageslistscope_domaintextstatustextlimitnumbersnapshot_datetext
list_saved_viewsCarian yang anda simpan pada halaman senarai laman web, sedia untuk alat carian
1 argumen
contexttext

Kedai

17 alat
search_shopsCari atau semak imbas kedai Shopify
48 argumen
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_shopsPesaing sesebuah kedai (id atau domain)
10 argumen
shoptextlimitnumbersort_bytextordertextoffsetnumberseasontextfiltersobjectmarkettextexclude_shopslistdetailtext
find_winning_productsProduk yang sedang laris dalam sesuatu niche
5 argumen
nichetextkeywordslistcountrytextmax_resultsnumberdetailtext
search_productsCari atau semak imbas produk kedai mengikut harga, jualan, unit terjual, negara jualan, iklan, capaian, ulasan, tarikh pelancaran, mata wang atau negara kedai
37 argumen
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_imageCari produk kedai yang menyerupai gambar (URL imej atau fail), bersama kedai mereka
12 argumen
image_urltextimage_base64textsort_bytextordertextmax_per_shopnumberfiltersobjectpagenumberlimitnumbersearch_idtextdetailtextoffsetnumbergroup_brandstrue / false
search_shops_by_imageCari kedai yang menjual apa yang ditunjukkan gambar, dengan produk paling hampir
7 argumen
image_urltextimage_base64textsearch_idtextlimitnumberoffsetnumbergroup_brandstrue / falseproducts_per_shopnumber
get_productSatu produk dengan helaian penuh: foto, pilihan dan varian
2 argumen
product_idtexturltext
get_product_adsIklan Meta yang memaut ke halaman produk
5 argumen
product_idtextstatustextpagenumberlimitnumberdetailtext
analyze_productSatu produk, iklan terbarunya dan bacaan isyaratnya
3 argumen
product_idtexturltexttop_adsnumber
product_launch_radarProduk yang baru dilancarkan, disusun mengikut jualan atau tekanan iklan
34 argumen
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_linkCipta (atau pulangkan) pautan awam satu produk
2 argumen
product_idtextconfirmtrue / false
delete_product_share_linkAlih keluar pautan awam satu produk
2 argumen
product_idtextconfirmtrue / false
brief_competitorTaklimat ringkas tentang satu pesaing (id kedai, domain atau nama)
11 argumen
competitortextsectionslistmax_productsnumbermax_emailsnumbermax_adsnumbershoptextad_rank_windowtextad_rank_sorttextmax_current_ranknumbermin_rank_deltanumbersnapshot_datetext
shop_reportSatu laporan tentang sesebuah kedai: suapannya, halaman Facebook, musim Q4, halaman pendaratan, kedudukan iklan atau ujian kreatifnya
19 argumen
shoptextreporttextyearnumberdate_fromtextdate_totexturltextadvertiser_idtextmodetextdaysnumberad_idslistdatetextas_oftextmedia_typetextstatustextkeywordslistsnapshot_datetextpagenumberlimitnumberdetailtext
compare_shopsSatu angka bagi beberapa kedai secara bersebelahan
3 argumen
shopslistmetrictextsnapshot_datetext
market_overviewSeluruh pasaran, hari demi hari, atau sepanjang musim Q4
5 argumen
kindtextyearnumberdate_fromtextdate_totextlimitnumber
detect_shopify_storeSama ada kedai berjalan di Shopify, temanya dan apl Shopify yang dimuatkannya
1 argumen
urltext

Iklan dan media

8 alat
search_adsCari iklan Meta (Facebook / Instagram) mengikut perkataan dalam teks iklan, jenama atau halaman pendaratan
97 argumen
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_adRekod penuh satu iklan Meta (atau satu iklan Google atau siaran TikTok)
1 argumen
ad_identifiertext
creative_inspiration_packInspirasi kreatif untuk sesuatu niche
5 argumen
nichetextkeywordslistfocustextmax_adsnumbertrend_signaltext
search_google_ads_libraryCari iklan Google
57 argumen
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_libraryCari iklan TikTok dan siaran organik
66 argumen
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_linkBuat (atau kembalikan) pautan awam ke satu iklan
2 argumen
ad_idtextconfirmtrue / false
delete_ad_share_linkAlih keluar pautan awam ke satu iklan
2 argumen
ad_idtextconfirmtrue / false
write_ad_hooksTulis tiga ayat pembuka ringkas (hook) untuk iklan sesuatu produk, untuk Meta, TikTok atau kedua-duanya
7 argumen
nichetextproducttextangletextplatformtextlanguagetextregeneratetextidempotency_keytext

Pengiklan dan e-mel

5 alat
search_advertisersCari pengiklan (halaman Facebook)
26 argumen
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_advertiserRekod satu pengiklan, atau iklan aktif dan capaiannya hari demi hari
4 argumen
advertiser_idtextviewtextdaysnumbersnapshot_datetext
search_emailsCari e-mel pemasaran jenama mengikut perkataan dalam subjek, penghantar atau kandungan
11 argumen
querytextshoptextcampaign_typetextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtexttimeframetextintenttext
get_email_htmlHTML mentah satu e-mel (gunakan search_emails dahulu untuk mencari id)
4 argumen
email_idtextinclude_htmltrue / falseshoptexthtml_partnumber
analyze_shop_emailsStrategi e-mel sesebuah kedai
2 argumen
shoptextmax_emailsnumber

Jenama yang dijejak

14 alat
list_tracked_brandsJenama yang anda jejak, bersama kaunter iklan aktifnya
6 argumen
pagenumberlimitnumberfolder_idslistnametextsort_bytextfolder_idnumber
add_to_brandtrackerMula menjejak jenama
5 argumen
facebook_page_idtextwebsite_idtextshop_idtextdomaintextfolder_idnumber
delete_from_brandtrackerBerhenti menjejak jenama
3 argumen
brandtracker_idtextconfirmtrue / falseworkspace_link_idnumber
list_brandtracker_foldersFolder penjejak anda
create_brandtracker_folderBuat folder penjejak
1 argumen
nametext
rename_brandtracker_folderNamakan semula folder penjejak
2 argumen
folder_idnumbernametext
delete_brandtracker_folderPadam folder penjejak
3 argumen
folder_idnumberactiontextconfirmtrue / false
move_tracked_brandsPindahkan jenama yang dijejak ke dalam folder (folder_id=null mengeluarkannya daripada sebarang folder)
3 argumen
brandtracker_idslistfolder_idnumberworkspace_link_idslist
get_brand_activityApa yang dilakukan oleh jenama yang dijejak merentasi Meta, TikTok, Google dan e-mel
11 argumen
brandtracker_idtextbrandtextviewtextsourcetextsincetextuntiltextdaytexttypeslistpagenumberlimitnumberdetailtext
analyze_tracked_brandPandangan mendalam tentang satu jenama yang dijejak
4 argumen
brandtracker_idtextbrandtextsnapshot_datetextdetailtext
analyze_brand_changesApa yang berubah bagi jenama yang dijejak dalam satu tempoh (1d, 7d, 14d, 30d; kedudukan yang naik dibaca dalam 7d untuk 1d, hook dalam 30d untuk 14d, ujian kreatif ialah yang terkini)
6 argumen
brandtracker_idtextbrandtextperiodtextfocustextsnapshot_datetextdetailtext
get_brandtracker_scaling_adsIklan jenama yang dijejak yang paling banyak naik kedudukan, bersama sejarah kedudukannya
32 argumen
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_transcriptsSkrip video jenama yang dijejak, dikumpulkan mengikut teks
9 argumen
brandtracker_idtextbrandtexttime_periodtextpagenumberlimitnumbereu_onlytrue / falseordertextsort_bytextsnapshot_datetext
daily_radarRumusan harian merentasi jenama yang anda jejak
4 argumen
folder_idslistfocustextevent_typeslistfolder_idnumber

Papan

14 alat
list_boardsPapan anda
8 argumen
scopetextstatetextkindtextsurfacetextparent_board_idtextroot_onlytrue / falsepagenumberlimitnumber
get_boardSatu papan
1 argumen
board_idtext
create_boardBuat papan
6 argumen
nametextkindtextsurfacetextdescriptiontextvisibilitytextparent_board_idtext
update_boardNamakan semula papan, ubah penerangan atau keterlihatannya
4 argumen
board_idtextnametextdescriptiontextvisibilitytext
move_boardPindahkan papan ke bawah papan folder (parent_board_id=null memindahkannya ke peringkat teratas)
2 argumen
board_idtextparent_board_idtext
archive_boardArkibkan papan dan segala-galanya di bawahnya (restore_board mengembalikannya)
2 argumen
board_idtextconfirmtrue / false
restore_boardPulihkan papan yang diarkibkan
1 argumen
board_idtext
list_board_itemsItem yang disimpan pada papan
3 argumen
board_idtextpagenumberlimitnumber
find_saved_itemsCari segala yang anda simpan, pada setiap papan dan dalam kegemaran anda
13 argumen
querytextsource_typeslistboard_idtextscopetextstatetextsaved_fromtextsaved_totextsort_bytextordertextpagenumberlimitnumberinclude_itemstrue / falsedetailtext
add_board_itemSimpan item pada papan koleksi
5 argumen
board_idtextsource_typetextsource_idtextsource_indextextpositionnumber
move_board_itemPindahkan item yang disimpan ke papan lain
4 argumen
board_idtextitem_idtexttarget_board_idtextpositionnumber
remove_board_itemAlih keluar item yang disimpan daripada papan
3 argumen
board_idtextitem_idtextconfirmtrue / false
create_board_share_linkBuat pautan awam ke papan
2 argumen
board_idtextconfirmtrue / false
delete_board_share_linkAlih keluar pautan awam ke papan
2 argumen
board_idtextconfirmtrue / false

Kegemaran

10 alat
list_favoritesIklan, kedai atau e-mel yang anda simpan
6 argumen
kindtextscopetextfolder_idtextpagenumberlimitnumberdetailtext
add_favorite_itemSimpan iklan, kedai atau e-mel
4 argumen
kindtextitem_idtextscopetextfolder_idtext
move_favorite_itemPindahkan kegemaran yang disimpan ke folder (folder_id=null mengeluarkannya daripada sebarang folder)
4 argumen
kindtextfavorite_idtextscopetextfolder_idtext
remove_favorite_itemAlih keluar kegemaran yang disimpan, mengikut id sendiri (favorite_id) atau id rekod yang disimpan (item_id)
5 argumen
kindtextscopetextfavorite_idtextitem_idtextconfirmtrue / false
create_favorite_folderBuat folder kegemaran
4 argumen
kindtextnametextscopetextparent_idtext
update_favorite_folderNamakan semula folder kegemaran, atau pindahkannya (move=true dengan parent_id, null untuk peringkat teratas)
6 argumen
kindtextfolder_idtextscopetextnametextparent_idtextmovetrue / false
delete_favorite_folderPadam folder kegemaran
6 argumen
kindtextfolder_idtextmodetextscopetexttarget_folder_idtextconfirmtrue / false
set_favorite_folder_visibilityJadikan folder kegemaran peribadi atau dikongsi
4 argumen
kindtextfolder_idtextvisibilitytextscopetext
create_favorite_folder_share_linkBuat pautan awam ke folder kegemaran
4 argumen
kindtextfolder_idtextscopetextconfirmtrue / false
delete_favorite_folder_share_linkAlih keluar pautan awam ke folder kegemaran
4 argumen
kindtextfolder_idtextscopetextconfirmtrue / false

Akaun

2 alat
usage_getPelan anda, kreditnya dan berapa yang berbaki
check_creditsBerapa kredit yang anda ada lagi bulan ini (jawapan sama seperti usage_get)
Satu panggilan alat dikenakan kredit mengikut hasil yang dikembalikannya, daripada kredit bulanan pelan anda, yang dikongsi dengan REST API. 1 kredit = 1 hasil yang dikembalikan: butiran satu jenama, satu iklan, atau satu baris senarai. Hasil kosong adalah percuma. Panggilan yang gagal, usage_get dan check_credits tidak dikenakan sebarang kredit. Pelayan ini juga mendedahkan tiga sumber: sellwinners://me, sellwinners://usage dan sellwinners://openapi.

Penyelesaian masalah

  • 401, atau klien meminta anda log masuk semula: kunci telah dibatalkan atau tersalah taip, atau log masuk telah tamat. Cipta kunci baharu di bawah Kunci API, atau sambungkan semula apl itu.
  • Alat membalas insufficient_credits: kredit bulan ini telah habis digunakan. Panggilan itu tidak dijalankan dan tidak dikenakan sebarang kredit; jawapannya memberikan tarikh kredit diperbaharui. Pelan berbayar boleh menambah kredit di halaman pengebilan.
  • 403 plan_not_eligible: pelan tidak termasuk alat ini atau pelayan MCP. Jawapannya menyebut ciri berkenaan; pelan ada di halaman harga.
  • Alat membalas rate_limited: had kadar seminit, yang dikongsi oleh ruang kerja. Panggilan itu tidak dijalankan dan tidak dikenakan sebarang kredit; tunggu beberapa saat seperti yang diberikan dalam jawapan, kemudian cuba lagi.
  • Apl yang disambungkan berhenti berfungsi: putuskan sambungannya di bawah Tetapan, MCP, Apl yang disambungkan, kemudian sambungkannya semula. Sambungan yang tidak digunakan selama 60 hari akan tamat dengan sendirinya.
  • Perkara lain: tulis kepada sokongan dengan masa panggilan dan nama alat.