Cosa sono il server MCP e le API
MCP (Model Context Protocol) è lo standard con cui gli assistenti IA utilizzano strumenti esterni. EU Winners gestisce un server MCP, così un assistente che già utilizzi può cercare nei nostri dati per tuo conto: "trova inserzioni di bellezza in crescita in Germania questa settimana" diventa una vera ricerca su EU Winners, con inserzioni reali nella risposta.
La REST API offre gli stessi dati per il tuo codice: script, fogli di calcolo, dashboard interne o avvisi. Entrambi utilizzano le stesse regole dell'app. Ciò che puoi vedere e ciò che consuma crediti non cambia in base al modo in cui lo richiedi.
Perché è importante per trovare prodotti vincenti in Europa
La ricerca di inserzioni raramente si ferma allo strumento ad spy. Confronti le inserzioni con i tuoi dati di vendita, prepari piani di test, fai un brief al team creativo o tieni una lista aggiornata di prodotti da provare. Quando il tuo assistente può accedere direttamente a EU Winners, puoi fare tutto questo in un'unica conversazione:
- Estrai le inserzioni in maggiore crescita di questa settimana in un mercato e chiedi all'assistente di raggrupparle per angolo comunicativo.
- Analizza il negozio di un concorrente e ogni pagina che lo pubblicizza.
- Controlla quanto è saturo un prodotto prima di ordinare i campioni.
- Inserisci i risultati nelle tue note, documenti o codice.
I dati rimangono gli stessi dell'app: inserzioni con oltre 1.000 utenti di copertura in Europa, classificate in base alla copertura pubblicata da Meta, con il negozio, la pagina e il prodotto dietro ognuna di esse.
Come usarlo in tre passaggi
Collega un assistente (MCP)
- Copia l'URL del connettore. Nell'app, apri la voce API nel menu a sinistra. L'indirizzo MCP è https://euwinners.com/api/mcp.
- Aggiungilo come connettore personalizzato in Claude, ChatGPT o in un altro assistente che supporti i connettori MCP.
- Accedi e approva. Il tuo assistente ti reindirizzerà su EU Winners per accedere e approvare la connessione. Nessuna chiave da copiare. Gli assistenti collegati sono elencati nella pagina API, dove puoi scollegarli in qualsiasi momento.
Usa la REST API
- Crea una chiave nella pagina API. Asgnale un nome. Copiala quando appare, perché viene mostrata una sola volta.
- Inviala come Bearer token con ogni richiesta, ad esempio a /api/v1/feed?country=DE&sort=gain7d per le inserzioni in Germania ordinate per copertura ottenuta in 7 giorni.
- Revoca le chiavi che non usi più dalla stessa pagina.
Cosa può fare il tuo assistente
Il server MCP mette a disposizione degli assistenti otto strumenti:
| Strumento | Cosa fa |
|---|---|
search_ads | Trova inserzioni vincenti in Europa per nicchia, paese, copertura minima, ordinamento (copertura ottenuta in 24 ore o 7 giorni, copertura totale, più recenti), età dell'inserzione, piattaforma del negozio e ricerca testuale |
get_ad | Dettagli completi di una singola inserzione, inclusa la copertura per paese e la cronologia della copertura |
similar_ads | Altre inserzioni per lo stesso prodotto, negozio o pagina |
get_store | Un negozio: piattaforma, app, pagine che lo pubblicizzano e copertura giornaliera |
get_page | Una pagina Facebook: i negozi che pubblicizza e la sua copertura |
list_products | Prodotti pubblicizzati, con il numero di negozi che vendono ciascuno e un punteggio di saturazione |
get_product | Ogni negozio e inserzione che vende un determinato prodotto, data di primo avvistamento e saturazione |
credits | Quanti crediti rimangono nel tuo spazio di lavoro |
La REST API copre le stesse funzionalità: il feed con tutti i suoi filtri, singole inserzioni, inserzioni simili, negozi, pagine, prodotti e crediti.
Cosa ricevi in risposta
I risultati sono le stesse schede delle inserzioni mostrate nell'app, sotto forma di dati: copertura in Europa, copertura ottenuta in 24 ore e 7 giorni, copertura per paese, suddivisione per età e genere, data di inizio, attiva o interrotta, nicchia, formato, testo e titolo dell'inserzione, invito all'azione, dominio e piattaforma del negozio, prodotto, tipo di landing page e prezzo, pagina Facebook, spesa stimata (sempre una stima, Meta non pubblica la spesa per queste inserzioni) e un link all'inserzione nella Meta Ad Library.
Quali piani lo includono
MCP e API sono inclusi in ogni piano: Starter ($29 al mese), Growth ($59) e Pro ($99), IVA esclusa. È necessario un piano attivo per creare chiavi API.
I crediti funzionano esattamente come nell'app. Ogni nuova inserzione, negozio, pagina o prodotto costa un credito la prima volta che il tuo spazio di lavoro lo apre, poi rimane gratuito. I filtri e le ricerche ripetute sono gratuiti. Il piano Starter ha 5.000 crediti al mese, Growth 10.000, e Pro non ha limiti di crediti nel rispetto delle condizioni di utilizzo corretto. Quando un assistente effettua una ricerca, le inserzioni mostrate contano come quelle visualizzate nel feed, quindi richiedi 10 inserzioni alla volta, non 100, a meno che non sia necessario. Lo strumento search_ads restituisce 10 inserzioni per impostazione predefinita. Vedi i prezzi.
Ottime domande da porre al tuo assistente
- "Usa EU Winners per trovare le 10 inserzioni di arredamento che hanno ottenuto maggiore copertura in Francia negli ultimi 7 giorni, e raggruppale per prodotto."
- "Cerca questo negozio su EU Winners e dimmi quali pagine lo pubblicizzano e quali app utilizza."
- "Elenca i prodotti per animali domestici su EU Winners ordinati per saturazione e dimmi quali sembrano essere all'inizio del loro ciclo."
- "Confronta ciò che sta crescendo in Olanda e in Belgio questa settimana."
Per altre idee, leggi la ricerca di inserzioni con Claude e ChatGPT.
Domande frequenti
Quali assistenti funzionano con EU Winners?
Qualsiasi assistente o app che supporti i connettori MCP con accesso, inclusi Claude e ChatGPT. Gli strumenti che consentono di impostare un Bearer token possono anche connettersi direttamente con una chiave API.
Ho bisogno di una chiave API per Claude o ChatGPT?
No. Aggiungi l'URL del connettore, accedi a EU Winners quando richiesto e approva la connessione. Le chiavi API servono per il tuo codice personale e per gli strumenti che non possono effettuare l'accesso tramite interfaccia.
L'MCP è disponibile solo sul piano più alto?
No. MCP e API sono inclusi nei piani Starter, Growth e Pro, con gli stessi strumenti su ciascuno. I piani si differenziano per crediti, accessi utente, digest giornaliero e supporto, non per l'accesso alle API.
L'API mostra gli stessi dati dell'app?
Sì. Gli strumenti MCP e la REST API richiamano gli stessi endpoint dell'app, con gli stessi filtri, le stesse inserzioni bloccate e le stesse regole per i crediti. Anche la funzione Chiedi all'IA nell'app utilizza gli stessi dati, vedi Chiedi all'IA.