API und MCP

Frag SpyWinAds direkt in ChatGPT und Claude.

Lass ChatGPT, Claude, Cursor oder dein eigenes Skript Facebook-Videoanzeigen mit SpyWinAds nachschlagen: wie alt ein Anzeigenvideo wirklich ist und welche Stores dasselbe Video schalten.

https://spywinads.com/mcp
Nur Lesezugriff5 ToolsGratis-Tarif: 30 Aufrufe pro TagAnmeldung per OAuth

Verbindung

ChatGPT

  1. Öffne Plugins in der linken Seitenleiste, klicke oben rechts auf Mehr und wähle Benutzerdefinierten MCP-Server hinzufügen.
  2. Füge https://spywinads.com/mcp.
  3. Braucht ein Tool dein Konto, bittet dich ChatGPT, dich bei SpyWinAds anzumelden und auf Allow.

Claude.ai / Claude Desktop

  1. Öffne Customize → Connectors → Add custom connector.
  2. Füge https://spywinads.com/mcp ein und wähle Sign in when needed.
  3. Melde dich an, wenn Claude fragt, und klicke auf Allow.

Claude Code · Cursor · VS Code

Claude Code: Befehl ausführen, dann /mcp ein, um dich anzumelden.

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

Cursor, VS Code, Windsurf, Skripte: API-Schlüssel im Header senden:

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

Setze den Schlüssel niemals in einen Link. Du kannst Schlüssel jederzeit widerrufen und verbundene Apps entfernen – in SpyWinAds unter Einstellungen → API und MCP.

Frag deinen KI-Assistenten

„Ist dieses Anzeigenvideo neu oder ein altes Video, das erneut geschaltet wird? https://www.facebook.com/ads/library/?id=…“
„Welche Facebook-Videoanzeigen schaltet der Store example.com, und wie viele andere Stores nutzen dieselben Videos?“
„Exportiere dieses Shopify-Produkt als CSV-Datei, damit ich es in meinen Store importieren kann: https://store.com/products/…“

Tool

Nur Lesezugriff. 5 Tools. Kostenloser Tarif: 30 Abrufe pro Tag. Berechtigungen: ads:read zum Abrufen öffentlicher Anzeigendaten und product:export zum Erstellen von CSV-Produktdateien. Liest keine Kontodaten und schreibt nichts.

spywin_lookup_video_adEingabe

Link zur Meta-Werbebibliothek oder Anzeigen-ID

Rückgabe

Tatsächliches Alter des Videos (Datum, an dem die Datei erstmals auf Facebook hochgeladen wurde, Abweichung 1–2 Tage), erste Anzeige, Anzahl aktiver Anzeigen, Anzahl der Shops, die das Video aktuell oder früher geschaltet haben, die frühesten Shops in der Datenbank

spywin_spy_store_adsEingabe

Store-Domain

Rückgabe

Aktive Anzeigen, neue Anzeigen der letzten 7 Tage, Anzahl der Videos, Produkte, Fanpages, Top-Videos mit tatsächlichem Alter und Anzahl der Shops

spywin_get_page_adsEingabe

Link oder ID einer Facebook-Fanpage

Rückgabe

Anzeigen insgesamt und aktive Anzeigen, Anzahl der Videos, Top-Videos, die Stores, auf die die Fanpage Besucher leitet

spywin_export_shopify_productEingabe

Shopify-Produktlink

Rückgabe

Name, Preis, Varianten, Bilder, Download-Link für eine CSV-Datei zum Import in Shopify (24 Stunden verfügbar) und die Anzeigenvideos des Produkts in der Datenbank. Berechtigung product:export

spywin_get_video_reuse_researchEingabe

—

Rückgabe

Die wichtigsten Zahlen des SpyWinAds-Berichts Video Reuse Index, mit Links zu Methodik und Daten. Keine Anmeldung nötig

Kostenlosen API-Schlüssel erhalten

Für Skripte und Code-Editoren (Cursor, VS Code). ChatGPT und Claude brauchen keinen Schlüssel: Sie melden sich mit deinem SpyWinAds-Konto an. Gib deine E-Mail-Adresse ein – wir senden dir einen Bestätigungslink und zeigen den Schlüssel einmalig an.

Du hast schon ein SpyWinAds-Konto? Erstelle direkt in der App einen Schlüssel: Einstellungen → API und MCP.

REST API

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

Endpunkte: /api/v1/video?ad= · /api/v1/store?domain= · /api/v1/page?page= · /api/v1/product?url= · /api/v1/research/video-reuse. OpenAPI-Dokumentation: /api/v1/openapi.json (funktioniert mit GPT Actions und n8n).

Limits und Daten

  • Kostenloser Tarif: 30 Abrufe pro Tag (Zurücksetzung um 0 Uhr vietnamesischer Zeit), höchstens 20 Abrufe pro Minute. Konten im Testzeitraum: 100 Abrufe pro Tag.
  • Daten: Meta-Anzeigen (Facebook, Instagram), die in den USA ausgespielt werden, aus der SpyWinAds-Datenbank. Zählwerte sind Mindestwerte, keine Verkaufszahlen. Keine Werbeausgaben, Reichweiten oder Umsätze. „Frühester Store“ bedeutet der früheste in der Datenbank, nicht der Urheber des Videos.
  • Jeder Abruf liefert genau das, was das kostenlose Web-Tool anzeigt; eine Suche in der gesamten Datenbank gibt es nicht.
  • Noch nicht in der Datenbank? Das Ergebnis enthält einen Link zum Web-Tool, wo du kostenlos einen Scan anfordern kannst.

Fragen: support@spywinads.com · Datenschutz ›