Merchant API MCP Access Service (Alpha)

Mit dem Merchant API Model Context Protocol (MCP) Access Service erhalten Sie autorisierten Zugriff auf Ihre Merchant Center-Daten und ‑Statistiken, um neue agentische Funktionen und automatisierte Workflows zu erstellen.

Übersicht

Der Merchant API MCP Access Service bietet eine standardisierte, sichere Brücke für LLMs, Agenten und Coding-Assistenten, um neue agentische Funktionen und automatisierte Workflows zu erstellen und zu orchestrieren, die auf Merchant Center-Daten basieren.

Insbesondere ermöglicht er autorisierten Zugriff auf Ihre Merchant Center-Daten und von Google generierte Berichte und Statistiken, um schreibgeschützte und eingeschränkte Schreibvorgänge für Anwendungsfälle wie die folgenden auszuführen:

  • Produktablehnungen diagnostizieren und beheben
  • Leistungsberichte und Statistiken erstellen
  • Opt-in für automatische Verbesserungen überprüfen
  • Datenquellen erstellen und abrufen

Sicherheits- und Zugriffssteuerung

Der Merchant API MCP Access Service wurde mit Schwerpunkt auf Sicherheit entwickelt:

  • Authentifizierung: Die Toolausführung unterliegt der Standardauthentifizierung der Merchant API, für die OAuth 2.0- oder Dienstkontoanmeldedaten erforderlich sind. Wir empfehlen, Anmeldedaten mit den restriktivsten Zugriffsrechten zu verwenden.
  • Ausführungssicherheit: Die Sichtbarkeit von Tools ist für die agentische Erkennung nicht eingeschränkt, die Toolausführung ist jedoch auf Ihre spezifischen API-Anmeldedaten beschränkt.
  • Sicherheitsmaßnahmen: Die Tools sind als Sicherheitsmaßnahme streng auf schreibgeschützte Vorgänge und Schreibtools mit geringem Risiko (z. B. Erstellung von Datenquellen) beschränkt.

Wichtige Hinweise

Der Merchant API MCP Access Service ist eine Alphaversion. Der Umfang und die Funktionen werden erweitert und können sich ändern.

Beachten Sie vor dem Start die folgenden Einschränkungen und Best Practices:

Änderungen und Releases

Änderungen können ohne vorherige Ankündigung vorgenommen werden und werden in den Versionshinweisen veröffentlicht.

Sicheres Testen

Wir empfehlen, zuerst mit einem Testkonto oder einem Nicht-Live Konto zu experimentieren, bevor Sie diese Tools in einer Live-Produktionsumgebung verwenden.

Gemeinsames Kontingent

Der Merchant API MCP Access Service verwendet denselben Kontingentpool wie Ihre Standard-Merchant API-Aufrufe. Durch die Ausführung von Agenten kann das Kontingent schnell erschöpft sein, insbesondere bei Abrufen von Datenquellen. Wir empfehlen dringend, ein Testkonto zu verwenden, um Unterbrechungen des Produktionsdienstes zu vermeiden.

Toolfilterung und Sicherheit

In Zukunft werden neue Funktionen hinzugefügt, insbesondere Schreibaktionen. Wir empfehlen dringend, Ihren Client explizit für die integrierte Toolfilterung zu konfigurieren, anstatt das gesamte Toolset zur Verfügung zu stellen.

Zusammenfassung der verfügbaren Funktionen

Mit dem Merchant API MCP Access Service können Sie die folgenden Aktionen auf agentische Weise ausführen:

  • Detaillierten Status und Berichtskontext für bestimmte Produkte mit genauen Ressourcennamen abrufen.
  • Nach mehreren Produkten suchen und sie auflisten.
  • Abfragen von Leistungsmesswerten, Produktstatus und Statistiken zu beliebten Produkten, Preisinformationen, Wettbewerbsposition und YouTube Shopping-Affiliate-Analysen.
  • Probleme auf Kontoebene identifizieren , die sich auf die Sichtbarkeit von Produkten oder die Programmteilnahme auswirken.
  • Den Uploadstatus von Datenquellen auflisten, erstellen, abrufen und prüfen.
  • Aggregierte Gründe für Produktablehnungen in Ihrem Inventar auflisten.
  • Die Einstellungen für automatische Verbesserungen für Artikel, Bilder und Versand überprüfen.
  • Die aktiven Regionen, nicht erfüllten Anforderungen und den Teilnahmestatus für bestimmte Merchant Center-Programme prüfen.

Erste Schritte

Wenn Sie Ihre IDE, Ihren Coding-Assistenten oder Ihren Agenten mit dem Merchant API MCP Access Service verbinden möchten, aktualisieren Sie die MCP-Client-Einstellungen. Aktualisieren Sie beispielsweise die Datei mcp.json für Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code oder Ihr benutzerdefiniertes Agenten-Framework.

Für die lokale Einrichtung des Merchant API MCP Access Service ist ein Dienstkonto erforderlich. Die Standard-OAuth-Authentifizierung für Nutzer wird für diese Headless-Ausführung nicht unterstützt. Sie müssen ein Dienstkonto erstellen, die private JSON-Schlüsseldatei herunterladen und den Pfad dazu zusammen mit Ihrer spezifischen Merchant Center-ID als Argumente angeben.

Eine detaillierte Anleitung zum Erstellen und Herunterladen eines Dienstkontos finden Sie im Leitfaden zu Dienstkonten.

Clientkonfiguration

Konfigurationseinstellungen:

Antigravity

Folgen Sie der Anleitung in der Antigravity Dokumentation.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude für den Computer

Folgen Sie der Anleitung in der Claude Desktop Dokumentation.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Beispielszenarien

Die folgenden Szenarien veranschaulichen, wie Sie den Merchant API MCP Access Service nutzen können, um agentische Funktionen und automatisierte Workflows zu erstellen:

Szenario 1: Produktablehnungen diagnostizieren und beheben

Sie möchten wissen, warum ein bestimmtes Produkt nicht in den Google-Suchergebnissen angezeigt wird.

Nutzeraufforderung :

„Warum wurde mein Produkt mit der Angebots-ID ‚offer123‘ abgelehnt?“

Agentenverhalten mit MCP :

  1. Der Agent ruft list_products oder get_product_by_name auf, um den Produktstatus zu ermitteln.
  2. Der MCP-Server gibt den Produktstatus zurück, einschließlich einer Liste von issues (z. B. „Falsches Preisformat“ oder „Fehlender Versandwert“).
  3. Der Agent analysiert die Probleme und erklärt Ihnen die Ursache. Außerdem schlägt er vor, wie Sie das Problem beheben können (z. B. durch Aktualisieren der Preisinformationen).

Szenario 2: Opt-in für automatische Verbesserungen überprüfen

Sie möchten prüfen, ob Ihre automatischen Versandoptimierungen aktiv sind.

Nutzeraufforderung :

„Sind meine automatischen Versandoptimierungen aktiviert?“

Agentenverhalten mit MCP :

  1. Der Agent ruft get_automatic_improvements auf, um die Einstellungen auf Kontoebene abzurufen.
  2. Der MCP-Server gibt die Konfiguration mit dem Status der Bild-, Artikel- und Versandoptimierungen zurück.
  3. Der Agent bestätigt, dass die Versandoptimierungen aktiv sind, oder erklärt, wie Sie sie aktivieren können, wenn sie deaktiviert sind.

Szenario 3: Leistungsberichte und Statistiken erstellen

Sie möchten Ihre aktuelle Leistung schnell prüfen, ohne die Merchant Center-Benutzeroberfläche aufrufen zu müssen.

Nutzeraufforderung :

„Zeig mir die fünf Produkte mit der besten Leistung nach Klicks in der letzten Woche.“

Agentenverhalten mit MCP :

  1. Der Agent erstellt eine MCQL-Abfrage (Merchant Center Query Language) die auf die Tabelle product_performance_view abzielt, nach clicks DESC sortiert und auf 5 beschränkt ist.
  2. Der Agent ruft report_search mit der erstellten Abfrage auf.
  3. Der MCP-Server führt die Abfrage für die Live-Berichtsdatenbank aus und gibt die Zeilen zurück.
  4. Der Agent formatiert die Ergebnisse in einer übersichtlichen Markdown-Tabelle für Sie.

Szenario 4: Datenquellen erstellen und abrufen

Sie möchten eine neue Datenquelle hinzufügen, um Produktaktualisierungen hochzuladen.

Nutzeraufforderung :

„Erstelle eine zusätzliche Datenquelle mit dem Namen ‚price-updates‘ für mein Händlerkonto.“

Agentenverhalten mit MCP :

  1. Der Agent ruft create_data_source mit den angegebenen Einstellungen auf, um den neuen Feed zu registrieren.
  2. Der MCP-Server erstellt die Datenquelle und gibt ihren eindeutigen Ressourcennamen zurück.
  3. Der Agent ruft fetch_data_source auf, um den Download und die Verarbeitung der zugehörigen Datei auszulösen.
  4. Der Agent ruft get_file_upload auf, um den Uploadfortschritt zu beobachten und den erfolgreichen Verarbeitungsstatus der Artikel zu bestätigen.

MCP-Tools und Beschreibungen

Der Merchant API MCP Access Service stellt Ihrem Agenten die folgenden Tools zur Verfügung:

MCP-Tool Beschreibung
get_product_by_name Produktinformationen für einen bestimmten Händler mit dem genauen Ressourcennamen des Produkts abrufen. Gibt den detaillierten Produktstatus mit Berichtskontext und potenziellen Problemen auf Produktebene zurück.
list_products Mehrere Produkte für einen bestimmten Händler auflisten oder suchen. Gibt den detaillierten Produktstatus mit Berichtskontext und potenziellen Problemen auf Produktebene für mehrere Produkte zurück.
report_search Berichtstabellen abfragen, um Produktleistungsmesswerte, Produktstatus, Preisinformationen und Wettbewerbsposition abzurufen. Weitere Informationen finden Sie im Leitfaden zu Berichten.
list_data_sources Verfügbare Datenquellen für einen bestimmten Händler auflisten.
get_data_source Details zu einer bestimmten Datenquelle abrufen.
create_data_source Eine neue Datenquelle für einen bestimmten Händler erstellen.
fetch_data_source Die Datei abrufen und verarbeiten, die mit einer Datenquelle für einen bestimmten Händler verknüpft ist.
get_file_upload Den Status des letzten Datei-Uploads für eine bestimmte Datenquelle abrufen.
list_accounts Konten für einen bestimmten Nutzer auflisten.
list_account_issues Probleme auf Kontoebene für einen bestimmten Händler auflisten, um kontoweite Probleme zu identifizieren.
list_programs Programme für einen bestimmten Händler auflisten, einschließlich Teilnahmestatus, aktiver Regionen und nicht erfüllter Anforderungen.
list_aggregate_product_statuses Aggregierte Probleme auf Produktebene auflisten, um den allgemeinen Zustand Ihrer Produktdaten zu überwachen.
get_automatic_improvements Einstellungen für automatische Verbesserungen abrufen, einschließlich Artikelaktualisierungen, Bildverbesserungen und Versandoptimierungen.