API et MCP

Interrogez SpyWinAds directement dans ChatGPT et Claude.

Permettez à ChatGPT, Claude, Cursor ou à vos scripts de consulter les publicités vidéo Facebook avec SpyWinAds : l’âge réel d’une publicité vidéo, et toutes les boutiques qui diffusent cette même vidéo.

https://spywinads.com/mcp
Lecture seule5 outilsOffre gratuite : 30 appels par jourConnexion OAuth

Connexion

ChatGPT

  1. Ouvrez Plugins dans la barre latérale gauche, cliquez sur Plus en haut à droite, puis choisissez Ajouter un serveur MCP personnalisé.
  2. Collez https://spywinads.com/mcp.
  3. Quand un outil a besoin de votre compte, ChatGPT vous invite à vous connecter à SpyWinAds puis à cliquer sur Allow.

Claude.ai / Claude Desktop

  1. Rendez-vous sur Customize → Connectors → Add custom connector.
  2. Collez https://spywinads.com/mcp, choisissez Sign in when needed.
  3. Connectez-vous quand Claude le demande, puis cliquez sur Allow.

Claude Code · Cursor · VS Code

Claude Code : lancez la commande, puis tapez /mcp pour vous connecter.

claude mcp add --transport http spywinads https://spywinads.com/mcp

Cursor, VS Code, Windsurf, scripts : envoyez une clé API dans un en-tête :

{ "mcpServers": { "spywinads": {
  "url": "https://spywinads.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_KEY" } } } }

Ne placez jamais la clé dans un lien. Vous pouvez révoquer une clé et déconnecter une application à tout moment dans Réglages → API et MCP de SpyWinAds.

Demandez à votre assistant IA

« Cette publicité vidéo est-elle nouvelle, ou s’agit-il d’une ancienne vidéo remise en diffusion ? https://www.facebook.com/ads/library/?id=… »
« Quelles publicités vidéo Facebook la boutique example.com diffuse-t-elle, et combien d’autres boutiques utilisent les mêmes vidéos ? »
« Exporte ce produit Shopify dans un fichier CSV pour que je l’importe dans ma boutique : https://store.com/products/… »

Outil

Lecture seule. 5 outils. Offre gratuite : 30 requêtes par jour. Autorisations : ads:read pour consulter les données publicitaires publiques et product:export pour créer un fichier CSV de produits. Aucune lecture des données de compte, aucune écriture.

spywin_lookup_video_adEntrée

Lien de la Bibliothèque publicitaire Meta ou identifiant de publicité

Renvoie

Âge réel de la vidéo (date de première mise en ligne du fichier sur Facebook, marge d’erreur de 1 à 2 jours), première publicité, nombre de publicités actives, nombre de boutiques qui diffusent ou ont diffusé la même vidéo, boutiques les plus anciennes de la base

spywin_spy_store_adsEntrée

Nom de domaine de la boutique

Renvoie

Publicités actives, nouvelles publicités sur 7 jours, nombre de vidéos, produits, pages Facebook, vidéos phares avec leur âge réel et leur nombre de boutiques

spywin_get_page_adsEntrée

Lien ou identifiant de page Facebook

Renvoie

Total des publicités et publicités actives, nombre de vidéos, vidéos phares, boutiques vers lesquelles la page redirige les clients

spywin_export_shopify_productEntrée

Lien de produit Shopify

Renvoie

Nom, prix, variantes, images, lien de téléchargement d’un fichier CSV à importer dans Shopify (conservé 24 heures) et publicités vidéo du produit présentes dans la base. Autorisation product:export

spywin_get_video_reuse_researchEntrée

—

Renvoie

Chiffres clés du rapport SpyWinAds Video Reuse Index, avec liens vers la méthodologie et les données. Connexion non requise

Obtenir une clé API gratuite

Pour les scripts et les éditeurs de code (Cursor, VS Code). ChatGPT et Claude n’ont pas besoin de clé : ils se connectent avec votre compte SpyWinAds. Saisissez votre e-mail : nous vous envoyons un lien de confirmation, et la clé s’affiche une seule fois.

Vous avez déjà un compte SpyWinAds ? Créez une clé directement dans l’app : Réglages → API et MCP.

REST API

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://spywinads.com/api/v1/store?domain=example.com"

Points de terminaison : /api/v1/video?ad= · /api/v1/store?domain= · /api/v1/page?page= · /api/v1/product?url= · /api/v1/research/video-reuse. Documentation OpenAPI : /api/v1/openapi.json (compatible avec GPT Actions et n8n).

Limites et données

  • Offre gratuite : 30 requêtes par jour (réinitialisées à 0 h, heure du Vietnam), 20 requêtes par minute au maximum. Comptes en essai : 100 requêtes par jour.
  • Données : publicités Meta (Facebook, Instagram) diffusées aux États-Unis, issues de la base SpyWinAds. Les nombres sont des minimums, pas des ventes. Aucune donnée de dépenses publicitaires, de portée ou de chiffre d’affaires. « Boutique la plus ancienne » signifie la plus ancienne dans la base, pas le propriétaire de la vidéo.
  • Chaque requête renvoie exactement ce qu’affichent les outils gratuits sur le web ; aucune recherche dans l’ensemble de la base.
  • Absent de la base ? Le résultat inclut un lien vers l’outil web, où vous pouvez demander une analyse gratuite.

Questions : support@spywinads.com · Politique de confidentialité ›