Merchant API MCP Access Service (Alpha)

Skorzystaj z usługi Merchant API Model Context Protocol (MCP) Access Service, aby uzyskać autoryzowany dostęp do danych i statystyk Merchant Center w celu tworzenia nowych rozwiązań agentowych i zautomatyzowanych przepływów pracy.

Przegląd

Usługa Merchant API MCP Access Service zapewnia standardowe, bezpieczne połączenie dla dużych modeli językowych, agentów i asystentów kodowania, które umożliwia tworzenie i koordynowanie nowych rozwiązań agentowych oraz zautomatyzowanych przepływów pracy opartych na danych Merchant Center.

Umożliwia on autoryzowany dostęp do danych Merchant Center oraz raportów i statystyk generowanych przez Google w celu wykonywania operacji odczytu i ograniczonych operacji zapisu w przypadku takich zastosowań jak:

  • Diagnozowanie i rozwiązywanie problemów z odrzuconymi produktami
  • generować raporty i statystyki dotyczące skuteczności,
  • Sprawdzanie zgody na automatyczne poprawki
  • Tworzenie i pobieranie źródeł danych

Zabezpieczenia i kontrola dostępu

Usługa Merchant API MCP Access Service została zaprojektowana z myślą o bezpieczeństwie:

  • Uwierzytelnianie: wykonywanie narzędzia podlega standardowemu uwierzytelnianiu interfejsu Merchant API, które wymaga danych logowania OAuth 2.0 lub konta usługi. Zalecamy używanie danych logowania z jak najbardziej ograniczonymi prawami dostępu.
  • Bezpieczeństwo wykonywania: widoczność narzędzi nie jest ograniczona w przypadku wykrywania agentów, ale wykonywanie narzędzi jest ograniczone do Twoich konkretnych danych logowania API.
  • Zabezpieczenia: narzędzia są ściśle ograniczone do operacji tylko do odczytu i narzędzi do zapisu o niskim ryzyku (np. tworzenia źródła danych) jako zabezpieczenie.

Istotne kwestie

Usługa Merchant API MCP Access Service jest wersją alfa. Jej zakres i możliwości zostaną rozszerzone i mogą ulec zmianie.

Zanim zaczniesz, zapoznaj się z tymi ograniczeniami i sprawdzonymi metodami:

Zmiany i wersje

Zmiany mogą być wprowadzane bez wcześniejszego powiadomienia i będą publikowane w informacjach o wersji.

Bezpieczne testowanie

Zanim zaczniesz korzystać z tych narzędzi w środowisku produkcyjnym, zalecamy przeprowadzenie eksperymentów na koncie testowym lub nieaktywnym koncie.

Limit wspólny

Usługa Merchant API MCP Access Service korzysta z tej samej puli limitów co standardowe wywołania Merchant API. Uruchomione agenty mogą szybko wyczerpać limit, zwłaszcza w przypadku pobierania danych ze źródeł danych. Zdecydowanie zalecamy używanie konta testowego, aby zapobiec przerwom w działaniu usługi produkcyjnej.

Filtrowanie narzędzi i bezpieczeństwo

W przyszłości dodamy nowe funkcje, zwłaszcza działania związane z zapisywaniem. Zdecydowanie zalecamy wyraźne skonfigurowanie klienta pod kątem filtrowania wbudowanych narzędzi zamiast udostępniania całego zestawu narzędzi.

Podsumowanie dostępnych funkcji

Za pomocą usługi Merchant API MCP Access Service możesz wykonywać te czynności w sposób agentowy:

  • Pobieranie szczegółowych informacji o stanie i raportowaniu w przypadku konkretnych produktów za pomocą dokładnych nazw zasobów.
  • Wyświetlanie i wyszukiwanie wielu produktów.
  • Zapytania dotyczące danych o wskaźnikach skuteczności, stanów produktów i statystyk popularnych produktów, statystyk cen, widoczności na tle konkurencji i analityki programu partnerskiego Zakupów na YouTube.
  • Identyfikuj problemy na poziomie konta, które wpływają na widoczność produktów lub udział w programie.
  • Wyświetlanie, tworzenie, pobieranie i sprawdzanie stanu przesyłania źródeł danych.
  • Wyświetlaj zbiorcze powody odrzucenia produktów w całym asortymencie.
  • Sprawdź ustawienia automatycznego poprawiania w przypadku produktów, zdjęć i dostawy.
  • Sprawdź aktywne regiony, niespełnione wymagania i stan uczestnictwa w poszczególnych programach Merchant Center.

Pierwsze kroki

Aby połączyć IDE, asystenta kodowania lub agenta z usługą Merchant API MCP Access, zaktualizuj ustawienia klienta MCP (np. mcp.json lub settings.json).

Konfiguracja klienta

Konfiguracje:

Antigravity

Połącz się bezpośrednio z hostowanym zdalnym punktem końcowym MCP za pomocą tokena dostępu OAuth 2.0 (z zakresem https://www.googleapis.com/auth/content). Postępuj zgodnie z instrukcjami w dokumentacji Antigravity.

{
    "mcpServers": {
        "merchant-api-access": {
            "serverUrl": "https://merchantapi.googleapis.com/mcp",
            "headers": {
                "Authorization": "Bearer {ACCESS_TOKEN}",
                "x-goog-user-project": "{GOOGLE_CLOUD_PROJECT_ID}"
            }
        }
    }
}

Interfejs wiersza poleceń Claude

Dodaj hostowany zdalny punkt końcowy MCP bezpośrednio w interfejsie wiersza poleceń Claude za pomocą polecenia claude mcp add:

claude mcp add --transport http merchant-api https://merchantapi.googleapis.com/mcp --scope local \
  --header "Authorization: Bearer {ACCESS_TOKEN}" \
  --header "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}"

Postępuj zgodnie z instrukcjami w dokumentacji Claude MCP.

cURL

Wysyłaj standardowe żądania JSON-RPC 2.0 bezpośrednio do hostowanego punktu końcowego Merchant API MCP.

Wyświetl dostępne narzędzia:

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Wykonaj wywołanie narzędzia (np. list_data_sources):

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      }
    }
  }'

Zastąp te elementy:

  • ACCOUNT_ID: Twój identyfikator w Merchant Center
  • ACCESS_TOKEN: token autoryzacji do wywołania interfejsu API.
  • GOOGLE_CLOUD_PROJECT_ID: identyfikator projektu Google Cloud powiązanego z kontem Merchant Center.

Przykładowe scenariusze użycia

Aby zilustrować, jak możesz wykorzystać usługę Merchant API MCP Access Service do tworzenia rozwiązań agentowych i zautomatyzowanych przepływów pracy, rozważ te scenariusze:

Scenariusz 1. Diagnozowanie i rozwiązywanie problemów z odrzuconymi produktami

Chcesz dowiedzieć się, dlaczego konkretny produkt nie wyświetla się w wynikach wyszukiwania w Google.

Prompt użytkownika:

„Dlaczego mój produkt o identyfikatorze oferty „offer123” został odrzucony?”

Działanie agenta w przypadku MCP:

  1. Pracownik dzwoni pod numer list_products lub get_product_by_name, aby sprawdzić stan produktu.
  2. Serwer MCP zwraca stan produktu, w tym listę issues (np. „Nieprawidłowy format ceny” lub „Brak wartości dostawy”).
  3. Pracownik obsługi klienta analizuje problemy i wyjaśnia ich główną przyczynę, a także sugeruje, jak je rozwiązać (np. aktualizując informacje o cenie).

Scenariusz 2. Sprawdź zgodę na automatyczne poprawki

Chcesz sprawdzić, czy automatyczne ulepszenia dostawy są aktywne.

Prompt użytkownika:

„Czy mam włączone automatyczne ulepszenia dostawy?”

Działanie agenta w przypadku MCP:

  1. Agent wywołuje funkcję get_automatic_improvements, aby pobrać ustawienia na poziomie konta.
  2. Serwer MCP zwraca konfigurację pokazującą stan ulepszeń obrazu, produktu i dostawy.
  3. Agent potwierdza, że ulepszenia dostawy są aktywne, lub wyjaśnia, jak je włączyć, jeśli są wyłączone.

Scenariusz 3. Generowanie raportów i statystyk dotyczących skuteczności

Chcesz szybko sprawdzić ostatnie wyniki bez poruszania się po interfejsie Merchant Center.

Prompt użytkownika:

„Pokaż mi 5 produktów z największą liczbą kliknięć w zeszłym tygodniu”.

Działanie agenta w przypadku MCP:

  1. Agent tworzy zapytanie w języku zapytań Merchant Center (MCQL) kierowane do tabeli product_performance_view, uporządkowane według clicks DESC i ograniczone do 5.
  2. Agent wywołuje funkcję report_search z utworzonym zapytaniem.
  3. Serwer MCP wykonuje zapytanie w bieżącej bazie danych raportowania i zwraca wiersze.
  4. Agent sformatuje wyniki w postaci czytelnej tabeli Markdown.

Scenariusz 4. Tworzenie i pobieranie źródeł danych

Chcesz dodać nowe źródło danych, aby przesyłać aktualizacje produktów.

Prompt użytkownika:

„Utwórz dodatkowe źródło danych o nazwie „price-updates” na moim koncie sprzedawcy”.

Działanie agenta w przypadku MCP:

  1. Agent wywołuje create_data_source z określonymi ustawieniami, aby zarejestrować nowy plik danych.
  2. Serwer MCP tworzy źródło danych i zwraca jego unikalną nazwę zasobu.
  3. Agent wywołuje funkcję fetch_data_source, aby rozpocząć pobieranie i przetwarzanie powiązanego pliku.
  4. Agent dzwoni get_file_upload, aby monitorować postęp przesyłania i potwierdzić, że produkty zostały przetworzone.

Narzędzia MCP i ich opisy

Usługa Merchant API MCP Access Service udostępnia agentowi te narzędzia:

Narzędzie MCP Opis
get_product_by_name Uzyskaj informacje o produkcie dla danego sprzedawcy, używając dokładnej nazwy zasobu produktu. Zwraca szczegółowy stan produktu zawierający kontekst raportowania i potencjalne problemy na poziomie produktu.
list_products Wyświetlanie lub wyszukiwanie wielu produktów danego sprzedawcy. Zwraca szczegółowy stan produktu zawierający kontekst raportowania i potencjalne problemy na poziomie produktu w przypadku wielu produktów.
report_search Wysyłaj zapytania do tabel raportowania, aby pobierać dane o skuteczności produktów, ich stanach, statystykach dotyczących cen i widoczności na tle konkurencji. Szczegółowe informacje znajdziesz w przewodniku po raportach.
list_data_sources Wyświetla listę dostępnych źródeł danych dla danego sprzedawcy.
get_data_source Uzyskaj szczegółowe informacje o konkretnym źródle danych.
create_data_source Utwórz nowe źródło danych dla danego sprzedawcy.
fetch_data_source Pobieranie i przetwarzanie pliku powiązanego ze źródłem danych danego sprzedawcy.
get_file_upload Sprawdź stan ostatniego przesłanego pliku w przypadku danego źródła danych.
list_accounts Wyświetlanie listy kont danego użytkownika.
list_account_issues Wyświetl listę problemów na poziomie konta danego sprzedawcy, aby zidentyfikować problemy dotyczące całego konta.
list_programs Wyświetla listę programów dla danego sprzedawcy, w tym stan uczestnictwa, aktywne regiony i wszelkie niespełnione wymagania.
list_aggregate_product_statuses Wyświetlaj listę zbiorczych problemów na poziomie produktu, aby monitorować ogólny stan danych o produktach.
get_automatic_improvements Uzyskaj ustawienia automatycznych ulepszeń, w tym aktualizacje produktów, ulepszenia zdjęć i ulepszenia dostawy.