Serwer MCP danych sprzedawcy (publiczna wersja alfa)

Uzyskuj aktualne dane o koncie Merchant Center bezpośrednio od wybranego asystenta kodowania. W zintegrowanym środowisku programistycznym (IDE) lub niestandardowej platformie agenta możesz teraz uzyskiwać dostęp do danych Merchant Center i nimi zarządzać za pomocą usługi Model Context Protocol (MCP). Ta usługa umożliwia asystentowi kodowania lub agentowi wykonywanie operacji odczytu i bezpiecznego zapisu na danych Merchant Center, co pozwala mu diagnozować problemy, sprawdzać programy i wykonywać zapytania dotyczące raportów z autorytatywnym, aktualnym kontekstem.

Więcej informacji o tym protokole znajdziesz w standardzie Model Context Protocol.

Zabezpieczenia i kontrola dostępu

Serwer MCP danych sprzedawcy został zaprojektowany z myślą o bezpieczeństwie:

  • Uwierzytelnianie: wykonywanie narzędzia podlega ściśle standardowemu uwierzytelnianiu w interfejsie Merchant API, które wymaga danych logowania OAuth 2.0 lub konta usługi.
  • Bezpieczeństwo wykonywania: pomimo szerokiej widoczności schematów narzędzi dla Twojego agenta faktyczne wykonywanie dowolnego narzędzia pozostaje wysoce bezpieczne i jest ściśle ograniczone przez Twoje konkretne dane logowania do interfejsu API.

Istotne kwestie

Zanim zaczniesz korzystać z tych narzędzi, zapoznaj się z tymi sprawdzonymi metodami i ograniczeniami:

Zmiany i wersje

Informacje o zmianach będziemy publikować w informacjach o wersji, ale mogą one być wprowadzane natychmiast, bez okresu wycofania.

Bezpieczne testowanie

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

Limit udostępniony

Serwer MCP korzysta z tej samej puli limitów co standardowe wywołania interfejsu Merchant API. Uruchamianie agentów może 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 możemy dodać do tego serwera MCP nowe narzędzia (w tym funkcje zapisu). Aby zapobiec automatycznemu i niezamierzonemu wykonywaniu przez agenta AI nowych lub ryzykownych narzędzi, zdecydowanie zalecamy wyraźne skonfigurowanie klienta pod kątem filtrowania wbudowanych narzędzi zamiast udostępniania całego zestawu narzędzi.

Zakres i ograniczenia

  • Tylko do odczytu: w tej początkowej fazie narzędzia są ograniczone do operacji tylko do odczytu i narzędzi do zapisu o niskim ryzyku (np. tworzenia źródła danych).

Dostępne możliwości

Za pomocą serwera MCP danych sprzedawcy możesz wykonywać te działania w sposób agentowy:

  • Pobieranie szczegółowych informacji o stanie i raportów dotyczących konkretnych produktów za pomocą dokładnych nazw zasobów.
  • Wyświetlanie listy i wyszukiwanie wielu produktów.
  • Dane o skuteczności zapytań, stany produktów i statystyki dotyczące cen w raportach wyszukiwania.
  • Wyświetlanie, tworzenie, pobieranie i sprawdzanie stanu przesyłania źródeł danych.
  • Identyfikuj problemy na poziomie konta, które wpływają na widoczność produktów lub udział w programie.
  • Wyświetlaj zbiorcze powody odrzucenia produktów w całym asortymencie.
  • Sprawdź aktywne regiony, niespełnione wymagania i stan uczestnictwa w poszczególnych programach Merchant Center.
  • Sprawdź ustawienia automatycznego poprawiania w przypadku produktów, zdjęć i dostawy.

Konfiguracja

Aby połączyć IDE lub asystenta kodowania z serwerem MCP danych sprzedawcy, zaktualizuj ustawienia klienta MCP. Na przykład zaktualizuj plik mcp.json w przypadku Claude Desktop, Antigravity, Visual Studio Code lub niestandardowej platformy agenta.

Konfiguracja lokalnego serwera MCP wymaga konta usługi. Użytkownik standardowy OAuth nie jest obsługiwany w przypadku tego lokalnego wykonania bez interfejsu. Musisz utworzyć konto usługi, pobrać plik JSON z kluczem prywatnym i podać ścieżkę do niego wraz z konkretnym identyfikatorem w Merchant Center jako argumenty.

Szczegółowe instrukcje tworzenia i pobierania konta usługi znajdziesz w przewodniku po kontach usługi.

Konfiguracja klienta

Konfiguracje:

Antigravity

Postępuj zgodnie z instrukcjami w dokumentacji Antigravity.

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

Claude Desktop

Postępuj zgodnie z instrukcjami w dokumentacji Claude Desktop.

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

Przykładowe scenariusze użycia

Serwer MCP danych sprzedawcy umożliwia agentowi interakcję z aktualnymi danymi Merchant Center. Poniżej przedstawiono kilka najczęstszych sytuacji:

Scenariusz 1. Diagnozowanie odrzuceń produktów

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

Prompt użytkownika:

„Dlaczego mój produkt z identyfikatorem oferty „offer123” został odrzucony?”

Zachowanie pracownika obsługi klienta w przypadku MCP:

  1. Agent wywołuje funkcję 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. Agent analizuje problemy i wyjaśnia ich przyczynę, a także sugeruje, jak je rozwiązać (np. aktualizując informacje o cenie).

Scenariusz 2. Sprawdzanie automatycznych poprawek

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

Prompt użytkownika:

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

Zachowanie pracownika obsługi klienta 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. Dane dotyczące skuteczności zapytań

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

Prompt użytkownika:

„Pokaż mi 5 produktów, które w zeszłym tygodniu uzyskały najwięcej kliknięć”.

Zachowanie pracownika obsługi klienta w przypadku MCP:

  1. Agent tworzy zapytanie w języku zapytań Merchant Center (MCQL) kierowane na tabelę product_performance_view, sortowane 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 formatuje wyniki w postaci czytelnej tabeli Markdown.

Szczegółowa lista dostępnych narzędzi

Serwer MCP udostępnia agentowi te narzędzia:

Narzędzie MCP Opis
get_product_by_name Pobierz 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.
report_search Wysyłaj zapytania do tabel raportowania, aby pobierać wskaźniki skuteczności, stany produktów i statystyki dotyczące cen. Więcej informacji znajdziesz w przewodniku po raportach.
list_data_sources Wyświetla listę źródeł danych dla danego sprzedawcy.
get_data_source Pobieranie szczegółów konkretnego źródła danych.
create_data_source Utwórz ź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świetla listę 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świetl programy dla danego sprzedawcy, w tym stan uczestnictwa, aktywne regiony i wszelkie niespełnione wymagania.
list_aggregated_product_issues 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.