Skip to main content
Glama
deenesjakoruzh
pccaza

Keyword Research MCP

by pccaza
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Google Ads MCP Server

    blievens89
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables comprehensive Google Ads campaign management and analytics through the Google Ads API. Supports querying campaigns, ad groups, keywords, performance metrics, and executing custom GAQL queries with token-efficient implementation.
    -

  • Google Ads MCP Server

    contentkueche
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to interact with Google Ads accounts by searching, retrieving resource metadata, and listing accessible customers via the Google Ads API.
    Apache 2.0