Wat de MCP server en API zijn
MCP (Model Context Protocol) is de standaardmanier voor AI assistenten om externe tools te gebruiken. EU Winners draait een MCP server, zodat een assistent die je al gebruikt onze data namens jou kan doorzoeken: "zoek beauty-advertenties die deze week opschalen in Duitsland" wordt een echte zoekopdracht op EU Winners, met echte advertenties in het antwoord.
De REST API biedt dezelfde data voor je eigen code: scripts, spreadsheets, interne dashboards of meldingen. Beide gebruiken dezelfde regels als de app. Wat je kunt zien en wat credits verbruikt, verandert niet door de manier waarop je het vraagt.
Waarom het belangrijk is voor het vinden van winnende producten in Europa
Productonderzoek stopt zelden in de ad spy tool. Je vergelijkt advertenties met je eigen verkoopcijfers, maakt testplannen, breeft een creatief team of houdt een lijst bij van producten om te proberen. Wanneer je assistent rechtstreeks toegang heeft tot EU Winners, kun je dat allemaal in één gesprek doen:
- Haal de best presterende advertenties van deze week in een markt op en vraag de assistent om ze te groeperen op invalshoek.
- Zoek de winkel van een concurrent op en elke pagina die daarvoor adverteert.
- Controleer hoe verzadigd een product is voordat je monsters bestelt.
- Voeg de resultaten toe aan je eigen notities, documenten of code.
De data blijft hetzelfde als in de app: advertenties met meer dan 1.000 EU bereik, gerangschikt op het bereik dat Meta publiceert, met de winkel, pagina en het product achter elke advertentie.
Hoe te gebruiken in drie stappen
Verbind een assistent (MCP)
- Kopieer de connector-URL. Open in de app API in het linkermenu. Het MCP adres is https://euwinners.com/api/mcp.
- Voeg het toe als aangepaste connector in Claude, ChatGPT of een andere assistent die MCP connectors ondersteunt.
- Meld je aan en keur goed. Je assistent stuurt je naar EU Winners om in te loggen en de verbinding goed te keuren. Geen sleutel om te kopiëren. Verbonden assistenten staan op de API pagina, waar je ze op elk moment kunt ontkoppelen.
Gebruik de REST API
- Maak een sleutel aan op de API pagina. Geef het een naam. Kopieer de sleutel wanneer deze verschijnt, want deze wordt maar één keer getoond.
- Stuur het mee als Bearer token bij elk verzoek, bijvoorbeeld naar /api/v1/feed?country=DE&sort=gain7d voor advertenties in Duitsland gesorteerd op bereik dat in 7 dagen is behaald.
- Intrek sleutels die je niet meer gebruikt vanaf dezelfde pagina.
Wat je assistent kan doen
De MCP server geeft assistenten acht tools:
| Tool | Wat het doet |
|---|---|
search_ads | Vind winnende EU advertenties op niche, land, minimaal bereik, sortering (bereik behaald in 24u of 7d, totaal bereik, nieuwste), advertentie-leeftijd, winkelplatform en tekstzoekopdracht |
get_ad | Volledige details van één advertentie, inclusief bereik per land en bereiksgeschiedenis |
similar_ads | Andere advertenties voor hetzelfde product, winkel of pagina |
get_store | Een winkel: platform, apps, de pagina's die ervoor adverteren en het dagelijkse bereik |
get_page | Een Facebook pagina: de winkels waarvoor deze adverteert en het bereik |
list_products | Producten waarvoor wordt geadverteerd, met hoeveel winkels elk product verkopen en een verzadigingsscore |
get_product | Elke winkel en advertentie die één product verkoopt, datum van eerste weergave en verzadiging |
credits | Hoeveel credits je werkruimte nog over heeft |
De REST API dekt hetzelfde terrein: de feed met al zijn filters, losse advertenties, vergelijkbare advertenties, winkels, pagina's, producten en credits.
Wat je terugkrijgt
De resultaten zijn dezelfde advertentiekaarten die de app toont, maar dan als data: EU bereik, bereik behaald in 24 uur en 7 dagen, bereik per land, verdeling in leeftijd en geslacht, startdatum, actief of gestopt, niche, formaat, advertentietekst en kop, call to action, winkeldomein en platform, product, type landingspagina en prijs, Facebook pagina, geschatte uitgaven (altijd een schatting, Meta publiceert geen uitgaven voor deze advertenties) en een link naar de advertentie in de Meta Ad Library.
Welke abonnementen dit bevatten
MCP en API zijn inbegrepen in elk abonnement: Starter ($29 per maand), Growth ($59) en Pro ($99), exclusief btw. Je hebt een abonnement nodig om API keys aan te maken.
Credits werken precies hetzelfde als in de app. Elke nieuwe advertentie, winkel, pagina of product kost één credit de eerste keer dat je werkruimte deze opent, daarna blijft het gratis. Filters en herhaalde zoekopdrachten zijn gratis. Starter heeft 5.000 credits per maand, Growth 10.000, en Pro heeft geen creditlimiet bij fair use. Wanneer een assistent zoekt, tellen de getoonde advertenties mee zoals advertenties die in de feed worden getoond, dus vraag om 10 advertenties, niet om 100, tenzij je ze echt nodig hebt. De search_ads tool geeft standaard 10 advertenties terug. Bekijk prijzen.
Goede vragen om aan je assistent te stellen
- "Gebruik EU Winners om de 10 home-advertenties te vinden die het meeste bereik hebben behaald in Frankrijk in de afgelopen 7 dagen, en groepeer ze per product."
- "Zoek deze winkel op in EU Winners en vertel me welke pagina's ervoor adverteren en welke apps deze gebruikt."
- "Toon huisdierproducten in EU Winners gesorteerd op verzadiging en vertel me welke er vroeg uitzien."
- "Vergelijk wat er deze week opschaalt in Nederland en België."
Lees voor meer ideeën productonderzoek met Claude en ChatGPT.
Vragen
Welke assistenten werken met EU Winners?
Elke assistent of app die MCP connectors met aanmelding ondersteunt, waaronder Claude en ChatGPT. Tools waarmee je een Bearer token kunt instellen, kunnen in plaats daarvan ook verbinding maken met een API key.
Heb ik een API key nodig voor Claude of ChatGPT?
Nee. Voeg de connector-URL toe, meld je aan bij EU Winners wanneer dat wordt gevraagd, en keur de verbinding goed. API keys zijn voor je eigen code en voor tools die niet kunnen aanmelden.
Is MCP alleen beschikbaar op het duurste abonnement?
Nee. MCP en API zijn inbegrepen in Starter, Growth en Pro, met dezelfde tools op elk abonnement. De abonnementen verschillen in credits, seats, de dagelijkse samenvatting en ondersteuning, niet in API toegang.
Toont de API dezelfde data als de app?
Ja. De MCP tools en de REST API roepen dezelfde eindpunten aan als de app, met dezelfde filters, dezelfde vergrendelde advertenties en dezelfde creditregels. Ask AI in de app gebruikt ook dezelfde data, zie Ask AI.