Google-Ads-Konten und Keyword-Ideen abfragen
MCP-Server für Google Ads · lesen · MIT
Führt Befehle ausWas der Baustein im Konto darf
Lokaler MCP-Server von GoMarble für die Google Ads API mit OAuth 2.0. Er listet Konten auf, führt GAQL-Abfragen aus und liefert Keyword-Ideen mit Metriken.
Was der Server kann
- Listet alle zugänglichen Google-Ads-Konten auf.
- Führt beliebige GAQL-Abfragen für ein Konto aus, optional über ein Manager-Konto.
- Erzeugt Keyword-Ideen mit Kennzahlen aus Keywords oder einer Seiten-URL.
- Meldet sich beim ersten Aufruf per Browser über Google OAuth an und erneuert Tokens automatisch.
- Speichert Tokens lokal in einer Datei.
- Läuft per Standard über stdio, optional im HTTP-Modus mit `python3 server.py --http`.
Einsatz in Marketing und Vertrieb
- Performance-Marketing
- Du fragst, welche Kampagnen der letzten 30 Tage die höchsten Kosten je Conversion haben. Der Assistent formuliert eine GAQL-Abfrage und wertet das Ergebnis aus.
- SEO
- Du nennst eine Seiten-URL und bittest um Keyword-Ideen mit Suchvolumen. Der Server liefert sie aus dem Keyword Planner.
Einrichtung
- Ein Google-Cloud-Projekt anlegen, die Google Ads API aktivieren und OAuth-Zugangsdaten als Desktop-Anwendung erstellen.
- Im Google-Ads-Konto unter API Center einen Developer Token beantragen.
- Das Repository klonen, `pip install -r requirements.txt` ausführen und in `.env` `GOOGLE_ADS_DEVELOPER_TOKEN` und `GOOGLE_ADS_OAUTH_CONFIG_PATH` setzen.
- In der Claude-Desktop-Konfiguration den Python-Interpreter und den Pfad zu `server.py` eintragen, neu starten und beim ersten Aufruf im Browser anmelden.
Grenzen
- Kampagnen anlegen oder ändern ist laut README nur als künftige Funktion in der Roadmap genannt.
- Ein neuer Developer Token ist zunächst ein Test-Token mit eingeschränktem Funktionsumfang, die Freigabe dauert laut README meist 1 bis 3 Werktage.
- Die README nennt Python 3.10 oder neuer als Voraussetzung.
Einordnung der Redaktion
Aufgaben: Anzeigen schalten, Auswerten & berichten. Für Marketing und Vertrieb gedacht.
Beschreibung des Anbieters
This repo helps us to analyze googla ads performance data
Eckdaten
- Maintainer
- gomarble-ai
- Repository-Lizenz
- MIT
- Dienstanbieter
- Offizielle Dienstherkunft nicht belegt
- Dienste
- Google Ads
- Bereiche
- Marketing
- Plattformen
- —
- Clients
- Claude Desktop
Werkzeuge
list_accountsListet alle zugänglichen Google-Ads-Konten.
List all accessible accounts including nested sub-accounts.
Angabe des Anbieters · Beleg 4run_gaqlFührt GAQL-Abfragen mit `customer_id` und `query` aus.
Execute GAQL using the non-streaming search endpoint for consistent JSON parsing.
Angabe des Anbieters · Beleg 4run_keyword_plannerErzeugt Keyword-Ideen mit Kennzahlen.
Generate keyword ideas using Google Ads KeywordPlanIdeaService. This tool allows you to generate keyword ideas based on seed keywords or a page URL.…
Angabe des Anbieters · Beleg 4
Voraussetzungen
Installation
pip install -r requirements.txtRechte
- 1 von 3 Werkzeugen kann Befehle ausführen, etwa run_keyword_planner.
- Der Anbieter deklariert: lesen.
Lass löschende, sendende und ausführende Werkzeuge nur nach Bestätigung je Aktion laufen und verbinde zuerst ein Testkonto.
Ein Google-Ads-Developer-Token, OAuth-Zugangsdaten aus der Google Cloud und die Anmeldung mit einem Google-Konto, das Zugriff auf Google Ads hat. Die drei Werkzeuge lesen nur; die README beschreibt keine Schreibfunktionen.
- Zugriffe laut Paketangaben
- lesen
- Authentifizierung
- —
- Transport
- —
- Technische Prüfung
- Ungeprüft
Quellen (7)
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- Abgerufen und Felder geprüft: 2026-10-05; technische Prüfung: ungeprüft
- Paketpfad: .