Shopify Katalogunuzu Insanlar Icin Olusturdunuz. Simdi Ajansal Tarayıcılar Icin de Calısması Gerekiyor.
Published: March 23, 2026
Shopify'ın Catalog MCP ve Catalog API ile Calısmaya Baslamak Icin En Iyi Rehber
Tez
Shopify urun katalogunuz temelden farklı iki kitle tarafından okunuyor: magazanızı gezen insanlar ve baskası adına oneri yapmak icin urun verilerinizi programatik olarak sorgulayan yapay zeka ajanları.
Cogu marka yıllardır ilk kitle icin optimizasyon yapıyor. Zengin urun acıklamaları, yasam tarzı fotografları, donusum odaklı PDP’ler. Bunların hicbiri ikinci kitleye pek yardımcı olmuyor.
Bu yazi, gercek bir urun olan Glossier’in Full Orbit goz kremi uzerinden acıgın pratikte nasıl gorunduğunu ve ajansal ticaret hakkında dusunen markalar icin ne anlama geldigini gosteriyor.
Cogu Markanın Henuz Fark Etmedigi Altyapı Katmanı
Shopify, Shopify platformundaki ajansal ticaret icin birincil urun kesif altyapısı olarak hizmet veren bir Model Context Protocol sunucusu olan Catalog MCP‘yi olusturdu. Yapay zeka ajanlarının urunleri nasıl buldugu, degerlendirdigi ve islem yaptıgına dair bir standart olan Universal Commerce Protocol (UCP) uzerine insa edilmistir.
Catalog MCP, Shopify’ın Catalog REST API’sini sarar ve UCP standardına uygun olusturulan herhangi bir ajana su imkanları tanır:
- Arama: Anahtar kelime, fiyat aralıgı ve gonderim konumuna gore tum uygun Shopify urunlerinde arama yapma
- Sorgulama: Belirli urunlerin acıklamalar, ozellikler, teknik ozellikler ve odeme URL’leri dahil tam varyant detaylarını getirme
Uygun Shopify satıcıları zaten bu katalogda yer alıyor. Soru, urunlerinizin sorgulanıp sorgulanmadıgı degil. Ajanların onları sorguladıgında ne buldugudur.
Agentic storefronts
Your active products are automatically discoverable.
Review how your product data is sent to the Shopify Catalog for agentic storefronts
Shopify yonetici panelindeki Agentic storefronts goruntuleme ekranı: ChatGPT ve Microsoft Copilot baglanan ilk iki yapay zeka yuzeyidir.
ChatGPT
Free
By selling on this sales channel, you agree to Agentic Storefronts Supplemental Terms
Checkout
Products
Publishing
Shopify catalog is used to send product data to this sales channel
ChatGPT’ye tıklandıgında satıs kanalı detayı gosterilir: odeme magazanızda kalır ve urun verileri Shopify Katalogu uzerinden akar.
Her iki ekran da Shopify yonetici panelinde Ayarlar > Satıs kanalları bolumunde bulunur.
Bir ajanın katalogunuza ulasmak icin izleyebilecegi uc yol vardır:
| Yol | Kapsam | Kimlik Dogrulama Gerekli mi |
|---|---|---|
| Catalog MCP | Kuresel olarak tum uygun Shopify satıcıları | Evet (JWT) |
| Storefront MCP | Yalnızca tek satıcı magazası | Hayır |
| Catalog REST API | Kuresel olarak tum uygun Shopify satıcıları | Evet |
Shopify, Catalog MCP’yi cogu ajansal ticaret uygulaması icin onerilen yol olarak tanımlar.
Iki Uc Nokta. Iki Cok Farklı Tablo.
Bir yapay zeka ajanı Shopify magazanızdaki bir urun hakkında bilgi edinmek istediginde, verilerinize iki ana yoldan ulasabilir. Eski yol, herkese acık /products.json uc noktasıdır. Kimlik dogrulama gerektirmez, JSON olarak yapılandırılmıstır ve botların ve kazıyıcıların yıllardır Shopify kataloglarını okudugu varsayılan yontemdir. Modern yol ise ajansal tuketim icin ozel olarak tasarlanmıs Catalog MCP ve Catalog API’dir.
Iste Glossier Full Orbit icin her iki uc noktadan dogrudan cekilen tam yan yana karsilastırma:
| Alan | /products.json |
Catalog API | Catalog API Alan Durumu |
|---|---|---|---|
| Urun Kimlik No | 8185258410229 | gid://shopify/p/5vhkcE78u4c7P2hhO30zEh | Gerekli |
| Baslik | Full Orbit | Full Orbit | Gerekli |
| Satıcı | Glossier | Glossier | Gerekli |
| Acıklama | 4.000 karakter HTML blok | “A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.” (98 karakter) | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| Benzersiz Satıs Noktası | Mevcut degil | “Combines brightening, hydrating, and smoothing effects in one tube-packaged eye cream.” | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| En Iyi Ozellik 1 | Mevcut degil | Brightening formula reduces the appearance of dark circles for a more awake look | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| En Iyi Ozellik 2 | Mevcut degil | Hydrating ingredients keep the under-eye area moisturized and comfortable | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| En Iyi Ozellik 3 | Mevcut degil | Smoothing action helps minimize fine lines for a youthful appearance | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| En Iyi Ozellik 4 | Mevcut degil | Depuffing effect soothes and refreshes tired eyes | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| En Iyi Ozellik 5 | Mevcut degil | Tube dispenser allows for easy, mess-free application | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| Teknik Ozellik: Dispenser Type | Mevcut degil | Tube | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| Teknik Ozellik: Product Form | Mevcut degil | Cream | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| Teknik Ozellik: Skin Care Effects | Mevcut degil | Brightening, Hydrating, Smoothing, Anti-dark circle, Anti-puffiness | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| Teknik Ozellik: Brand | Mevcut degil | Glossier | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| Secondhand | Mevcut degil | False | Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) |
| Varyant Acıklaması | Mevcut degil | 2.312 karakter duz metin (HTML sıyrılmıs) | Istege baglı |
| Fiyat | $28.00 | $28.00 USD | Gerekli |
| Satısa Uygun | Mevcut degil | True | Gerekli |
| Odeme URL’si | Mevcut degil | Dogrudan varyant odeme URL’si | Gerekli |
| Varyant URL’si | Mevcut degil | Varyant parametresi ile urun sayfası URL’si | Gerekli |
| Degerlendirme | Mevcut degil | Mevcut degil | Istege baglı |
| Gorsel Sayısı | 10 | 10 | Gerekli |
| SKU | FOE-000-00-00 | Mevcut degil | — |
| Barkod | 810086254095 | Mevcut degil | — |
| Etiketler | 11 dahili etiket (bfcm-eligible, pricing_export, vb.) | Mevcut degil | — |
| Urun Tipi | Skincare | Mevcut degil | — |
Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok), Shopify’ın yapay zekasının degeri urettigi anlamına gelir. Satıcıların bu alanları bildirme veya gecersiz kılma icin dogrudan bir mekanizması yoktur. Gerekli alanlar, satıcı veya platform tarafından kontrol edilir ve mevcut olması garanti edilir. Istege baglı alanlar mevcut oldugunda bulunur. — ile isaretlenen alanlar yalnızca /products.json‘da mevcuttur ve Catalog API’de karsılıgı yoktur.
/products.json uc noktası bir ajana dahili lojistik alanları ile birlikte bir HTML duvarı sunar. Catalog API ise dahili etiketlerden arındırılmıs ve bir ajanın oneri yapıp satın alma islemini tamamlaması icin ihtiyac duydugu seylere odaklanmıs yapılandırılmıs bir brifing sunar.
“Koyu halkalar icin iyi bir hafif goz kremi hangisi” sorusunu yanıtlamaya calısan bir ajan, elinde yalnızca ham HTML oldugunda cok daha fazla caba harcamak zorunda kalır. Sonucların gercek konumlandırmanızı kaçırma olasılıgı daha yuksektir.
HTML Acıklama Bir Ajan Icin Gercekte Nasıl Gorunuyor
Full Orbit HTML acıklaması, /products.json‘da gozuktugu sekliyle su sekilde baslar:
<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...
Bir ajan tek bir faydali cumle cikarabilmesi icin CSS sınıf adlarını, span etiketlerini, satır ici karakter seti bildirimlerini ve ° ve â gibi bozuk kodlama kalıntılarını sıyırmak zorundadır. Klinik calisma verileri, urun iddiaları ile birlikte satır icinde gomulıdur. Icerik callout’ları, pazarlama metniyle karısık liste ogelerinde yer alır.
Bunu Catalog API’nin kısa acıklama olarak dondurdugu ile karsilastırın:
“A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.”
Bu 98 karakter. Dogrudan, duz metin ve anında ayrıstırılabilir. Bir ajan bunu herhangi bir isleme gerek kalmadan bir oneride kullanabilir.
Acık yalnızca uzunlukla ilgili degil. Sinyal yogunlugu ile ilgili. Catalog API acıklaması bir ajana urunun tam olarak ne yaptıgını soyler. HTML acıklaması ajanı tahmin etmeye zorlar.
“Inferred Alanlar” Sorunu: Shopify’ın Yapay Zekası Urun Metninizi Yazdıgında
Cogu markanın henuz hesaplasmadıgı kısım burada.
Shopify’ın Catalog API’si referans belgelerinde belirli alanları “Inferred” etiketiyle isaretler. Bunlar, bir satıcı bunları acıkca saglamadıgında Shopify’ın yapay zekasının otomatik olarak urettigi alanlardır. Belgeler, Inferred alanların her zaman mevcut olmayabilecegini ve dogrulugun mevcut urun verilerine baglı olarak degistigini belirtir.
Search ve Lookup uc noktaları genelinde Inferred olarak isaretlenen alanlar sunlardır:
| Alan | Uc Nokta | Tanım |
|---|---|---|
description |
Search + Lookup | Detaylı urun acıklaması |
uniqueSellingPoint |
Search + Lookup | Ayırt edici deger onerisi |
topFeatures |
Search + Lookup | En iyi urun ozelliklerinin dizisi |
techSpecs |
Search + Lookup | Teknik ozelliklerin dizisi |
options |
Search + Lookup | Urun seceneklerinin/varyantlarının dizisi |
attributes |
Search | Ad-deger ciftleri olarak urun ozellikleri |
secondhand |
Search + Lookup | Varyantın ikinci el olup olmadıgı |
Karsilastırma olarak, Shopify’ın Gerekli olarak isaretledigi alanlar islemsel olanlardır: price, availableForSale, checkoutUrl, variantUrl, shop. Shopify islem katmanına sahiptir. Acıklama katmanı sizin doldurmanız icindir, yoksa Shopify’ın yapay zekası devreye girer.
Ajan onerileri icin en onemli alanlar, yani description, uniqueSellingPoint, topFeatures ve techSpecs, tamamen yapay zeka tarafından uretilmistir ve satıcı gecersiz kılma mekanizması yoktur.
Markanız bu alanlar icin temiz, yapılandırılmıs degerler saglamadıysa, urunlerinizin ajanlara sunulan surumu Shopify’ın yapay zekası tarafından yazılıyor. Sizin tarafınızdan degil.
Karsilastırmamızdaki Full Orbit Catalog API verileri aslında tum bu alanların doldurulmus oldugunu gosteriyor. Degerlere bakıldıgında, farklı kokenler gosterenler iki gruba ayrılıyor.
Bazıları, Glossier’in dogrudan saglamıs olabilecegi yapılandırılmıs urun verileri gibi gorunuyor:
secondhand: False, bir ikili bayrak, acıklamadan uretilecek bir sey degiltechSpecs: Brand: Glossier, temel urun meta verisitechSpecs: Dispenser Type: Tube, fiziksel bir urun ozelligitechSpecs: Product Form: Cream, bir urun kategori ozelligi
Digerleri ise HTML acıklamasından uretilmis metin gibi okunuyor:
uniqueSellingPoint: "Combines brightening, hydrating, and smoothing effects in one tube-packaged eye cream.", sentezlenmis bir cumle, standart bir urun alanı degiltopFeatures, HTML acıklamasındaki dili yakından yansıtan ancak ayrık satırlara yeniden yapılandırılmıs bes fayda ifadesidescription: "A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.", HTML acıklama paragrafının sıkıstırılmıs duz metin surumu
Bu desen, teknik ozelliklerin ve ikili bayrakların Shopify’ın urun taksonomisinden ve standart urun alanlarından gelebilecegini, metin agırlıklı alanların (USP, en iyi ozellikler, kısa acıklama) ise buyuk olasılıkla urun acıklamasından uretildigini gosteriyor. Hicbiri dogrulanmıs degil, gercek girdi mekanizmasını yalnızca Glossier ve Shopify biliyor. Ancak veriler bu ayrımla tutarlı.
Her durumda, Full Orbit cıktısı bir ajan icin tutarlı ve kullanıslı. Risk, kaynak materyalin daha ince oldugu urunlerdedir. Su durumlarda ne oldugunu dusunun:
- HTML acıklamasının cogunlukla az spesifikle pazarlama dili oldugu bir urun
- Acıklamanın henuz tam olarak gelistirilmedigi yeni bir urun
- Eski metnin hala canlı oldugu yeniden formulize edilmis bir urun
- Konumlandırmanızın ince oldugu ve dogru iletim icin baglam gerektirdigi bir urun
Bu durumların her birinde, yapay zeka tarafından cikarılan bir acıklama konuyu tamamen kaciracaktır. Bu, ajanların urunlerinizi baskasına onerirken kullandıgı acıklamadır.
Inferred alan degerlerini ajanlara sunulmadan once inceleme sansınız yok. Ajanların dogru, marka kontrolundeki acıklamalardan calıstıgından emin olmanın tek yolu, alanları kendiniz doldurmaktır.
Ajanlar Urunlerinizi Gercekte Nasıl Buluyor: Arama, Sonra Sorgulama
Catalog MCP is akısı, katalog verilerinizin nasıl kullanıldıgı uzerinde dogrudan etkileri olan iki adımlı bir deseni takip eder.
Adım 1: Arama. Bir ajan, “30 doların altında koyu halkalar icin hafif bir goz kremi bul” gibi bir kullanıcı isteğini Katalog uzerinde bir arama sorgusuna donusturur. Sonuclar, aynı urun birden fazla satıcı tarafından satıldıgında kopyaları onleyen Universal Product ID (UPID) ile kumelenir. Her arama sonucu sunları icerir:
- Urun baslıgı ve acıklaması
- Tum satıcılar genelinde fiyat aralıgı
- Mevcut secenekler (beden, renk tonu, vb.)
- Belirli fiyatları ve odeme URL’leri ile satıcıların listesi
Adım 2: Sorgulama. Arama sonucundaki UPID’yi kullanarak ajan, belirli urun icin tam acıklamalar, temel ozellikler, teknik ozellikler, tum varyant duzeyi fiyatlandırma ve her satıcının teklifi icin odeme URL’leri dahil kapsamlı varyant detaylarını getirir.
UPID kumelemenin etkisi uzerinde durmaya deger. Urunuunuz aynı SKU olarak birden fazla Shopify satıcısı tarafından satılıyorsa (toptan, yetkili bayiler veya pazar yeri duzenleri aracılıgıyla), bu teklifler fiyat karsilastırmasıyla birlikte tek bir kumelenmis sonucta sunulur. Ajan (ve kullanıcı) mevcut tum fiyatları bir kerede gorebilir. Katalog kalitesi yalnızca urunuunuzun gorunup gorunmedigini degil, aynı urunu birden fazla satıcı sattıgında teklifinizin secilip secilmedigini de etkiler.
Ajanlar Alıcı Haline Geldikce Bunun Onemi
Su anda yasanan degisim, yapay zeka ajanlarının arastırma asistanlarından islem katılımcılarına dogru ilerlemesidir. Alısveris ajanları yalnızca bilgi sunmuyor. Catalog API’nin dondurdugu tur varyant duzeyi odeme URL’lerini kullanarak giderek artan bir sekilde satın alma islemleri baslatabiliyorlar.
Bir ajan sepete urun ekleyebildiginde veya odeme baglantısı urebildiginde, urunuunuz hakkındaki verilerin kalitesi, urunuunuzun onerilip onerilmedigini ve onerinin dogru olup olmadıgını dogrudan etkiler.
Uc sey tehlikede:
Kesfedilebilirlik. Bir ajan urunuunuzun ne yaptıgını ve kimin icin oldugunu guvenle ayrıstıramıyorsa, ilgili sorgulara yanıt olarak sunmaz. Temiz, yapılandırılmıs alanlar ajanlara oneri yapma guvenini verir.
Dogruluk. HTML’den calısan bir ajan, cıkarabildigine dayanarak urunuunuzun kendi ozetini uretebilir. Bu ozet onemli iddiaları atlayabilir, kullanım senaryosunu yanlıs nitelendirebilir veya klinik olarak dogrulanmıs verileri tamamen dusurur. Ajanın urunuunuz hakkında ne soyledigini kontrol edemezsiniz, ancak ajanın calısmak zorunda oldugu girdileri kontrol edersiniz.
Donusum. Catalog API her varyant icin dogrudan odeme URL’si icerir. Islem kapasitesine sahip ajanlar tam olarak buna ihtiyac duyar: oneriden satın almaya giden makine tarafından okunabilir bir yol. Bu alan doldurulmamıs ve dogru degilse, donusum yolu daha baslamadan kırılır.
Ajan Kararlarını Yonlendiren Alanlar
Tum katalog alanları ajansal uc noktalar icin esit agırlık tasımaz. Yapay zeka ajanlarının urun verilerini nasıl isleyip sıraladıgına dayanarak, en onemli olanlar sunlardır:
| Alan | API Alan Adı | Durum | Neden Onemli |
|---|---|---|---|
| Kısa acıklama | description |
Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) | Sorgu eslestirme ve oneri metni icin birincil sinyal |
| Benzersiz satıs noktası | uniqueSellingPoint |
Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) | Urunuunuzu karsilastırma baglamında farklılastırır |
| En iyi ozellikler | topFeatures |
Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) | “Koyu halkalar icin en iyisi” gibi kullanıcı niyet sorgularıyla eslesir |
| Teknik ozellikler | techSpecs |
Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) | Format, icerik veya dagıtıcı tipine gore filtrelemeyi saglar |
| Urun ozellikleri | attributes |
Yapay zeka tarafından uretilmis (satıcı gecersiz kılması yok) | Yapılandırılmıs filtreleme icin kullanılan ad-deger ciftleri |
| Satısa uygun | availableForSale |
Gerekli | Ajanlar stokta olmayan urunleri oncelikten dusurur veya atlar |
| Odeme URL’si | checkoutUrl |
Gerekli | Herhangi bir islemsel ajan yetenegı icin gerekli |
| Varyant URL’si | variantUrl |
Gerekli | Yerel odeme mevcut olmadıgında yedek yol |
Inferred alanlar, urunuunuzun ne oldugunu ve birinin neden satın alması gerektigini tanımlayanlardır. Gerekli alanlar ise islemi tamamlayanlardır. Shopify ikinci grubu garanti eder. Birinci grup sizin sorumlulugunuzdur.
Katalogunuzda Bugun Denetlemeniz Gerekenler
Shopify katalogu yoneten bir marka sahibiyseniz, yapay zeka ajanları trafiginizin daha buyuk bir payını olusturmadan ve islemsel yapay zeka norm haline gelmeden once simdi kontrol etmeye deger birkac spesifik sey var.
Kısa acıklamanızı kontrol edin. Her urunun, urunun ne yaptıgıyla baslayan ozlu, duz metin bir ozeti var mı? Sloganınız degil. Pazarlama kancanız degil. Bir ajanın urunu kullanıcının istegine eslestirmek icin kullanabilecegi islevsel bir acıklama.
Ozellik alanlarınızı kontrol edin. Shopify’da yerel olarak veya bir metafield ya da Catalog API beslemesi aracılıgıyla ayrık en iyi ozellik alanları dolduruyor musunuz? Tum urun bilgileriniz tek bir HTML acıklama blogunda yasıyorsa, ajanlara calısılacak farklılastırılmamıs bir yıgın veriyorsunuz demektir.
Stok durumu verilerinizi kontrol edin. Hala satılabilir olarak gorunen stokta olmayan urunler oneri hataları olusturur. Kullanıcıların satın alamayacagı urunleri oneren ajanlar, hem ajana hem de markanıza olan guveni zedeler.
Odeme URL’lerinizi kontrol edin. Herhangi bir alısveris beslemesi veya yapay zeka ticaret platformuyla entegreyseniz, varyant duzeyi odeme URL’lerinin dogru bir sekilde dolduruldugunu dogrulayın. Kırık veya genel bir odeme baglantısı donusum yolunu tamamen kırar.
Varyant acıklamalarınızı kontrol edin. Urun sayfalarında genellikle varyant duzeyine tasınmayan detaylı acıklamalar bulunur. Birden fazla SKU’su olan urunler icin, ajanlar varyant duzeyinde sorgulama yapabilir ve bos alanlarla karsılasabilir.
Inferred alanlarınızı kontrol edin. Shopify Catalog MCP, satıcıların acıkca doldurmadıgı alanları “Inferred” olarak isaretler. Ajanların en fazla agırlık verdigi alanlar (kısa acıklama, benzersiz satıs noktası, en iyi ozellikler) icin, markanızın yapay zeka cikarımına bırakmak yerine acık degerler sagladıgını dogrulayın. Inferred degerleri ajanlara sunulmadan once inceleme veya duzeltme mekanizması yoktur.
Catalog Mapping kaynaklarınızı kontrol edin. Agentic Plan’dayseniz, Shopify Catalog Mapping (Ayarlar > Shopify Catalog Mapping) uc temel alanın kaynagını varsayılan urun ozelliginden bir metafield veya metaobject’e yonlendirmenize olanak tanır. Bunlar, makine ogrenimi cikarım hattını besleyen girdilerdir.
Product fields
Change the sources for standard fields on the Shopify Catalog
Shopify Catalog Mapping (Ayarlar > Shopify Catalog Mapping). Her kaynak bir metafield veya metaobject’e yonlendirilebilir. Bu, makine ogrenimi hattına neyin girdigini kontrol eder, hattın ne urettigini degil.
Daha Genis Degisim: Altyapı Olarak Katalog
Shopify doneminin buyuk bolumunde urun katalogu satıs materyaliydi, yani magazanızı gezen insanlar icin yazdıgınız icerikti. PDP son noktaydı.
Bu model degisiyor. Katalogunuz artık birden fazla tuketicinin okudugu bir altyapıdır: magazanızdaki insanlar, arama motoru tarayıcıları, fiyat karsilastırma motorları ve giderek artan bir sekilde kullanıcılar adına oneriler yapan ve satın almalar gerceklestiren yapay zeka ajanları.
Katalog kalitesine simdi yatırım yapan markalar (yapılandırılmıs alanlar, temiz metin, eksiksiz meta veri), ajansal ticaret olceklendikce birikimli bir avantaja sahip olacak. Yapmayanlar ise urunlerinin hatalı ozetlenmesini, verileri ayrıstıramayan ajanlar tarafından oncelikten dusurulmesini veya onerilerden tamamen eksik kalmasını yasamaya baslayacak.
Glossier ornegi, Glossier’in yanlıs bir sey yapmıs olması nedeniyle ogretici degil. HTML acıklamaları zengin, detaylı ve acıkca insan okuyucular icin yazılmıs. Ogretici cunku insan okuma icin yazılmıs icerik ile ajan tuketimi icin yapılandırılmıs verinin iki farklı sey oldugunu gosteriyor. Ikisi de artık onemli.
Shopify Belgeleri Referansı
Asagıdaki Shopify gelistirici belgeleri sayfaları, bu makaledeki Catalog MCP ve Catalog API bilgilerinin birincil kaynaklarıdır.
Katalog genel bakıs
- About Shopify Catalog: Catalog MCP, Storefront MCP ve Catalog REST API’ye genel bakıs, Inferred alanların tanımı dahil
- Universal Commerce Protocol (UCP): Catalog MCP’nin uzerine insa edildigi standart
MCP referansları
- Catalog MCP reference:
search_global_productsveget_global_product_detailsicin araclar, parametreler ve yanıt semaları - Storefront MCP reference: Catalog MCP’ye tek magaza kapsamlı alternatif
Catalog REST API referansları
- Catalog REST API overview: Kimlik dogrulama, hız sınırları ve uc nokta dizini
- Search endpoint: Hangi alanların Inferred olarak isaretlendigini iceren Search sonucları icin tam alan seması
- Lookup endpoint: Hangi alanların Inferred olarak isaretlendigini iceren urun detay yanıtları icin tam alan seması
- Lookup by variant: Varyant duzeyi sorgulama seması
- Bulk lookup: Toplu urun detay getirme
Sıkca Sorulan Sorular
Ajansal ticaret nedir?
Ajansal ticaret, kullanıcılar adına otonom olarak arastıran, karsilastıran ve urun oneren, giderek artan bir sekilde satın alma islemlerini de tamamlayan yapay zeka ajanlarını ifade eder.
- Alısveris ajanları urun verilerini programatik olarak okur, magazayı gezerek degil
- Acıklamalar, ozellikler ve teknik ozellikler gibi yapılandırılmıs alanlara dayalı oneriler uretirler
- Islemsel ajanlar, varyant duzeyi odeme URL’leri kullanarak odeme baslatabilir
- Urun verilerinizin kalitesi, urunlerinizin onerilip onerilmedigini dogrudan etkiler
Yapay zeka alısveris ajanları bir Shopify katalogunu nasıl okur?
Shopify’ın Catalog MCP’si, ajansal ticaret icin birincil yoldur. Arama, ardindan Sorgulama akısını takip eder.
- Catalog MCP: Onerilen yol. Kuresel olarak tum uygun Shopify satıcılarında arama yapar; JWT kimlik dogrulaması gerektirir
- Catalog REST API: MCP ile aynı veriler, dogrudan sorgulanabilir
- Storefront MCP: Tek magazayla sınırlı; kimlik dogrulaması gerekmez; tek marka ajanları icin kullanıslı
/products.json: Eski herkese acık uc nokta; ham HTML dondurur; yapılandırılmıs ozellikler veya odeme URL’leri yok- Catalog MCP kullanan ajanlar iki adımlı bir akıs izler: UPID’leri almak icin anahtar kelime/tercih ile Arama, ardından tam varyant detaylarını getirmek icin UPID ile Sorgulama
Yapay zeka ajanları icin hangi urun alanları en onemlidir?
Ajansal uc noktalar icin en yuksek sinyal tasiyan alanlar, ajanların urunleri kullanıcı niyetiyle eslestirme bicimini dogrudan yansıtanlardır.
- Kısa duz metin acıklaması (Full Orbit ornegi 98 karakter)
- Benzersiz satıs noktası
- Ayrık en iyi ozellikler
- Yapılandırılmıs teknik ozellikler
- Stok durumu
- Varyant duzeyi odeme URL’si
Urun acıklamalarımın HTML ile yazılmıs olması onemli mi?
Evet. HTML isaretlemesi, ajanların islemeden once sıyırması gereken gurultu ekler.
- CSS sınıfları ve satır ici etiketler iceren 4.000 karakterlik bir HTML acıklama, 100 karakterlik duz metin ozetten cok daha zor ayrıstırılır
- Catalog API HTML’yi sıyırır ancak isaretleme kaldırıldıgında anlamsal olarak belirsiz olan acıklamaları duzelteyemez
- Gorsel sunum icin yazılmıs acıklamalar duz metin olarak islendiginde etkili olmayabilir
- En iyi acıklamalar hem insan hem de makine okuma baglamlarında net ve taranabilirdir