Qu'est-ce que le serveur MCP et l'API
MCP (Model Context Protocol) est le moyen standard pour les assistants IA d'utiliser des outils externes. EU Winners gère un serveur MCP, de sorte qu'un assistant que vous utilisez déjà peut rechercher nos données en votre nom : "trouver des publicités de beauté qui scalent en Allemagne cette semaine" devient une véritable recherche sur EU Winners, avec de vraies publicités dans la réponse.
L'API REST fournit les mêmes données pour votre propre code : scripts, feuilles de calcul, tableaux de bord internes ou alertes. Les deux utilisent les mêmes règles que l'application. Ce que vous pouvez voir, et ce qui consomme des crédits, ne change pas selon la façon dont vous le demandez.
Pourquoi c'est important pour trouver des produits gagnants en Europe
La recherche publicitaire se termine rarement dans l'outil d'espionnage publicitaire. Vous comparez les publicités avec vos propres données de vente, rédigez des plans de test, briefez une équipe créative ou tenez à jour une liste de produits à tester. Lorsque votre assistant peut accéder directement à EU Winners, vous pouvez faire tout cela en une seule conversation :
- Récupérez les publicités les plus performantes de la semaine sur un marché et demandez à l'assistant de les regrouper par angle marketing.
- Recherchez la boutique d'un concurrent et chaque page qui en fait la publicité.
- Vérifiez à quel point un produit est saturé avant de commander des échantillons.
- Intégrez les résultats dans vos propres notes, documents ou code.
Les données restent les mêmes que dans l'application : des publicités ayant dépassé 1 000 de portée en Europe, classées selon la portée publiée par Meta, avec la boutique, la page et le produit derrière chacune d'elles.
Comment l'utiliser en trois étapes
Connecter un assistant (MCP)
- Copiez l'URL du connecteur. Dans l'application, ouvrez API dans le menu de gauche. L'adresse MCP est https://euwinners.com/api/mcp.
- Ajoutez-la comme connecteur personnalisé dans Claude, ChatGPT ou un autre assistant qui prend en charge les connecteurs MCP.
- Connectez-vous et approuvez. Votre assistant vous redirige vers EU Winners pour vous connecter et approuver la connexion. Pas de clé à copier. Les assistants connectés sont listés sur la page API, où vous pouvez les déconnecter à tout moment.
Utiliser l'API REST
- Créez une clé sur la page API. Donnez-lui un nom. Copiez-la lorsqu'elle apparaît, car elle ne s'affiche qu'une seule fois.
- Envoyez-la en tant que jeton Bearer avec chaque requête, par exemple vers /api/v1/feed?country=DE&sort=gain7d pour les publicités en Allemagne triées par portée gagnée en 7 jours.
- Révoquez les clés que vous n'utilisez plus depuis la même page.
Ce que votre assistant peut faire
Le serveur MCP donne aux assistants huit outils :
| Outil | Ce qu'il fait |
|---|---|
search_ads | Trouver des publicités européennes gagnantes par niche, pays, portée minimale, tri (portée gagnée en 24h ou 7j, portée totale, plus récentes), âge de la publicité, plateforme de boutique et recherche textuelle |
get_ad | Détails complets d'une publicité, y compris la portée par pays et l'historique de portée |
similar_ads | Autres publicités pour le même produit, boutique ou page |
get_store | Une boutique : plateforme, applications, pages qui en font la publicité et portée quotidienne |
get_page | Une page Facebook : les boutiques dont elle fait la publicité et sa portée |
list_products | Produits faisant l'objet de publicités, avec le nombre de boutiques qui vendent chacun et un score de saturation |
get_product | Chaque boutique et publicité vendant un produit, date de première vue et saturation |
credits | Combien de crédits il reste à votre espace de travail |
L'API REST couvre le même domaine : le flux avec tous ses filtres, les publicités uniques, les publicités similaires, les boutiques, les pages, les produits et les crédits.
Ce que vous recevez en retour
Les résultats sont les mêmes fiches publicitaires que l'application affiche, sous forme de données : portée en Europe, portée gagnée en 24 heures et 7 jours, portée par pays, répartition par âge et genre, date de début, active ou arrêtée, niche, format, texte et titre de la publicité, appel à l'action, domaine et plateforme de la boutique, produit, type de page de destination et prix, page Facebook, estimation des dépenses (toujours une estimation, Meta ne publiant pas les dépenses pour ces publicités) et un lien vers la publicité dans la Meta Ad Library.
Quels plans l'incluent
MCP et l'API sont inclus dans tous les plans : Starter (29 $ par mois), Growth (59 $) et Pro (99 $), hors TVA. Vous devez avoir un plan pour créer des clés API.
Les crédits fonctionnent exactement comme dans l'application. Chaque nouvelle publicité, boutique, page ou produit coûte un crédit la première fois que votre espace de travail l'ouvre, puis reste gratuit. Les filtres et les recherches répétées sont gratuits. Le plan Starter comprend 5 000 crédits par mois, Growth 10 000, et Pro n'a pas de limite de crédit dans le cadre d'une utilisation équitable. Lorsqu'un assistant effectue une recherche, les publicités qu'il affiche comptent comme des publicités affichées dans le flux, demandez donc 10 publicités, pas 100, sauf si vous en avez besoin. L'outil search_ads renvoie 10 publicités par défaut. Voir les tarifs.
Bonnes questions à poser à votre assistant
- "Utilise EU Winners pour trouver les 10 publicités de la niche maison qui ont gagné le plus de portée en France au cours des 7 derniers jours, et groupe-les par produit."
- "Recherche cette boutique dans EU Winners et dis-moi quelles pages en font la publicité et quelles applications elle utilise."
- "Liste les produits pour animaux dans EU Winners triés par saturation et dis-moi lesquels semblent récents."
- "Compare ce qui scale aux Pays-Bas et en Belgique cette semaine."
Pour plus d'idées, lisez la recherche publicitaire avec Claude et ChatGPT.