Geef je AI-agent inzicht in advertenties en winkels
De MCP-server van SellWinners stelt onze data beschikbaar als 73 tools. Richt een MCP-client op het endpoint, log in vanuit ChatGPT of Claude of voeg je API-sleutel toe, en je agent kan zelf advertenties doorzoeken, Shopify-winkels bekijken, hun producten doorzoeken en creatives ophalen.
- Streamable HTTP
- Inloggen voor ChatGPT en Claude, of je API-sleutel
- Deelt de credits van je abonnement
# 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
Drie stappen naar de eerste aanroep van je agent
Log in of maak een sleutel aan
Begin gratis, log daarna in vanuit ChatGPT of Claude, of maak een sleutel aan in je dashboard. Het Free-abonnement omvat ook de MCP-server: 150 credits per maand, 10 verzoeken per minuut, de eerste 10 resultaten van elke zoekopdracht.
Voeg de server toe aan je client
Plak de configuratie hieronder in Cursor, VS Code, Claude of een andere client die externe MCP-servers ondersteunt.
Vraag het je agent
Probeer 'vind de beste videoadvertenties voor hardloopschoenen van deze maand'. Je agent kiest zelf de juiste tool.
Stel het in je client in
ChatGPT en Claude loggen in; elders vervang je YOUR_API_KEY door een sleutel uit je dashboard.
No API key: these sign in with your SellWinners account. Het Free-abonnement omvat ook de MCP-server: 150 credits per maand, 10 verzoeken per minuut, de eerste 10 resultaten van elke zoekopdracht. 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 tools, klaar voor gebruik
Open een tool om te zien welke argumenten hij accepteert. Gemarkeerde argumenten zijn verplicht.
Ontdekken
3 toolslookupEen merknaam, een winkeldomein of een Facebook-pagina-ID omzetten naar ID's die je met de andere tools kunt gebruiken
3 argumenten
lookup_filter_idsID's voor de filters van de zoektools
7 argumenten
list_saved_viewsDe zoekopdrachten die je op de lijstpagina's van de website hebt opgeslagen, klaar voor de zoektools
1 argument
Winkels
17 toolssearch_shopsShopify-winkels zoeken of doorbladeren
48 argumenten
find_similar_shopsConcurrenten van een winkel (ID of domein)
10 argumenten
find_winning_productsProducten die nu verkopen in een niche
5 argumenten
search_productsWinkelproducten zoeken of doorbladeren op prijs, verkopen, verkochte eenheden, verkooplanden, advertenties, bereik, reviews, lanceringsdatum, valuta of land van de winkel
37 argumenten
search_products_by_imageWinkelproducten vinden die op een afbeelding lijken (een afbeeldings-URL of het bestand), met hun winkels
12 argumenten
search_shops_by_imageVind de winkels die verkopen wat een afbeelding toont, met hun meest gelijkende producten
7 argumenten
get_productEén product met de volledige fiche: foto's, opties en varianten
2 argumenten
get_product_adsDe Meta-advertenties die naar de pagina van een product linken
5 argumenten
analyze_productEén product, de nieuwste advertenties en een lezing van de signalen
3 argumenten
product_launch_radarOnlangs gelanceerde producten, gerangschikt op verkoop of advertentiedruk
34 argumenten
create_product_share_linkDe openbare link naar één product maken (of ophalen)
2 argumenten
delete_product_share_linkDe openbare link naar één product verwijderen
2 argumenten
brief_competitorEen beknopte briefing over één concurrent (winkel-ID, domein of naam)
11 argumenten
shop_reportEén rapport over een winkel: de feed, de Facebook-pagina's, het Q4-seizoen, een landingspagina, de advertentieranking of de creativetests
19 argumenten
compare_shopsEén cijfer van meerdere winkels naast elkaar
3 argumenten
market_overviewDe hele markt, dag voor dag, of over een Q4-seizoen
5 argumenten
detect_shopify_storeOf een winkel op Shopify draait, het thema en de Shopify-apps die de winkel laadt
1 argument
Advertenties en media
8 toolssearch_adsMeta-advertenties (Facebook / Instagram) zoeken op woorden in de tekst, het merk of de landingspagina
97 argumenten
scan_adHet volledige record van één Meta-advertentie (of van één Google-advertentie of TikTok-post)
1 argument
creative_inspiration_packCreatieve inspiratie voor een niche
5 argumenten
search_google_ads_libraryGoogle-advertenties zoeken
57 argumenten
search_tiktok_libraryTikTok-advertenties en organische posts zoeken
66 argumenten
create_ad_share_linkDe openbare link naar één advertentie maken (of teruggeven)
2 argumenten
delete_ad_share_linkDe openbare link naar één advertentie verwijderen
2 argumenten
write_ad_hooksDrie korte openingszinnen (hooks) schrijven voor een advertentie van een product, voor Meta, TikTok of allebei
7 argumenten
Adverteerders en e-mails
5 toolssearch_advertisersAdverteerders (Facebook-pagina's) zoeken
26 argumenten
scan_advertiserHet record van één adverteerder, of de live advertenties en het bereik dag voor dag
4 argumenten
search_emailsMarketingmails van merken zoeken op woorden in het onderwerp, de afzender of de inhoud
11 argumenten
get_email_htmlDe ruwe HTML van één e-mail (gebruik eerst search_emails om het ID te vinden)
4 argumenten
analyze_shop_emailsDe e-mailstrategie van een winkel
2 argumenten
Gevolgde merken
14 toolslist_tracked_brandsDe merken die je volgt, met hun tellers voor live advertenties
6 argumenten
add_to_brandtrackerEen merk gaan volgen
5 argumenten
delete_from_brandtrackerEen merk niet meer volgen
3 argumenten
list_brandtracker_foldersJe trackermappencreate_brandtracker_folderEen trackermap maken
1 argument
rename_brandtracker_folderEen trackermap hernoemen
2 argumenten
delete_brandtracker_folderEen trackermap verwijderen
3 argumenten
move_tracked_brandsGevolgde merken naar een map verplaatsen (folder_id=null haalt ze uit elke map)
3 argumenten
get_brand_activityWat een gevolgd merk deed op Meta, TikTok, Google en e-mail
11 argumenten
analyze_tracked_brandEen diepgaande blik op één gevolgd merk
4 argumenten
analyze_brand_changesWat er voor een gevolgd merk veranderde in een periode (1d, 7d, 14d, 30d; gewonnen rang wordt bij 1d over 7d gelezen, hooks bij 14d over 30d, creativetests zijn de nieuwste)
6 argumenten
get_brandtracker_scaling_adsDe advertenties van een gevolgd merk die het meest in rang stegen, met hun ranggeschiedenis
32 argumenten
get_brandtracker_transcriptsVideoscripts van een gevolgd merk, gegroepeerd op tekst
9 argumenten
daily_radarDagelijks overzicht van je gevolgde merken
4 argumenten
Borden
14 toolslist_boardsJe borden
8 argumenten
get_boardEén bord
1 argument
create_boardEen bord maken
6 argumenten
update_boardEen bord hernoemen, of de beschrijving of de zichtbaarheid ervan wijzigen
4 argumenten
move_boardEen bord onder een mapbord plaatsen (parent_board_id=null verplaatst het naar het hoogste niveau)
2 argumenten
archive_boardEen bord archiveren met alles wat eronder valt (restore_board haalt het terug)
2 argumenten
restore_boardEen gearchiveerd bord herstellen
1 argument
list_board_itemsDe items die op een bord zijn bewaard
3 argumenten
find_saved_itemsAlles doorzoeken wat je hebt bewaard, op elk bord en in je favorieten
13 argumenten
add_board_itemEen item op een collectiebord bewaren
5 argumenten
move_board_itemEen bewaard item naar een ander bord verplaatsen
4 argumenten
remove_board_itemEen bewaard item van een bord verwijderen
3 argumenten
create_board_share_linkEen openbare link naar een bord maken
2 argumenten
delete_board_share_linkDe openbare links naar een bord verwijderen
2 argumenten
Favorieten
10 toolslist_favoritesJe bewaarde advertenties, winkels of e-mails
6 argumenten
add_favorite_itemEen advertentie, een winkel of een e-mail bewaren
4 argumenten
move_favorite_itemEen bewaarde favoriet naar een map verplaatsen (folder_id=null haalt hem uit elke map)
4 argumenten
remove_favorite_itemEen bewaarde favoriet verwijderen, op zijn eigen ID (favorite_id) of op het ID van het bewaarde record (item_id)
5 argumenten
create_favorite_folderEen favorietenmap maken
4 argumenten
update_favorite_folderEen favorietenmap hernoemen of verplaatsen (move=true met parent_id, null voor het hoogste niveau)
6 argumenten
delete_favorite_folderEen favorietenmap verwijderen
6 argumenten
set_favorite_folder_visibilityEen favorietenmap privé of gedeeld maken
4 argumenten
create_favorite_folder_share_linkEen openbare link naar een favorietenmap maken
4 argumenten
delete_favorite_folder_share_linkDe openbare links naar een favorietenmap verwijderen
4 argumenten
Account
2 toolsusage_getJe abonnement, de credits ervan en hoeveel er nog over zijncheck_creditsHoeveel credits je deze maand nog hebt (hetzelfde antwoord als usage_get)usage_get en check_credits kosten niets. De server biedt ook drie resources: sellwinners://me, sellwinners://usage en sellwinners://openapi.Probleemoplossing
- 401, of de client vraagt je opnieuw in te loggen: de sleutel is ingetrokken of verkeerd getypt, of de inlogsessie is afgelopen. Maak een nieuwe sleutel aan onder API-sleutels, of koppel de app opnieuw.
- Een tool antwoordt insufficient_credits: de credits van deze maand zijn op. De aanroep is niet uitgevoerd en heeft niets gekost; het antwoord noemt de dag waarop de credits worden vernieuwd. Bij betaalde abonnementen kun je credits bijkopen op de factureringspagina.
- 403 plan_not_eligible: het abonnement omvat deze tool of de MCP-server niet. Het antwoord noemt de functie; de abonnementen staan op de prijzenpagina.
- Een tool antwoordt rate_limited: de snelheidslimiet per minuut, die de werkruimte deelt. De aanroep is niet uitgevoerd en heeft niets gekost; wacht het aantal seconden dat het antwoord noemt en probeer het opnieuw.
- Een gekoppelde app werkt niet meer: ontkoppel hem onder Instellingen, MCP, Gekoppelde apps en koppel hem daarna opnieuw. Een koppeling die 60 dagen niet is gebruikt, vervalt vanzelf.
- Iets anders: schrijf naar support met het tijdstip van de aanroep en de naam van de tool.