Dai al tuo agente IA l'intelligence su annunci e negozi
Il server MCP di SellWinners espone i nostri dati come 73 strumenti. Punta qualsiasi client MCP all'endpoint, accedi da ChatGPT o Claude oppure aggiungi la tua chiave API, e il tuo agente potrà cercare annunci, esaminare negozi Shopify, cercarne i prodotti e recuperare le creatività da solo.
- HTTP in streaming
- Accesso per ChatGPT e Claude, oppure la tua chiave API
- Condivide i crediti del tuo piano
# 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
Tre passaggi per la prima chiamata del tuo agente
Accedi o crea una chiave
Inizia gratis, poi accedi da ChatGPT o Claude, oppure crea una chiave nella tua dashboard. Il piano Free include anche il server MCP: 150 crediti al mese, 10 richieste al minuto, i primi 10 risultati di ogni ricerca.
Aggiungi il server al tuo client
Incolla la configurazione qui sotto in Cursor, VS Code, Claude o in qualsiasi client che supporti MCP remoto.
Chiedi al tuo agente
Prova «trova i migliori annunci video di scarpe da running di questo mese». Il tuo agente sceglie da solo lo strumento giusto.
Configuralo nel tuo client
ChatGPT e Claude ti fanno accedere; altrove, sostituisci YOUR_API_KEY con una chiave della tua dashboard.
No API key: these sign in with your SellWinners account. Il piano Free include anche il server MCP: 150 crediti al mese, 10 richieste al minuto, i primi 10 risultati di ogni ricerca. 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 strumenti, pronti all'uso
Apri uno strumento per vedere gli argomenti che accetta. Quelli evidenziati sono obbligatori.
Individuazione
3 strumentilookupConverti il nome di un marchio, il dominio di un negozio o l'id di una pagina Facebook in id da usare con gli altri strumenti
3 argomenti
lookup_filter_idsId per i filtri degli strumenti di ricerca
7 argomenti
list_saved_viewsLe ricerche che hai salvato nelle pagine elenco del sito, pronte per gli strumenti di ricerca
1 argomento
Negozi
17 strumentisearch_shopsCerca o sfoglia i negozi Shopify
48 argomenti
find_similar_shopsConcorrenti di un negozio (id o dominio)
10 argomenti
find_winning_productsI prodotti che vendono di più ora in una nicchia
5 argomenti
search_productsCerca o sfoglia i prodotti dei negozi per prezzo, vendite, unità vendute, paesi di vendita, annunci, copertura, recensioni, data di lancio, valuta o paese del negozio
37 argomenti
search_products_by_imageTrova i prodotti dei negozi simili a un'immagine (un URL di immagine o il file), con i loro negozi
12 argomenti
search_shops_by_imageTrova i negozi che vendono ciò che mostra un'immagine, con i prodotti più simili
7 argomenti
get_productUn prodotto con la scheda completa: foto, opzioni e varianti
2 argomenti
get_product_adsGli annunci Meta che rimandano alla pagina di un prodotto
5 argomenti
analyze_productUn prodotto, i suoi ultimi annunci e una lettura dei suoi segnali
3 argomenti
product_launch_radarProdotti lanciati di recente, ordinati per vendite o pressione pubblicitaria
34 argomenti
create_product_share_linkCrea (o restituisci) il link pubblico di un prodotto
2 argomenti
delete_product_share_linkRimuovi il link pubblico di un prodotto
2 argomenti
brief_competitorUn profilo sintetico di un concorrente (id, dominio o nome del negozio)
11 argomenti
shop_reportUn report su un negozio: il suo feed, le sue pagine Facebook, la stagione Q4, una landing page, la classifica dei suoi annunci o i suoi test creativi
19 argomenti
compare_shopsUn dato di più negozi a confronto
3 argomenti
market_overviewL'intero mercato, giorno per giorno, o in una stagione Q4
5 argomenti
detect_shopify_storeSe un negozio usa Shopify, il suo tema e le app Shopify che carica
1 argomento
Annunci e media
8 strumentisearch_adsCerca annunci Meta (Facebook / Instagram) per parole nel testo, marchio o landing page
97 argomenti
scan_adLa scheda completa di un annuncio Meta (o di un annuncio Google o di un post TikTok)
1 argomento
creative_inspiration_packIspirazione creativa per una nicchia
5 argomenti
search_google_ads_libraryCerca annunci Google
57 argomenti
search_tiktok_libraryCerca annunci e post organici TikTok
66 argomenti
create_ad_share_linkCrea (o restituisce) il link pubblico a un annuncio
2 argomenti
delete_ad_share_linkRimuovi il link pubblico a un annuncio
2 argomenti
write_ad_hooksScrivi tre brevi frasi di apertura (hook) per l'annuncio di un prodotto, per Meta, TikTok o entrambi
7 argomenti
Inserzionisti ed email
5 strumentisearch_advertisersCerca inserzionisti (pagine Facebook)
26 argomenti
scan_advertiserLa scheda di un inserzionista, o i suoi annunci attivi e la copertura giorno per giorno
4 argomenti
search_emailsCerca le email di marketing dei marchi per parole nell'oggetto, nel mittente o nel contenuto
11 argomenti
get_email_htmlL'HTML grezzo di un'email (usa prima search_emails per trovare l'id)
4 argomenti
analyze_shop_emailsLa strategia email di un negozio
2 argomenti
Marchi monitorati
14 strumentilist_tracked_brandsI marchi che monitori, con i contatori dei loro annunci attivi
6 argomenti
add_to_brandtrackerInizia a monitorare un marchio
5 argomenti
delete_from_brandtrackerSmetti di monitorare un marchio
3 argomenti
list_brandtracker_foldersLe tue cartelle del monitoraggiocreate_brandtracker_folderCrea una cartella del monitoraggio
1 argomento
rename_brandtracker_folderRinomina una cartella del monitoraggio
2 argomenti
delete_brandtracker_folderElimina una cartella del monitoraggio
3 argomenti
move_tracked_brandsSposta i marchi monitorati in una cartella (folder_id=null li toglie da qualsiasi cartella)
3 argomenti
get_brand_activityCosa ha fatto un marchio monitorato su Meta, TikTok, Google ed email
11 argomenti
analyze_tracked_brandUn'analisi approfondita di un marchio monitorato
4 argomenti
analyze_brand_changesCosa è cambiato per un marchio monitorato in un periodo (1d, 7d, 14d, 30d; per 1d le posizioni guadagnate si leggono su 7d, per 14d gli hook su 30d, i test creativi sono gli ultimi)
6 argomenti
get_brandtracker_scaling_adsGli annunci di un marchio monitorato che hanno guadagnato più posizioni, con lo storico delle posizioni
32 argomenti
get_brandtracker_transcriptsScript video di un marchio monitorato, raggruppati per testo
9 argomenti
daily_radarRiepilogo giornaliero dei tuoi marchi monitorati
4 argomenti
Bacheche
14 strumentilist_boardsLe tue bacheche
8 argomenti
get_boardUna bacheca
1 argomento
create_boardCrea una bacheca
6 argomenti
update_boardRinomina una bacheca, cambiane la descrizione o la visibilità
4 argomenti
move_boardSposta una bacheca sotto una bacheca cartella (parent_board_id=null la porta al livello principale)
2 argomenti
archive_boardArchivia una bacheca e tutto ciò che contiene (restore_board la ripristina)
2 argomenti
restore_boardRipristina una bacheca archiviata
1 argomento
list_board_itemsGli elementi salvati in una bacheca
3 argomenti
find_saved_itemsCerca tutto ciò che hai salvato, in ogni bacheca e nei tuoi preferiti
13 argomenti
add_board_itemSalva un elemento in una bacheca raccolta
5 argomenti
move_board_itemSposta un elemento salvato in un'altra bacheca
4 argomenti
remove_board_itemRimuovi un elemento salvato da una bacheca
3 argomenti
create_board_share_linkCrea un link pubblico a una bacheca
2 argomenti
delete_board_share_linkRimuovi i link pubblici a una bacheca
2 argomenti
Preferiti
10 strumentilist_favoritesI tuoi annunci, negozi o email salvati
6 argomenti
add_favorite_itemSalva un annuncio, un negozio o un'email
4 argomenti
move_favorite_itemSposta un preferito salvato in una cartella (folder_id=null lo toglie da qualsiasi cartella)
4 argomenti
remove_favorite_itemRimuovi un preferito salvato, tramite il suo id (favorite_id) o l'id dell'elemento salvato (item_id)
5 argomenti
create_favorite_folderCrea una cartella di preferiti
4 argomenti
update_favorite_folderRinomina una cartella di preferiti, o spostala (move=true con parent_id, null per il livello principale)
6 argomenti
delete_favorite_folderElimina una cartella di preferiti
6 argomenti
set_favorite_folder_visibilityRendi privata o condivisa una cartella di preferiti
4 argomenti
create_favorite_folder_share_linkCrea un link pubblico a una cartella di preferiti
4 argomenti
delete_favorite_folder_share_linkRimuovi i link pubblici a una cartella di preferiti
4 argomenti
Account
2 strumentiusage_getIl tuo piano, i suoi crediti e quanti ne restanocheck_creditsQuanti crediti ti restano questo mese (stessa risposta di usage_get)usage_get e check_credits non costano nulla. Il server espone anche tre risorse: sellwinners://me, sellwinners://usage e sellwinners://openapi.Risoluzione dei problemi
- 401, oppure il client ti chiede di accedere di nuovo: la chiave è stata revocata o digitata male, oppure l'accesso è scaduto. Crea una nuova chiave in Chiavi API, oppure ricollega l'app.
- Uno strumento risponde insufficient_credits: i crediti di questo mese sono esauriti. La chiamata non è stata eseguita e non è costata nulla; la risposta indica il giorno in cui i crediti si rinnovano. Con i piani a pagamento puoi aggiungere crediti nella pagina di fatturazione.
- 403 plan_not_eligible: il piano non include questo strumento o il server MCP. La risposta indica la funzionalità; i piani sono nella pagina dei prezzi.
- Uno strumento risponde rate_limited: il limite di richieste al minuto, condiviso dall'area di lavoro. La chiamata non è stata eseguita e non è costata nulla; attendi i secondi indicati nella risposta, poi riprova.
- Un'app collegata ha smesso di funzionare: scollegala da Impostazioni, MCP, App collegate, poi collegala di nuovo. Un collegamento inutilizzato per 60 giorni termina da solo.
- Altro: scrivi all'assistenza indicando l'ora della chiamata e il nome dello strumento.