Agenti IA per la ricerca e-commerce con MCP

Un agente IA è bravo nella parte lenta della ricerca e-commerce: fare dieci ricerche, aprire i risultati, confrontarli e mettere per iscritto cosa hanno in comune. Quello che gli manca, da solo, sono i dati. Chiedi a un assistente in chat quali negozi stanno crescendo in una nicchia e potrà solo tirare a indovinare in base a ciò che ha imparato durante l'addestramento.

MCP risolve il problema dando all'agente strumenti che può chiamare per ottenere dati in tempo reale. Collega un agente al server MCP di SellWinners e potrà cercare da solo negozi Shopify, annunci ed email di marketing, per poi consegnarti una tabella o un brief. Ecco come funziona MCP, come collegare il tuo agente, i prompt che danno buoni risultati e come le chiamate vengono conteggiate nel tuo piano.

Cos'è MCP, in parole semplici

MCP sta per Model Context Protocol. È uno standard aperto per collegare gli assistenti IA a strumenti e dati esterni.

Ha due lati. Un server MCP pubblica un elenco di strumenti: il nome di ciascuno, cosa fa e gli argomenti che accetta. Un client MCP è l'app con cui parli, come Claude Desktop, Cursor o VS Code. Il client mostra l'elenco degli strumenti al modello. Quando la tua domanda richiede dati, il modello sceglie uno strumento e compila gli argomenti, il client esegue la chiamata e il risultato torna al modello, che lo legge prima di rispondere o di chiamare lo strumento successivo.

Per la ricerca questo cambia il lavoro. Fai una domanda in linguaggio naturale, l'agente sceglie gli strumenti e li concatena, e tu controlli la risposta. Non scrivi codice e l'agente lavora con gli stessi dati dell'app web e dell'API REST di SellWinners.

Cosa può fare l'agente con SellWinners

Il server espone il prodotto sotto forma di strumenti pronti all'uso. Questi sono quelli che userai di più per la ricerca:

Strumento	Cosa fa
`lookup`	Trasforma il nome di un marchio, il dominio di un negozio o l'ID di una pagina Facebook negli ID usati dagli altri strumenti
`search_shops`	Cerca o sfoglia i negozi Shopify con dei filtri
`find_winning_products`	I prodotti che vendono di più ora in una nicchia
`find_similar_shops`	I concorrenti di un negozio, per ID o dominio
`brief_competitor`	Un brief sintetico su un concorrente
`search_ads`	Cerca gli annunci Meta per parole nel testo, nel marchio o nella landing page
`scan_ad`	La scheda completa di un annuncio Meta
`creative_inspiration_pack`	Ispirazione creativa per una nicchia
`search_google_ads_library`	Cerca gli annunci Google
`search_tiktok_library`	Cerca annunci TikTok e post organici
`search_emails`	Cerca le email di marketing dei marchi
`analyze_shop_emails`	La strategia email di un negozio
`analyze_brand_changes`	Cosa è cambiato per un marchio monitorato in un periodo
`usage_get`	Il tuo piano, i crediti mensili e quanti ne hai usati

Ce ne sono altri per monitorare marchi, salvare elementi in bacheche e preferiti e condividere. La pagina MCP elenca ogni strumento con i suoi argomenti.

Come collegare il tuo agente a SellWinners

Crea una chiave API. Registrati, poi crea una chiave nella tua dashboard. Anche gli account Free creano chiavi: il piano Free include l'app web e il server MCP (150 crediti al mese), senza l'API (vedi i piani e i loro prezzi). Crea una chiave solo per il tuo agente, così in seguito potrai revocarla separatamente.
Aggiungi il server al tuo client. Al tuo client servono tre cose: l'URL dell'endpoint indicato nella pagina MCP, il trasporto HTTP streamable e la tua chiave in un header X-API-Key (oppure Authorization: Bearer seguito dalla chiave). La pagina MCP contiene configurazioni pronte per Cursor, VS Code e Claude Desktop. Claude Desktop si collega tramite il bridge mcp-remote, che richiede Node.js.
Verifica che funzioni. Chiedi al tuo agente: «Quanti crediti SellWinners ho usato questo mese?». Dovrebbe chiamare usage_get o check_credits, e nessuno dei due costa crediti.

Altri client e framework per agenti funzionano se supportano server MCP remoti tramite HTTP streamable con un header personalizzato. Se usi un altro assistente, ad esempio ChatGPT, verifica se la tua versione ti permette di aggiungere un server MCP remoto con un header personalizzato. In tal caso, gli bastano gli stessi tre valori.

Prompt che funzionano

Gli agenti danno il meglio con domande precise: indica la nicchia, il mercato, quanti risultati vuoi e la forma della risposta. Puoi nominare gli strumenti per guidare l'agente oppure lasciare a lui la scelta.

Ricerca prodotti

Usa find_winning_products per «toelettatura cani». Poi usa search_shops per trovare negozi Shopify di quella nicchia che vendono negli Stati Uniti con almeno 20.000 visite mensili, ordinati per crescita del traffico a 30 giorni. Dammi una tabella dei primi 10 con negozio, visite mensili, crescita, prodotto più venduto e relativo prezzo.

Prosegui con «per i primi tre, usa brief_competitor e dimmi cosa hanno in comune». Prima di puntare su un possibile prodotto vincente, inserisci i tuoi costi al prezzo di mercato nel calcolatore del margine di profitto.

Ricerca sugli annunci dei concorrenti

Usa search_ads per elencare gli annunci Meta attivi di [dominio del concorrente] in corso da almeno 30 giorni, ordinati per copertura. Per ciascuno, indica l'hook iniziale, il titolo, l'invito all'azione, la landing page e i giorni di attività. Poi riassumi i tre angoli che ripete di più.

Così una ricerca nella libreria di annunci diventa un brief creativo. Chiedi lo stesso marchio con search_tiktok_library e search_google_ads_library per confrontare i canali, oppure usa creative_inspiration_pack su un'intera nicchia quando ti servono hook nuovi.

Analisi approfondite dei negozi

Fammi un brief su [dominio del concorrente] con brief_competitor. Poi usa find_similar_shops ordinati per visite mensili e confronta i primi cinque in una tabella: visite mensili, crescita a 30 giorni, annunci attivi, numero di prodotti. Concludi con analyze_shop_emails per il primo negozio: con quale frequenza invia email, in quali giorni e con quali promozioni.

La guida su come analizzare qualsiasi negozio Shopify elenca tutto ciò che vale la pena controllare in un'analisi approfondita.

Tenere sotto controllo

Aggiungi [dominio del concorrente] al mio monitoraggio marchi.

Poi, una volta a settimana, chiedi:

Usa analyze_brand_changes su [dominio del concorrente] per gli ultimi 7 giorni. Quali nuovi annunci ha lanciato e quali annunci hanno guadagnato posizioni?

Il monitoraggio dei marchi che scegli fa parte dei piani a pagamento. L'agente può anche salvare ciò che trova: chiedigli di creare una bacheca e di aggiungere i cinque annunci migliori con create_board e add_board_item.

Come le chiamate agli strumenti consumano i tuoi crediti

Una chiamata a uno strumento costa i risultati che restituisce. 1 credito = 1 risultato restituito: i dettagli di un marchio, un annuncio o una riga di un elenco. Un risultato vuoto è gratuito. Le chiamate MCP vengono scalate dai crediti mensili del tuo piano, gli stessi crediti usati dall'API REST.
Alcune chiamate sono gratuite. Le chiamate non riuscite non costano nulla, e lo stesso vale per usage_get, check_credits, lookup e lookup_filter_ids. Anche le chiamate bloccate dal limite di richieste e quelle con parametri rifiutati non costano nulla.
Una domanda può comportare più chiamate. Il prompt di analisi qui sopra ne fa almeno tre: brief_competitor, find_similar_shops e analyze_shop_emails. Ognuna costa i risultati che restituisce, mentre un lookup iniziale non costa nulla. Chiedi meno risultati per spendere meno.
L'app web non conta. Navigare e controllare i risultati nell'app non consuma nessuno dei tuoi crediti.
I crediti sono mensili. Si rinnovano il 1° del mese (UTC). Quando finiscono, le chiamate successive vengono rifiutate fino al rinnovo, a meno che il proprietario della tua area di lavoro non acquisti crediti di ricarica o passi a un piano superiore. Si applica anche un limite di richieste al minuto, condiviso da tutta l'area di lavoro.

Buone abitudini per la ricerca con gli agenti

Chiedi le fonti. Fatti dire dall'agente quale strumento ha chiamato, con quali filtri, e fagli elencare i domini o gli ID dietro ogni risultato, così puoi aprirli.
Limitalo ai dati. Digli di usare solo i numeri dei risultati degli strumenti e di dire chiaramente quando una ricerca non ha restituito nulla. Così eviti che colmi le lacune con delle supposizioni.
Verifica ciò che guida una decisione. Prima di ordinare merce o di dare un brief a un team creativo, apri i negozi chiave nella pagina Negozi dell'app e gli annunci chiave nella sua pagina Annunci.
Ricorda cosa è stimato. Traffico, vendite e spesa pubblicitaria di altri marchi sono stime. Usali per fare confronti, non come cifre esatte.
Delimita i tuoi prompt. Un solo mercato, un limite di risultati e un output chiaro richiedono meno chiamate di «dimmi tutto sui prodotti per animali».
Leggi prima di confermare. Gli strumenti che eliminano o condividono qualcosa vengono eseguiti solo con una conferma esplicita, quindi controlla cosa propone l'agente prima di dire sì.
Salva i prompt che funzionano. Un buon prompt di analisi di un negozio o di ricerca sugli annunci diventa un modello da riutilizzare ogni settimana.

Come farlo con SellWinners: agente, app e API

Una sola chiave API copre tutte e tre le modalità di accesso, e l'agente è una di queste. Usa ciascuna per ciò che fa meglio:

L'app web per navigare e verificare: filtra i negozi nella pagina Negozi, leggi gli annunci nella pagina Annunci, segui i marchi nel tuo monitoraggio marchi e conserva le scoperte nelle tue bacheche.
L'agente tramite MCP per le domande che richiedono più ricerche combinate: scansioni di nicchia, analisi di negozi, brief sugli annunci e riepiloghi settimanali di ciò che è cambiato.
L'API REST per le attività che si svolgono sempre allo stesso modo, come un'esportazione giornaliera. La documentazione API elenca ogni endpoint.

Per vedere i dati dietro ogni strumento, inizia da Negozi, Libreria annunci, Analisi negozi e Monitoraggio marchi.

Punti chiave

MCP permette a un agente IA di chiamare strumenti per ottenere dati in tempo reale invece di tirare a indovinare in base al suo addestramento.
Per collegarsi bastano tre valori: l'URL dell'endpoint, il trasporto HTTP streamable e la tua chiave API in un header.
I prompt precisi (nicchia, mercato, numero di risultati, formato dell'output) ottengono le risposte migliori e richiedono meno chiamate.
Una chiamata a uno strumento costa i risultati che restituisce, scalati dai tuoi crediti mensili condivisi con l'API REST. Le verifiche dell'utilizzo, i lookup e le chiamate non riuscite sono gratuiti.
Chiedi le fonti, limita l'agente ai risultati degli strumenti e verifica i numeri chiave nell'app web prima di agire.

Come usare un agente IA per la ricerca e-commerce con MCP