Google Ads Library MCP Server

Dies ist ein Model Context Protocol (MCP)-Server für das Google Ads Transparency Center.

Damit können Sie die öffentlichen Anzeigentransparenz von Google nach jedem Unternehmen oder jeder Marke durchsuchen, sehen, was dort aktuell geschaltet wird, und die Werbung analysieren. Sie können Anzeigenbilder/-texte auswerten, Videoanzeigen mit umfassenden Erkenntnissen analysieren, Strategien von Unternehmen vergleichen und Einblicke gewinnen, was in deren Kampagnen funktioniert.

Hier ist ein Beispiel, was möglich ist, wenn es mit Claude verbunden ist.

https://github.com/user-attachments/assets/a47aa689-e89d-4d4b-9df7-6eb3a81937ee

Gehostete Version (Empfohlen)

Der einfachste Weg, den Google Ads Library MCP zu nutzen, ist die gehostete Version von Proxy (useproxy.dev). Keine API-Schlüssel, kein Gemini-Schlüssel, kein Python, kein Server – einfach verbinden und mit Abfragen beginnen.

• ⚡ Keine Einrichtung – nichts installieren, konfigurieren oder warten

• 🔑 Keine API-Schlüssel – ScrapeCreators- und Gemini-Schlüssel komplett überspringen

• 🔌 Funktioniert überall – ChatGPT, Claude, Cursor, Manus und jede andere Umgebung, die MCP unterstützt

• Immer aktuell – neue Tols und Fixes werden automatisch ausgeliefert

👉 Jetzt kostenlos bei useprox.dev starten → (note: keep URL)

Wer es selber ausführen möchte, findet die vollständige Self-Host-Einrichtung weiter unten.

Gehostete vs. Self-Host-Hosting

Für die meisten Menschen ist die gehostete Version der schnellste Weg. Wählen Sie die Self-Hoststelle, wenn Sie den Code der Server selbst anpassen oder erweitern möchten.

Related MCP server: google-ads-transparency-mcp

Beispiel-Prompts

How many ads is 'AnthropicAI' running? What's their split across video and image?

What messaging is 'AnthropicAI' running right now in their ads?

Analyze the video ads from 'Nike' and extract their visual storytelling strategy, pacing, and brand messaging techniques.

Do a deep comparison to the messaging between 'AnthropicAI', 'Perplexity AI' and 'OpenAI'. Give it a nice forwardable summary.

Installation

Voraussetzungen

• Python 3.12+

• Anthropic's Claude Desktop-App (oder Cursor)

• Pip (Python-Paketmanager), Installieren mit python -m pip install

• Einen API-Schlüssel für Ads-Dat-Anbieter, gesetzt als SCRAPECREATORS_API_KEY (siehe Konfiguration unten)

• Ein Google-Google-Gemini-API-Schlüssel für die Videoanalyse (optional, nur für Videoanzeigen benötigt)

Lieber ohne API-Schlüssel? Wechseln Sie nach oben zur Gehostete Version und überspringen Sie die Einrichtung komplett.

Schnellinstallation (Empfohlen)

1. Klonen und Installationsskript ausführen

   git clone https://github.com/proxy-intell/google-ads-library-mcp.git
   cd google-ads-library-mcp
   
   # For macOS/Linux:
   ./install.sh
   
   # For Windows:
   install.bat

2. API-Schlüssel konfigurieren

   Bearbeiten Sie die erstellte .env-Datei und fügen Sie Ihre API-Keys hinzu:

   • Setzen Sie Ihren Ads-Daten-API-Schlüssel als SCRAPECREATORS_API_KEY

   • Erhalten Sie Ihren Gemini-APIy bei Google AI Studio (optional, für Videoanalyse)

3. Die angezeigte MCP-Konfiguration übernehmen

   Das Installationsskript zeigt Ihnen die genaue Konfiguration, die Sie in Claude Desktop oder Cursor hinzufügen Autofahren.

Manuelle Installation

Wer es lieber manuell macht:

1. Dieses Repository klonen

   git clone https://github.com/proxy-intell/google-ads-library-mcp.git
   cd google-ads-library-mcp

2. Abhängigkeiten installieren

   pip install -r requirements.txt

3. API-Schlüssel konfigurieren

   Kopieren Sie die Vorlage und konfigurieren Sie Ihre API-Schlüssel:

   cp .env.template .env
   # Then edit .env with your actual API keys

   API-Schlüssel erhalten:

   • Setzen Sie Ihren Ads-Daten-API-Schlüssel als SCRAPECREATORS_API_KEY in der .env-Datei

   • Google-Google-Gemini-API-Schlüssel hier erhalten (optional, für Videoanalyse)

4. Mit dem MCP-Server verbinden

   Fügen Sie die MCP-Server-Konfiguration zu Ihrer Claude-Desktop- oder Cursor-Konfiguration hinzu:

   {
     "mcpServers": {
       "google_ad_library": {
       "command": "/usr/local/opt/python@3.13/bin/python3",
         "args": [
           "{{PATH_TO_PROJECT}}/google-ads-library-mcp/mcp_server.py"
         ]
       }
     }
   }

   Ersetzen Sie {{PATH_TO_PROJECT}} durch den vollständigen Pfad zu dem Verzeichnis, in dem Sie dieses Repository gekloannt haben.

   Hinweis: API-Keys werden automatisch aus der .env-Datei geladen. Befehlszeilenargumente werden weiter unterstützt und haben, falls angegeben, Vorrang vor den Umgebungsvariablen.

   Für die Claude Desktop:

   Speichern Sie diese Datei als claude_desktop_config.json in Ihrem Claude-Desktop-Konfigurationsverzeichnis:

   ~/Library/Application Support/Claude/claude_desktop_config.json

   Für CursorDatei:

   Speichern Sie diese Datei als mcp.json in Ihrem Cursor-Konfigurationsverzeichnis:

   ~/.cursor/mcp.json

5. Starten Sie Claude Desktop / Cursor neu

   Öffnen Sie Claude Desktop – Sie sollten jetzt die Google Ads Library als verfügbare Integration sehen.

   Oder starten Sie Cursor neu.

Technische Details

1. Claude sendet Anfragen an den Python-MCP-Server.

2. Der MCP-Server fragt die Anzeigendaten-API für Google Ads Transparency Center-Daten ab.

3. Die Daten fließen durch die Kette zurück zu Claude.

Google-Ads-Bibliothek

Dieser Server verbindet sich mit dem Ads Transparency Center von Google:

• Google Ads: Verwendet die Unternehmensdomäne (z. B. „nike.com") oder die Werbeanbieter-ID für die Suche

• ** Antwortformat**: Liefert Anzeigen mit Formattypen (Text/Bild/Video) und detaillierte Varianten

• Anzeigendetails: Jede Anzeige kann mehrere Variationen variations mit anderen Schlagzeilen und Beschreibungen haben

• Regionale Daten: Enthält regionsspezifische Statistiken und Reichweitenmetriken

Tipps:

• Verwenden Sie Unternehmensdomains (z. B. „nike.com") statt Marken-Namen für Unternehmen? Nein.

• Textanzeigen werden jetzt zusätzlich zu Bild- und Videoanzeigen unterstützt

• Jede Anzeige kann mehrere Varianten-Versionen mit anderen Überschriften und Beschreibungen verwenden.

Die verfügbaren MCP-Tools

Dieser MCP-Server stellt diese Tools für die Interaktion with Google Ads Transparency Center dar.

Fehlerbehebung

Hier sind häufige Probleme und Lösungen, wie man sie anspricht.

Fehler API-Key nicht gefunden

• Stellen Sie sicher, dass Ihre .env-Datei im Hauptverzeichnisprojekt liegt

• Falls Siekeine .env-Datei haben, kopieren Sie diese aus dem Vorlagen: cp .env.template .env

• Prüfen Sie, dass die API-Schlüssel geschrieben werden, ohne Zitate

• Kontrollieren Sie, ob die .env- Dateer hält SCRAPECREATORS_API_KEY=your_key_here

• Für Videoanalyse muss zusätzliche GEMINI_API_KEY=your_key_here eingetragen sein

Videoanalyse funktioniert nicht

• Prüfen Sie, dass Ihre Google-Gemini-API-Schlüssel in der .env-Datei korrekt ist

• Die Videoanalyse erfordert die Umgebungsvariable GEMINI_API_KEY

MCP-Server – Verbindungsprobleme

• Prüfen Sie den Pfad in MCP-Konfigurationen – muss auf das richtige Verzeichnis zeigen

• Sind alle Abhängigkeiten via pip install -r requirements.txt vorhanden?

• Starten Sie Claude Desktop/Cursor nach der Einstellung neu

Bei Claude-Desktop-Spezialfeldproblemen siehe die MCP-Dokumentation enthält-Meta. In der Doku finden Sie Tipps zum Log-Check und zur Behandlung gewöhnlicher Probleme.

Spezifisch für Google Ads, Hinweis

• Verwendete drei Unternehmensdomains (z. B. allein „nike.com")

• Textanzeigen sind derzeit neu, gefolgt von Bild- und Videoanzeigen

• Eine Anzeige kann mehrere Variationen in der Form der Headline erzeugen

FAQ

Wie verwende ich Google Ads Library MCP am einfachsten? Am einfachsten installierst du die gehostete Version von Proxy (useproxyn.dev). Hier gid keine API: keine Installation, sicherer Server – einfach verbindest du ChatGPT, Claude, Cursor, Manus oder ein anderer MCP-Client the mit. Start kostenlos.

Brauche process ich einen API-Key for this MCP? Nur when Selbst-Hosting. Die gehostete Version auf useproxy.dev hält den gesamten Datenzugriff für Sie, also weder ScrapeCreators noch Gemini-Api-Schlüssel. Im Fall von Self-host sind es SCRAPECREATORS_API_KEY (und Gin einen Gemini-Schlüssel für Videoanalyse).

Da viel beide BGV.

MCP-Clients Die Server Version sowie Self-Host funktionieren mit ChatGPT, Claude (Desktop/Web), Cursor, Manus oder jede Client, die das Model Context Protocol unterstützt.

Kostenlos? ja - der gehostete version von Proxy ist mit kostenlosen Einstieg möglich, so dass Sie ohne Daten-Austausch starten können, online zu analysieren.

Self-Host oder Host gehostet? Nutze die die |Self-Host-Variante only if du would like to sayView the code changed and improved. Others use the Host-Version.

Feedback

Ihr Feedback hilft uns sehr. Bitte ** [teilen Sie es uns mit] (mailto: support@useproxy.dev)**, welche der Features in dieser Liste nächste Woche gewünscht sind, oder schlagen Sie ganz neue vor.

Lizenz

Diese Projekt istWie von MIT-Lizenz.


Mit ❤️ erstellt beim Team Proxy (useproxy.dev).