Keyword Research MCP

Keyword Research MCP ist ein leichtgewichtiger lokaler MCP-Server zum Abrufen und Normalisieren von Google-Ads-Keyword-Planungsdaten. Er befindet sich in aktiver Entwicklung; das aktuelle Repository enthält das ausführbare Projektfundament sowie die typisierte, getestete Forschungsschnittstelle und den Produktions-Google-Ads-Adapter. Die im Implementierungsplan beschriebene MCP-Tool-Registrierung wird noch entwickelt.

Bezahlte Konkurrenz in Google Ads beschreibt die Aktivität von Werbetreibenden. Dieses Projekt stellt sie nicht als organische Ranking-Schwierigkeit dar und berechnet keinen zusammengesetzten Keyword-Score.

Anforderungen

• Python 3.10 bis 3.14

• uv

Google-Ads-Anmeldedaten werden für Tests nicht benötigt. Sie sind erforderlich, wenn der Produktionsadapter eine Verbindung zu Google Ads herstellt.

Related MCP server: Google Ads MCP Server

Google-Ads-Konfiguration

Der Produktionsadapter verwendet google-ads==31.2.0 und wählt explizit die Google-Ads-API v25 aus. Konfigurieren Sie genau einen Zielkunden und eine Authentifizierungsmethode. Kunden-IDs dürfen Bindestriche enthalten; sie werden im Speicher normalisiert.

Für Benutzer-OAuth setzen Sie:

export GOOGLE_ADS_DEVELOPER_TOKEN="developer-token-placeholder"
export GOOGLE_ADS_CUSTOMER_ID="123-456-7890"
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="987-654-3210" # optional manager account
export GOOGLE_ADS_CLIENT_ID="client-id-placeholder"
export GOOGLE_ADS_CLIENT_SECRET="client-secret-placeholder"
export GOOGLE_ADS_REFRESH_TOKEN="refresh-token-placeholder"

Für ein Dienstkonto lassen Sie die drei Benutzer-OAuth-Einstellungen weg und setzen Sie:

export GOOGLE_ADS_DEVELOPER_TOKEN="developer-token-placeholder"
export GOOGLE_ADS_CUSTOMER_ID="123-456-7890"
export GOOGLE_ADS_JSON_KEY_FILE_PATH="/path/to/service-account.json"
export GOOGLE_ADS_IMPERSONATED_EMAIL="ads-user@example.test" # optional

Alternativ können Sie GOOGLE_ADS_CONFIGURATION_FILE_PATH auf eine lokale google-ads.yaml verweisen:

developer_token: developer-token-placeholder
customer_id: "123-456-7890"
login_customer_id: "987-654-3210"
client_id: client-id-placeholder
client_secret: client-secret-placeholder
refresh_token: refresh-token-placeholder

Optionale Prozesseinstellungen sind KEYWORD_RESEARCH_CACHE_CAPACITY (Standard 128) und KEYWORD_RESEARCH_LOG_LEVEL (Standard INFO). Anmeldedateien, google-ads.yaml und .env-Dateien werden von Git ignoriert.

Einrichtung und Ausführung

uv sync
uv run keyword-research-mcp

Der Befehl läuft über stdio, wartet also still auf einen MCP-Client und schreibt Protokollnachrichten nur auf die Standardausgabe.

Entwicklung

Führen Sie dasselbe Qualitätsgate aus, das in CI verwendet wird:

uv run ruff format --check .
uv run ruff check .
uv run pyright
uv run pytest
uv build

Siehe den Implementierungsplan für die vorgesehenen Tool-Verträge, Architektur, Lieferphasen und Produktgrenzen.

Lizenz

MIT