Zbudowales katalog Shopify dla ludzi. Teraz musi tez dzialac dla agentowych crawlerow.

Najlepszy przewodnik po pracy z Catalog MCP i Catalog API Shopify

Teza

Twoj katalog produktow Shopify jest czytany przez dwa zasadniczo rozne audytoria: ludzi, ktorzy przegladaja Twoj sklep, i agentow AI, ktorzy odpytuja Twoje dane produktowe programistycznie, aby tworzyc rekomendacje w czyims imieniu.

Wiekszosc marek spedzila lata na optymalizacji pod pierwsze audytorium. Bogate opisy produktow, lifestyle’owa fotografia, PDP zoptymalizowane pod konwersje. Nic z tego specjalnie nie pomaga drugiemu audytorium.

Ten artykul wykorzystuje prawdziwy produkt, krem pod oczy Full Orbit od Glossier, aby pokazac, jak ta luka wyglada w praktyce i co oznacza dla marek myslacych o agentowym e-commerce.

---

Warstwa infrastruktury, ktorej wiekszosc marek jeszcze nie zauwazyla

Shopify zbudowal Catalog MCP, serwer Model Context Protocol, ktory sluzy jako glowna infrastruktura odkrywania produktow dla agentowego e-commerce na platformie Shopify. Jest zbudowany wokol Universal Commerce Protocol (UCP), standardu okreslajacego, jak agenci AI znajduja, oceniaja i dokonuja transakcji z produktami.

Catalog MCP opakowuje Catalog REST API Shopify i daje kazdemu agentowi zbudowanemu zgodnie ze standardem UCP mozliwosc:

1. Wyszukiwania wsrod wszystkich kwalifikujacych sie produktow Shopify na podstawie slow kluczowych, zakresu cenowego i lokalizacji wysylki
2. Sprawdzenia pelnych szczegolow wariantu dla konkretnych produktow, w tym opisow, cech, specyfikacji i URL-i do kasy

Kwalifikujacy sie sprzedawcy Shopify sa juz w tym katalogu. Pytanie nie brzmi, czy Twoje produkty sa odpytywane. Pytanie brzmi, co agenci znajduja, gdy je odpytuja.

Widok Agentic storefronts w panelu Shopify: ChatGPT i Microsoft Copilot to pierwsze dwa polaczone interfejsy AI.

Po kliknieciu ChatGPT widac szczegoly kanalu sprzedazy: kasa pozostaje na Twoim sklepie, a dane produktowe przeplywaja przez katalog Shopify.

Oba ekrany znajduja sie w Settings > Sales channels w panelu administratora Shopify.

Istnieja trzy sciezki, ktorymi agent moze dotrzec do Twojego katalogu:

Sciezka	Zakres	Wymagana autoryzacja
Catalog MCP	Wszyscy kwalifikujacy sie sprzedawcy Shopify globalnie	Tak (JWT)
Storefront MCP	Tylko pojedynczy sklep	Nie
Catalog REST API	Wszyscy kwalifikujacy sie sprzedawcy Shopify globalnie	Tak

Shopify opisuje Catalog MCP jako zalecana sciezke dla wiekszosci implementacji agentowego e-commerce.

---

Dwa endpointy. Dwa bardzo rozne obrazy.

Gdy agent AI chce dowiedziec sie o produkcie w Twoim sklepie Shopify, ma dwie glowne sciezki do Twoich danych. Tradycyjna sciezka to publiczny endpoint /products.json. Jest dostepny bez uwierzytelnienia, strukturalnie jako JSON i jest domyslnym sposobem, w jaki boty i scrapery czytaly katalogi Shopify od lat. Nowoczesna sciezka to Catalog MCP i Catalog API, zbudowane specjalnie do konsumpcji przez agentow.

Oto pelne porownanie dla Glossier Full Orbit, pobrane bezposrednio z obu endpointow:

Pole	/products.json	Catalog API	Status pola w Catalog API
Product ID	8185258410229	gid://shopify/p/5vhkcE78u4c7P2hhO30zEh	Wymagane
Tytul	Full Orbit	Full Orbit	Wymagane
Dostawca	Glossier	Glossier	Wymagane
Opis	Blok HTML o 4000 znakach	“A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.” (98 znakow)	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Unikalna propozycja wartosci	Brak	“Combines brightening, hydrating, and smoothing effects in one tube-packaged eye cream.”	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Najwazniejsza cecha 1	Brak	Brightening formula reduces the appearance of dark circles for a more awake look	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Najwazniejsza cecha 2	Brak	Hydrating ingredients keep the under-eye area moisturized and comfortable	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Najwazniejsza cecha 3	Brak	Smoothing action helps minimize fine lines for a youthful appearance	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Najwazniejsza cecha 4	Brak	Depuffing effect soothes and refreshes tired eyes	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Najwazniejsza cecha 5	Brak	Tube dispenser allows for easy, mess-free application	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Specyfikacja: Dispenser Type	Brak	Tube	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Specyfikacja: Product Form	Brak	Cream	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Specyfikacja: Skin Care Effects	Brak	Brightening, Hydrating, Smoothing, Anti-dark circle, Anti-puffiness	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Specyfikacja: Brand	Brak	Glossier	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Secondhand	Brak	False	Wygenerowane przez AI (brak nadpisania przez sprzedawce)
Opis wariantu	Brak	2312 znakow czystego tekstu (HTML usuniety)	Opcjonalne
Cena	$28.00	$28.00 USD	Wymagane
Dostepny do sprzedazy	Brak	True	Wymagane
URL kasy	Brak	Bezposredni URL kasy wariantu	Wymagane
URL wariantu	Brak	URL strony produktu z parametrem wariantu	Wymagane
Ocena	Brak	Brak	Opcjonalne
Liczba zdjec	10	10	Wymagane
SKU	FOE-000-00-00	Brak	—
Kod kreskowy	810086254095	Brak	—
Tagi	11 wewnetrznych tagow (bfcm-eligible, pricing_export itp.)	Brak	—
Typ produktu	Skincare	Brak	—

Wygenerowane przez AI (brak nadpisania przez sprzedawce) oznacza, ze AI Shopify generuje wartosc. Sprzedawcy nie maja bezposredniego mechanizmu deklarowania ani nadpisywania tych pol. Pola Wymagane sa kontrolowane przez sprzedawce lub platforme i gwarantowane jako obecne. Pola Opcjonalne sa obecne, gdy sa dostepne. Pola oznaczone — istnieja tylko w /products.json i nie maja odpowiednika w Catalog API.

Endpoint /products.json daje agentowi sciane HTML plus wewnetrzne pola logistyczne. Catalog API daje mu strukturalny brief pozbawiony wewnetrznych tagow i skoncentrowany na tym, czego agent potrzebuje do stworzenia rekomendacji i sfinalizowania zakupu.

Agent probujacy odpowiedziec na pytanie “jaki jest dobry lekki krem pod oczy na cienie” musi pracowac znacznie ciezej, gdy dysponuje wylacznie surowym HTML. Wyniki z wiekszym prawdopodobienstwem mina sie z Twoim rzeczywistym pozycjonowaniem.

---

Jak opis HTML wyglada z perspektywy agenta

Opis HTML Full Orbit zaczyna sie tak, dokladnie w formie, w jakiej pojawia sie w /products.json:

<p class="pv-details__info-item pv-details__tagline">
  <strong>A 360° reset for every, single eye.</strong>
</p>
<p id="description-item" class="pv-details__info-item">
  A multi-benefit, 360° eye cream that tackles the concerns
  you care about most—immediately hydrating for up to 24 hours...

Zanim agent wyciagnie chocby jedno uzyteczne zdanie, musi usunac nazwy klas CSS, tagi span, deklaracje inline charset i zepsute artefakty kodowania takie jak ° i â. Dane z badan klinicznych sa osadzone w tekscie razem z deklaracjami produktowymi. Listy skladnikow sa w elementach list zmieszane z tekstem marketingowym.

Porownaj to z tym, co Catalog API zwraca jako krotki opis:

“A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.”

To 98 znakow. Jest bezposredni, w czystym tekscie i natychmiast parsowalny. Agent moze uzyc tego w rekomendacji bez zadnego przetwarzania.

Luka nie dotyczy tylko dlugosci. Chodzi o gestosc sygnalu. Opis z Catalog API mowi agentowi dokladnie, co produkt robi. Opis HTML zmusza agenta do zgadywania.

---

Problem pol “Inferred”: gdy AI Shopify pisze opis Twojego produktu

Oto czesc, z ktora wiekszosc marek jeszcze sie nie zmierzyla.

Catalog API Shopify oznacza pewne pola etykieta “Inferred” w swojej dokumentacji referencyjnej. Sa to pola, ktore AI Shopify generuje automatycznie, gdy sprzedawca nie podal ich jawnie. Dokumentacja zaznacza, ze pola Inferred moga nie byc zawsze obecne, a dokladnosc rozni sie w zaleznosci od dostepnych danych produktowych.

Oto dokladne pola oznaczone jako Inferred w endpointach Search i Lookup:

Pole	Endpoint	Opis
description	Search + Lookup	Szczegolowy opis produktu
uniqueSellingPoint	Search + Lookup	Wyrozniajaca propozycja wartosci
topFeatures	Search + Lookup	Tablica najwazniejszych cech produktu
techSpecs	Search + Lookup	Tablica specyfikacji technicznych
options	Search + Lookup	Tablica opcji/wariantow produktu
attributes	Search	Atrybuty produktu jako pary nazwa-wartosc
secondhand	Search + Lookup	Czy wariant jest uzywany

Dla kontrastu, pola oznaczone przez Shopify jako Wymagane to pola transakcyjne: price, availableForSale, checkoutUrl, variantUrl, shop. Shopify kontroluje warstwe transakcyjna. Warstwa opisowa nalezy do Ciebie, albo AI Shopify ja uzupelnia.

Pola najwazniejsze dla rekomendacji agentow, description, uniqueSellingPoint, topFeatures i techSpecs, sa wszystkie generowane przez AI bez mechanizmu nadpisywania przez sprzedawce.

Jesli Twoja marka nie uzupelnila czystych, strukturalnych wartosci dla tych pol, wersja Twojego produktu widziana przez agentow jest pisana przez AI Shopify. Nie przez Ciebie.

Dane Full Orbit z Catalog API w naszym porownaniu faktycznie pokazuja wszystkie te pola uzupelnione. Patrzac na wartosci, mozna je podzielic na dwie grupy sugerujace rozne zrodla.

Niektore wygladaja jak dane strukturalne, ktore Glossier prawdopodobnie podal bezposrednio:

• secondhand: False, flaga binarna, nie cos, co generuje sie z opisu
• techSpecs: Brand: Glossier, podstawowe metadane produktu
• techSpecs: Dispenser Type: Tube, fizyczny atrybut produktu
• techSpecs: Product Form: Cream, atrybut kategorii produktu

Inne czyta sie jak tekst wygenerowany z opisu HTML:

• uniqueSellingPoint: "Combines brightening, hydrating, and smoothing effects in one tube-packaged eye cream.", zsyntezowane zdanie, nie standardowe pole produktu
• topFeatures, piec stwierdzen o korzysciach, ktore blisko odzwierciedlaja jezyk w opisie HTML, ale sa przeorganizowane w dyskretne linie
• description: "A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.", skompresowana wersja tekstowa otwierajacego akapitu HTML

Ten wzorzec sugeruje, ze specyfikacje techniczne i flagi binarne moga pochodzic z taksonomii produktow Shopify i standardowych pol produktowych, podczas gdy pola z tekstem (USP, najwazniejsze cechy, krotki opis) sa bardziej prawdopodobnie generowane z opisu produktu. Zaden z wariantow nie jest potwierdzony, tylko Glossier i Shopify znaja faktyczny mechanizm wprowadzania danych. Ale dane sa spojne z takim podzialem.

Tak czy inaczej, wynik Full Orbit jest spojny i uzyteczny dla agenta. Ryzyko dotyczy produktow, gdzie material zrodlowy jest slabszy. Rozwazmty, co sie stanie z:

• Produktem, ktorego opis HTML to glownie jezyk marketingowy z niewielka iloscia konkretow
• Nowym produktem, ktorego opis nie zostal jeszcze w pelni opracowany
• Przeformulowanym produktem, gdzie stary tekst jest nadal aktywny
• Produktem, ktorego pozycjonowanie jest subtelne i wymaga kontekstu do dokladnego przekazania

W kazdym z tych przypadkow opis wygenerowany przez AI moze kompletnie minac sie z celem. To jest opis, ktorego agenci uzywaja, gdy rekomenduja Twoj produkt komus.

Nie masz mozliwosci przejrzenia wartosci pol Inferred, zanim zostana podane agentom. Jedynym sposobem, aby zapewnic, ze agenci pracuja na dokladnych, kontrolowanych przez marke opisach, jest uzupelnienie pol samodzielnie.

---

Jak agenci faktycznie znajduja Twoje produkty: Search, potem Lookup

Przeplyw pracy Catalog MCP stosuje dwuetapowy wzorzec, ktory ma bezposrednie implikacje dla sposobu, w jaki dane katalogowe sa wykorzystywane.

Krok 1: Search. Agent tlumacz prompt uzytkownika, np. “znajdz mi lekki krem pod oczy na cienie ponizej 30 dolarow”, na zapytanie wyszukiwania w katalogu. Wyniki sa grupowane wedlug Universal Product ID (UPID), co zapobiega duplikatom, gdy ten sam produkt jest sprzedawany przez wielu sprzedawcow. Kazdy wynik wyszukiwania zawiera:

• Tytul i opis produktu
• Zakres cenowy wsrod wszystkich sprzedawcow
• Dostepne opcje (rozmiar, odcien itp.)
• Liste sprzedawcow z ich konkretnymi cenami i URL-ami do kasy

Krok 2: Lookup. Uzywajac UPID z wyniku wyszukiwania, agent pobiera kompletne szczegoly wariantu dla konkretnego produktu, w tym pelne opisy, kluczowe cechy, specyfikacje techniczne, wszystkie ceny na poziomie wariantu i URL-e do kasy dla oferty kazdego sprzedawcy.

Implikacja grupowania UPID jest warta zastanowienia. Jesli Twoj produkt to ta sama jednostka SKU sprzedawana przez wielu sprzedawcow Shopify (przez hurt, autoryzowanych resellerow lub uklady marketplace), te oferty sa prezentowane razem w jednym zgrupowanym wyniku, z porownaniem cen. Agent (i uzytkownik) moga zobaczyc wszystkie dostepne ceny naraz. Jakosc katalogu wplywa nie tylko na to, czy Twoj produkt sie pojawia, ale czy to Twoja oferta zostanie wybrana, gdy wielu sprzedawcow sprzedaje ten sam produkt.

---

Dlaczego to ma znaczenie, gdy agenci staja sie kupcami

Zmiana zachodzaca teraz polega na tym, ze agenci AI przechodza z roli asystentow badawczych do uczestnikow transakcji. Agenci zakupowi nie tylko wyswietlaja informacje. Coraz czesciej sa w stanie inicjowac zakupy, uzywajac dokladnie takiego URL-a kasy na poziomie wariantu, jaki zwraca Catalog API.

Gdy agent moze dodac produkt do koszyka lub wygenerowac link do kasy, jakosc danych, ktore posiada o Twoim produkcie, bezposrednio wplywa na to, czy Twoj produkt zostanie zarekomendowany, i czy rekomendacja bedzie dokladna.

Trzy rzeczy sa w grze:

Odkrywalnosc. Jesli agent nie moze z pewnoscia przeanalizowac, co robi Twoj produkt i dla kogo jest przeznaczony, nie wyswietli go w odpowiedzi na odpowiednie zapytania. Czyste, strukturalne pola daja agentom pewnosc do stworzenia rekomendacji.

Dokladnosc. Agent pracujacy z HTML moze generowac wlasne podsumowanie Twojego produktu na podstawie tego, co uda mu sie wyciagnac. To podsumowanie moze pominac kluczowe twierdzenia, blednie scharakteryzowac zastosowanie lub calkowicie porzucic klinicznie zweryfikowane dane. Nie kontrolujesz tego, co agent mowi o Twoim produkcie, ale kontrolujesz dane wejsciowe, z ktorymi pracuje.

Konwersja. Catalog API zawiera bezposredni URL kasy dla kazdego wariantu. Agenci z mozliwosciami transakcyjnymi potrzebuja dokladnie tego: czytelnej maszynowo sciezki od rekomendacji do zakupu. Jesli to pole nie jest uzupelnione i dokladne, sciezka konwersji sie lamie, zanim sie zacznie.

---

Pola, ktore kieruja decyzjami agentow

Nie wszystkie pola katalogu maja jednakowa wage dla agentowych endpointow. Na podstawie sposobu, w jaki agenci AI przetwarzaja i rankuja dane produktowe, oto pola, ktore maja najwieksze znaczenie:

Pole	Nazwa pola w API	Status	Dlaczego ma znaczenie
Krotki opis	description	Wygenerowane przez AI (brak nadpisania przez sprzedawce)	Glowny sygnal do dopasowania zapytan i tekstu rekomendacji
Unikalna propozycja wartosci	uniqueSellingPoint	Wygenerowane przez AI (brak nadpisania przez sprzedawce)	Wyroznia Twoj produkt w kontekscie porownania
Najwazniejsze cechy	topFeatures	Wygenerowane przez AI (brak nadpisania przez sprzedawce)	Mapuje sie na zapytania intencji uzytkownika, np. “najlepszy na cienie”
Specyfikacje techniczne	techSpecs	Wygenerowane przez AI (brak nadpisania przez sprzedawce)	Umozliwia filtrowanie wedlug formy, skladnika lub typu dozownika
Atrybuty produktu	attributes	Wygenerowane przez AI (brak nadpisania przez sprzedawce)	Pary nazwa-wartosc uzywane do strukturalnego filtrowania
Dostepny do sprzedazy	availableForSale	Wymagane	Agenci depriorytetyzuja lub pomijaja produkty niedostepne w magazynie
URL kasy	checkoutUrl	Wymagane	Wymagany dla kazdej transakcyjnej zdolnosci agenta
URL wariantu	variantUrl	Wymagane	Awaryjna sciezka, gdy natywna kasa nie jest dostepna

Pola Inferred to te, ktore opisuja, czym jest Twoj produkt i dlaczego ktos powinien go kupic. Pola Wymagane to te, ktore finalizuja transakcje. Shopify gwarantuje druga grupe. Pierwsza grupa to Twoja odpowiedzialnosc.

---

Co sprawdzic w swoim katalogu juz dzis

Jesli jestes wlascicielem marki zarzadzajacym katalogiem Shopify, jest kilka konkretnych rzeczy wartych sprawdzenia teraz, zanim agenci AI stana sie wieksza czescia Twojego ruchu i zanim transakcyjne AI stanie sie norma.

Sprawdz swoj krotki opis. Czy kazdy produkt ma zwiezle, czysto tekstowe podsumowanie, ktore zaczyna sie od tego, co produkt robi? Nie Twoj slogan. Nie Twoj haczyk marketingowy. Funkcjonalny opis, ktorego agent moze uzyc do dopasowania produktu do zapytania uzytkownika.

Sprawdz swoje pola cech. Czy uzupelniasz dyskretne pola najwazniejszych cech, natywnie w Shopify lub przez metapole albo feed Catalog API? Jesli wszystkie informacje o produkcie zyja w jednym bloku opisu HTML, dajesz agentom nieodroznialna mase danych do przetworzenia.

Sprawdz dane o dostepnosci. Produkty niedostepne w magazynie, ktore nadal pokazuja sie jako dostepne, tworzace bledy rekomendacji. Agenci rekomendujacy produkty, ktorych uzytkownicy nie moga kupic, podwazaja zaufanie zarowno do agenta, jak i do Twojej marki.

Sprawdz swoje URL-e do kasy. Jesli jestes zintegrowany z jakimkolwiek feedem zakupowym lub platforma AI commerce, zweryfikuj, czy URL-e kasy na poziomie wariantu sa uzupelniane dokladnie. Zepsuty lub generyczny link do kasy calkowicie lamie sciezke konwersji.

Sprawdz opisy wariantow. Strony produktowe czesto maja szczegolowe opisy, ktore nie sa przenoszone na poziom wariantu. W przypadku produktow z wieloma SKU, agenci moga odpytywac na poziomie wariantu i trafiajac na puste pola.

Sprawdz swoje pola Inferred. Shopify Catalog MCP oznacza pola jako “Inferred”, gdy sprzedawcy nie uzupelnili ich jawnie. Dla pol, ktore agenci wazna najbardziej (krotki opis, unikalna propozycja wartosci, najwazniejsze cechy), zweryfikuj, ze Twoja marka podala jawne wartosci, zamiast pozostawiac je do inferencji AI. Nie ma mechanizmu przegladania ani korekty wartosci Inferred przed ich podaniem agentom.

Sprawdz swoje zrodla Catalog Mapping. Jesli jestes na planie Agentic Plan, Shopify Catalog Mapping (Settings > Shopify Catalog Mapping) pozwala przekierowac zrodlo trzech kluczowych pol na metapole lub metaobiekt zamiast domyslnego atrybutu produktu. To sa dane wejsciowe zasilajace pipeline inferencji ML.

Shopify Catalog Mapping (Settings > Shopify Catalog Mapping). Kazde zrodlo mozna przekierowac na metapole lub metaobiekt. To kontroluje, co wchodzi do pipeline’u ML, a nie co pipeline produkuje.

---

Szersza zmiana: katalog jako infrastruktura

Przez wiekszosc ery Shopify katalog produktow byl materialem sprzedazowym, trescia pisana dla ludzi przegladajacych Twoj sklep. PDP byl punktem koncowym.

Ten model sie zmienia. Twoj katalog jest teraz infrastruktura, ktora czyta wielu roznych konsumentow: ludzie na Twoim sklepie, crawlery wyszukiwarek, porownyrki cenowe i coraz czesciej agenci AI tworzacy rekomendacje i dokonujacy zakupow w imieniu uzytkownikow.

Marki, ktore zainwestuja w jakosc katalogu teraz (strukturalne pola, czysty tekst, kompletne metadane), beda mialy kumulujaca sie przewage w miare skalowania agentowego e-commerce. Marki, ktore tego nie zrobia, odkryja, ze ich produkty sa podsumowywane niedokladnie, depriorytetyzowane przez agentow, ktorzy nie moga przeanalizowac danych, lub calkowicie nieobecne w rekomendacjach.

Przyklad Glossier jest pouczajacy nie dlatego, ze Glossier zrobil cos zle. Ich opisy HTML sa bogate, szczegolowe i wyraznie pisane dla ludzkich czytelnikow. Jest pouczajacy, poniewaz pokazuje, ze tresc pisana do ludzkiego czytania i dane strukturyzowane do konsumpcji przez agentow to dwie rozne rzeczy. Obie maja teraz znaczenie.

---

Dokumentacja referencyjna Shopify

Ponizsze strony z dokumentacji deweloperskiej Shopify sa glownymi zrodlami informacji o Catalog MCP i Catalog API w tym artykule.

Przeglad katalogu

• About Shopify Catalog, przeglad Catalog MCP, Storefront MCP i Catalog REST API, w tym definicja pol Inferred
• Universal Commerce Protocol (UCP), standard, wokol ktorego zbudowany jest Catalog MCP

Referencje MCP

• Catalog MCP reference, narzedzia, parametry i schematy odpowiedzi dla search_global_products i get_global_product_details
• Storefront MCP reference, alternatywa Catalog MCP ograniczona do jednego sklepu

Referencje Catalog REST API

• Catalog REST API overview, uwierzytelnianie, limity i indeks endpointow
• Search endpoint, pelny schemat pol dla wynikow Search, w tym ktore pola sa oznaczone jako Inferred
• Lookup endpoint, pelny schemat pol dla odpowiedzi ze szczegolami produktu, w tym ktore pola sa oznaczone jako Inferred
• Lookup by variant, schemat Lookup na poziomie wariantu
• Bulk lookup, wsadowe pobieranie szczegolow produktow

---

Czesto zadawane pytania

Czym jest agentowy e-commerce?

Agentowy e-commerce (agentic commerce) to koncepcja, w ktorej agenci AI autonomicznie wyszukuja, porownuja i rekomenduja produkty w imieniu uzytkownikow, a coraz czesciej rowniez finalizuja zakupy.

• Agenci zakupowi czytaja dane produktowe programistycznie, nie przegladajac sklepu
• Generuja rekomendacje na podstawie pol strukturalnych, takich jak opisy, cechy i specyfikacje
• Agenci transakcyjni moga inicjowac kasowania za pomoca URL-i kasy na poziomie wariantu
• Jakosc Twoich danych produktowych bezposrednio wplywa na to, czy Twoje produkty zostana zarekomendowane

Jak agenci AI do zakupow czytaja katalog Shopify?

Catalog MCP Shopify to glowna sciezka dla agentowego e-commerce. Stosuje przeplyw Search, a nastepnie Lookup.

• Catalog MCP: Zalecana sciezka. Wyszukuje wsrod wszystkich kwalifikujacych sie sprzedawcow Shopify globalnie; wymaga uwierzytelniania JWT
• Catalog REST API: Te same dane co MCP, mozliwe do bezposredniego odpytywania
• Storefront MCP: Ograniczony do jednego sklepu; nie wymaga autoryzacji; przydatny dla agentow jednej marki
• /products.json: Starsza wersja publicznego endpointu; zwraca surowy HTML; brak strukturalnych cech ani URL-i do kasy
• Agenci korzystajacy z Catalog MCP stosuja dwuetapowy przeplyw: wyszukiwanie wedlug slowa kluczowego/preferencji, aby uzyskac UPID, nastepnie Lookup wedlug UPID, aby pobrac pelne szczegoly wariantu

Ktore pola produktowe maja najwieksze znaczenie dla agentow AI?

Pola o najwyzszym sygnale dla agentowych endpointow to te, ktore bezposrednio odwzorowuja sposob dopasowywania produktow do intencji uzytkownika przez agentow.

• Krotki opis w czystym tekscie (przyklad Full Orbit to 98 znakow)
• Unikalna propozycja wartosci
• Dyskretne najwazniejsze cechy
• Strukturalne specyfikacje techniczne
• Status dostepnosci
• URL kasy na poziomie wariantu

Czy ma znaczenie, ze opisy moich produktow sa napisane w HTML?

Tak. Znaczniki HTML dodaja szum, ktory agenci musza usunac przed przetwarzaniem.

• Opis HTML o 4000 znakach z klasami CSS i tagami inline jest trudniejszy do parsowania niz czysto tekstowe podsumowanie o 100 znakach
• Catalog API usuwa HTML, ale nie moze naprawic opisow, ktore sa semantycznie niejasne po usunieciu znacznikow
• Opisy pisane pod katem prezentacji wizualnej moga nie byc skuteczne po wyrenderowaniu jako czysty tekst
• Najlepsze opisy sa jasne i czytelne zarowno w kontekscie ludzkiego, jak i maszynowego czytania