MCP 服务器
为您的 AI 智能体提供广告与店铺洞察
SellWinners MCP 服务器将我们的数据封装为 73 个工具。将任意 MCP 客户端指向该端点,在 ChatGPT 或 Claude 中登录,或添加您的 API 密钥,您的智能体就能自行搜索广告、分析 Shopify 店铺、搜索其商品并获取广告素材。
- Streamable HTTP
- ChatGPT 和 Claude 直接登录,或使用您的 API 密钥
- 共用您套餐的点数
# 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
连接方式
三步完成智能体的首次调用
01
登录或创建密钥
免费开始,然后在 ChatGPT 或 Claude 中登录,或在控制台中创建密钥。Free 套餐还包含 MCP 服务器:每月 150 点,每分钟 10 次请求,每次搜索返回前 10 条结果。
02
将服务器添加到客户端
将下面的配置粘贴到 Cursor、VS Code、Claude 或任何支持远程 MCP 的客户端中。
03
向智能体提问
试试「找出本月跑鞋的热门视频广告」。您的智能体会自行选择合适的工具。
配置
在您的客户端中配置
ChatGPT 和 Claude 通过登录连接;其他客户端请将 YOUR_API_KEY 替换为您控制台中的密钥。
No API key: these sign in with your SellWinners account. Free 套餐还包含 MCP 服务器:每月 150 点,每分钟 10 次请求,每次搜索返回前 10 条结果。 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.
// ~/.cursor/mcp.json
{
"mcpServers": {
"sellwinners": {
"url": "https://mcp.sellwinners.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
// .vscode/mcp.json
{
"servers": {
"sellwinners": {
"type": "http",
"url": "https://mcp.sellwinners.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
// claude_desktop_config.json (needs Node.js; uses the mcp-remote bridge)
{
"mcpServers": {
"sellwinners": {
"command": "npx",
"args": ["-y", "[email protected]", "https://mcp.sellwinners.com/mcp",
"--header", "X-API-Key:YOUR_API_KEY"]
}
}
}
Server URL: https://mcp.sellwinners.com/mcp
Transport: streamable HTTP
Header: X-API-Key: YOUR_API_KEY
(or Authorization: Bearer YOUR_API_KEY)
工具
73 个工具,开箱即用
打开某个工具即可查看它接受的参数。高亮显示的为必填参数。
发现
3 个工具lookup把品牌名称、店铺域名或 Facebook 主页 ID 解析为可用于其他工具的 ID
3 个参数
qtexttypetextlimitnumber
lookup_filter_ids搜索工具的筛选条件所用的 ID
7 个参数
typetextquerytextscope_tracked_pageslistscope_domaintextstatustextlimitnumbersnapshot_datetext
list_saved_views您在网站列表页上保存的搜索,可直接用于搜索工具
1 个参数
contexttext
店铺
17 个工具search_shops搜索或浏览 Shopify 店铺
48 个参数
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_shops某家店铺的竞争对手(ID 或域名)
10 个参数
shoptextlimitnumbersort_bytextordertextoffsetnumberseasontextfiltersobjectmarkettextexclude_shopslistdetailtext
find_winning_products某个细分市场中正在热卖的商品
5 个参数
nichetextkeywordslistcountrytextmax_resultsnumberdetailtext
search_products按价格、销售额、销售件数、销售国家、广告、覆盖人数、评价、上架日期、货币或店铺国家搜索或浏览店铺商品
37 个参数
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_image查找与某张图片(图片 URL 或文件)相似的店铺商品及其店铺
12 个参数
image_urltextimage_base64textsort_bytextordertextmax_per_shopnumberfiltersobjectpagenumberlimitnumbersearch_idtextdetailtextoffsetnumbergroup_brandstrue / false
search_shops_by_image查找销售图片所示商品的店铺,并附最相似的商品
7 个参数
image_urltextimage_base64textsearch_idtextlimitnumberoffsetnumbergroup_brandstrue / falseproducts_per_shopnumber
get_product单个商品的完整资料:图片、选项和变体
2 个参数
product_idtexturltext
get_product_ads链接到商品页面的 Meta 广告
5 个参数
product_idtextstatustextpagenumberlimitnumberdetailtext
analyze_product单个商品、其最新广告及信号解读
3 个参数
product_idtexturltexttop_adsnumber
product_launch_radar近期上市的商品,按销售额或广告压力排序
34 个参数
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_link创建(或返回)单个商品的公开链接
2 个参数
product_idtextconfirmtrue / false
delete_product_share_link移除单个商品的公开链接
2 个参数
product_idtextconfirmtrue / false
brief_competitor单个竞争对手的简明简报(店铺 ID、域名或名称)
11 个参数
competitortextsectionslistmax_productsnumbermax_emailsnumbermax_adsnumbershoptextad_rank_windowtextad_rank_sorttextmax_current_ranknumbermin_rank_deltanumbersnapshot_datetext
shop_report店铺的单项报告:动态、Facebook 主页、Q4 旺季、某个落地页、广告排名或素材测试
19 个参数
shoptextreporttextyearnumberdate_fromtextdate_totexturltextadvertiser_idtextmodetextdaysnumberad_idslistdatetextas_oftextmedia_typetextstatustextkeywordslistsnapshot_datetextpagenumberlimitnumberdetailtext
compare_shops并排比较多家店铺的同一指标
3 个参数
shopslistmetrictextsnapshot_datetext
market_overview整个市场的每日数据,或 Q4 旺季期间的数据
5 个参数
kindtextyearnumberdate_fromtextdate_totextlimitnumber
detect_shopify_store店铺是否基于 Shopify,及其主题和加载的 Shopify 应用
1 个参数
urltext
广告与媒体
8 个工具search_ads按文案、品牌或落地页中的词搜索 Meta(Facebook / Instagram)广告
97 个参数
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_ad单条 Meta 广告(或单条 Google 广告、TikTok 帖子)的完整记录
1 个参数
ad_identifiertext
creative_inspiration_pack某个细分市场的创意灵感
5 个参数
nichetextkeywordslistfocustextmax_adsnumbertrend_signaltext
search_google_ads_library搜索 Google 广告
57 个参数
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_library搜索 TikTok 广告和自然帖子
66 个参数
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_link创建(或返回)单条广告的公开链接
2 个参数
ad_idtextconfirmtrue / false
delete_ad_share_link移除单条广告的公开链接
2 个参数
ad_idtextconfirmtrue / false
write_ad_hooks为商品广告写三条简短的开场文案(开头钩子),适用于 Meta、TikTok 或两者
7 个参数
nichetextproducttextangletextplatformtextlanguagetextregeneratetextidempotency_keytext
广告主与邮件
5 个工具search_advertisers搜索广告主(Facebook 主页)
26 个参数
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_advertiser单个广告主的记录,或其每日的在投广告和覆盖人数
4 个参数
advertiser_idtextviewtextdaysnumbersnapshot_datetext
search_emails按标题、发件人或内容中的词搜索品牌营销邮件
11 个参数
querytextshoptextcampaign_typetextsort_bytextordertextpagenumberlimitnumberfiltersobjectdetailtexttimeframetextintenttext
get_email_html单封邮件的原始 HTML(请先用 search_emails 找到 ID)
4 个参数
email_idtextinclude_htmltrue / falseshoptexthtml_partnumber
analyze_shop_emails某家店铺的邮件策略
2 个参数
shoptextmax_emailsnumber
追踪的品牌
14 个工具list_tracked_brands您追踪的品牌及其在投广告计数
6 个参数
pagenumberlimitnumberfolder_idslistnametextsort_bytextfolder_idnumber
add_to_brandtracker开始追踪品牌
5 个参数
facebook_page_idtextwebsite_idtextshop_idtextdomaintextfolder_idnumber
delete_from_brandtracker停止追踪品牌
3 个参数
brandtracker_idtextconfirmtrue / falseworkspace_link_idnumber
list_brandtracker_folders您的追踪文件夹create_brandtracker_folder创建追踪文件夹
1 个参数
nametext
rename_brandtracker_folder重命名追踪文件夹
2 个参数
folder_idnumbernametext
delete_brandtracker_folder删除追踪文件夹
3 个参数
folder_idnumberactiontextconfirmtrue / false
move_tracked_brands把追踪的品牌移入文件夹(folder_id=null 表示移出所有文件夹)
3 个参数
brandtracker_idslistfolder_idnumberworkspace_link_idslist
get_brand_activity追踪的品牌在 Meta、TikTok、Google 和邮件上的动作
11 个参数
brandtracker_idtextbrandtextviewtextsourcetextsincetextuntiltextdaytexttypeslistpagenumberlimitnumberdetailtext
analyze_tracked_brand深入分析单个追踪的品牌
4 个参数
brandtracker_idtextbrandtextsnapshot_datetextdetailtext
analyze_brand_changes追踪的品牌在一段时间内的变化(1d、7d、14d、30d;选 1d 时排名上升按 7d 计算,选 14d 时开头钩子按 30d 计算,素材测试取最新一次)
6 个参数
brandtracker_idtextbrandtextperiodtextfocustextsnapshot_datetextdetailtext
get_brandtracker_scaling_ads追踪的品牌中排名上升最多的广告,附排名历史
32 个参数
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_transcripts追踪的品牌的视频脚本,按文本分组
9 个参数
brandtracker_idtextbrandtexttime_periodtextpagenumberlimitnumbereu_onlytrue / falseordertextsort_bytextsnapshot_datetext
daily_radar所有追踪品牌的每日摘要
4 个参数
folder_idslistfocustextevent_typeslistfolder_idnumber
看板
14 个工具list_boards您的看板
8 个参数
scopetextstatetextkindtextsurfacetextparent_board_idtextroot_onlytrue / falsepagenumberlimitnumber
get_board单个看板
1 个参数
board_idtext
create_board创建看板
6 个参数
nametextkindtextsurfacetextdescriptiontextvisibilitytextparent_board_idtext
update_board重命名看板,或修改其描述或可见性
4 个参数
board_idtextnametextdescriptiontextvisibilitytext
move_board把看板移到某个文件夹看板下(parent_board_id=null 表示移到顶层)
2 个参数
board_idtextparent_board_idtext
archive_board归档看板及其下所有内容(用 restore_board 恢复)
2 个参数
board_idtextconfirmtrue / false
restore_board恢复已归档的看板
1 个参数
board_idtext
list_board_items看板中保存的内容
3 个参数
board_idtextpagenumberlimitnumber
find_saved_items在所有看板和收藏中搜索您保存的全部内容
13 个参数
querytextsource_typeslistboard_idtextscopetextstatetextsaved_fromtextsaved_totextsort_bytextordertextpagenumberlimitnumberinclude_itemstrue / falsedetailtext
add_board_item把内容保存到收藏看板
5 个参数
board_idtextsource_typetextsource_idtextsource_indextextpositionnumber
move_board_item把已保存的内容移到另一个看板
4 个参数
board_idtextitem_idtexttarget_board_idtextpositionnumber
remove_board_item从看板移除已保存的内容
3 个参数
board_idtextitem_idtextconfirmtrue / false
create_board_share_link创建看板的公开链接
2 个参数
board_idtextconfirmtrue / false
delete_board_share_link移除看板的公开链接
2 个参数
board_idtextconfirmtrue / false
收藏
10 个工具list_favorites您保存的广告、店铺或邮件
6 个参数
kindtextscopetextfolder_idtextpagenumberlimitnumberdetailtext
add_favorite_item保存广告、店铺或邮件
4 个参数
kindtextitem_idtextscopetextfolder_idtext
move_favorite_item把收藏的内容移到文件夹(folder_id=null 表示移出所有文件夹)
4 个参数
kindtextfavorite_idtextscopetextfolder_idtext
remove_favorite_item按收藏本身的 ID(favorite_id)或所保存记录的 ID(item_id)移除收藏的内容
5 个参数
kindtextscopetextfavorite_idtextitem_idtextconfirmtrue / false
create_favorite_folder创建收藏夹
4 个参数
kindtextnametextscopetextparent_idtext
update_favorite_folder重命名或移动收藏夹(move=true 并指定 parent_id,null 表示顶层)
6 个参数
kindtextfolder_idtextscopetextnametextparent_idtextmovetrue / false
delete_favorite_folder删除收藏夹
6 个参数
kindtextfolder_idtextmodetextscopetexttarget_folder_idtextconfirmtrue / false
set_favorite_folder_visibility将收藏夹设为私密或共享
4 个参数
kindtextfolder_idtextvisibilitytextscopetext
create_favorite_folder_share_link创建收藏夹的公开链接
4 个参数
kindtextfolder_idtextscopetextconfirmtrue / false
delete_favorite_folder_share_link移除收藏夹的公开链接
4 个参数
kindtextfolder_idtextscopetextconfirmtrue / false
账户
2 个工具usage_get您的套餐、点数及剩余数量check_credits您本月剩余的点数(与 usage_get 的结果相同)每次工具调用按其返回的结果计费,从您套餐的每月点数中扣除,与 REST API 共用。1 点 = 返回 1 个结果:一个品牌的详情、一条广告或列表中的一行。空结果不收费。调用失败、
usage_get 和 check_credits 不消耗点数。服务器还提供三个资源:sellwinners://me、sellwinners://usage 和 sellwinners://openapi。故障排查
- 401,或客户端要求您重新登录:密钥已被撤销或输入有误,或登录已过期。请在 API 密钥中创建新密钥,或重新连接应用。
- 工具返回 insufficient_credits:本月点数已用完。该调用未执行,不消耗点数;返回信息会注明点数重置的日期。付费套餐可以在账单页面充值点数。
- 403 plan_not_eligible:您的套餐不包含此工具或 MCP 服务器。返回信息会注明相应功能;各套餐详见定价页面。
- 工具返回 rate_limited:已达到每分钟速率限制(由工作区共用)。该调用未执行,不消耗点数;请等待返回信息中给出的秒数后重试。
- 已连接的应用停止工作:请在「设置 → MCP → 已连接的应用」中断开连接,然后重新连接。60 天未使用的连接会自动结束。
- 其他问题:请联系客服,并注明调用时间和工具名称。