Anda Telah Membina Katalog Shopify untuk Manusia. Kini Ia Perlu Berfungsi untuk Perangkak Agentik Juga.
Published: March 23, 2026
Panduan Terbaik untuk Mula Bekerja dengan Catalog MCP dan Catalog API Shopify
Tesis
Katalog produk Shopify anda sedang dibaca oleh dua khalayak yang berbeza secara asas: manusia yang melayari kedai anda, dan ejen AI yang membuat pertanyaan data produk anda secara programatik untuk membuat cadangan bagi pihak orang lain.
Kebanyakan jenama telah menghabiskan bertahun-tahun mengoptimumkan untuk khalayak pertama. Penerangan produk yang kaya, fotografi gaya hidup, PDP yang dioptimumkan untuk penukaran. Tiada satu pun yang banyak membantu khalayak kedua.
Artikel ini menggunakan produk sebenar, krim mata Full Orbit dari Glossier, untuk menunjukkan rupa jurang tersebut dalam amalan, dan apa maknanya untuk jenama yang memikirkan perdagangan agentik.
Lapisan Infrastruktur Yang Kebanyakan Jenama Belum Perasan
Shopify telah membina Catalog MCP, pelayan Model Context Protocol yang berfungsi sebagai infrastruktur penemuan produk utama untuk perdagangan agentik pada platform Shopify. Ia dibina berdasarkan Universal Commerce Protocol (UCP), standard untuk cara ejen AI mencari, menilai, dan bertransaksi dengan produk.
Catalog MCP membungkus Catalog REST API Shopify dan memberi mana-mana ejen yang dibina mengikut standard UCP cara untuk:
- Cari merentas semua produk Shopify yang layak berdasarkan kata kunci, julat harga, dan lokasi penghantaran
- Lihat butiran varian penuh bagi produk tertentu, termasuk penerangan, ciri, spesifikasi, dan URL pembayaran
Pedagang Shopify yang layak sudah berada dalam katalog ini. Persoalannya bukan sama ada produk anda sedang dicari. Tetapi apa yang ejen jumpa apabila mereka mencarinya.
Agentic storefronts
Produk aktif anda boleh ditemui secara automatik.
Semak cara data produk anda dihantar ke Katalog Shopify untuk etalase agentik
Paparan Agentic storefronts dalam admin Shopify: ChatGPT dan Microsoft Copilot ialah dua permukaan AI pertama yang disambungkan.
ChatGPT
Percuma
Dengan menjual di saluran jualan ini, anda bersetuju dengan Terma Tambahan Etalase Agentik
Pembayaran
Produk
Penerbitan
Katalog Shopify digunakan untuk menghantar data produk ke saluran jualan ini
Mengklik ChatGPT menunjukkan butiran saluran jualan: pembayaran kekal di kedai anda dan data produk mengalir melalui Katalog Shopify.
Kedua-dua skrin ditemui dalam Tetapan > Saluran jualan dalam admin Shopify.
Terdapat tiga laluan yang boleh diambil oleh ejen untuk mencapai katalog anda:
| Laluan | Skop | Pengesahan Diperlukan |
|---|---|---|
| Catalog MCP | Semua pedagang Shopify yang layak secara global | Ya (JWT) |
| Storefront MCP | Kedai pedagang tunggal sahaja | Tidak |
| Catalog REST API | Semua pedagang Shopify yang layak secara global | Ya |
Shopify menggambarkan Catalog MCP sebagai laluan yang disyorkan untuk kebanyakan pelaksanaan perdagangan agentik.
Dua Titik Akhir. Dua Gambaran Sangat Berbeza.
Apabila ejen AI ingin tahu tentang produk di kedai Shopify anda, ia mempunyai dua laluan utama ke data anda. Laluan legasi ialah titik akhir awam /products.json. Ia boleh diakses tanpa pengesahan, distrukturkan sebagai JSON, dan merupakan cara lalai bot dan pengikis telah membaca katalog Shopify selama bertahun-tahun. Laluan moden ialah Catalog MCP dan Catalog API, dibina khas untuk penggunaan agentik.
Berikut ialah perbandingan penuh sebelah-menyebelah untuk Glossier Full Orbit, diambil terus daripada kedua-dua titik akhir:
| Medan | /products.json |
Catalog API | Status Medan Catalog API |
|---|---|---|---|
| Product ID | 8185258410229 | gid://shopify/p/5vhkcE78u4c7P2hhO30zEh | Diperlukan |
| Title | Full Orbit | Full Orbit | Diperlukan |
| Vendor | Glossier | Glossier | Diperlukan |
| Description | Blok HTML 4,000 aksara | “A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.” (98 aksara) | Dijana AI (tiada keutamaan pedagang) |
| Unique Selling Point | Tiada | “Combines brightening, hydrating, and smoothing effects in one tube-packaged eye cream.” | Dijana AI (tiada keutamaan pedagang) |
| Top Feature 1 | Tiada | Brightening formula reduces the appearance of dark circles for a more awake look | Dijana AI (tiada keutamaan pedagang) |
| Top Feature 2 | Tiada | Hydrating ingredients keep the under-eye area moisturized and comfortable | Dijana AI (tiada keutamaan pedagang) |
| Top Feature 3 | Tiada | Smoothing action helps minimize fine lines for a youthful appearance | Dijana AI (tiada keutamaan pedagang) |
| Top Feature 4 | Tiada | Depuffing effect soothes and refreshes tired eyes | Dijana AI (tiada keutamaan pedagang) |
| Top Feature 5 | Tiada | Tube dispenser allows for easy, mess-free application | Dijana AI (tiada keutamaan pedagang) |
| Tech Spec: Dispenser Type | Tiada | Tube | Dijana AI (tiada keutamaan pedagang) |
| Tech Spec: Product Form | Tiada | Cream | Dijana AI (tiada keutamaan pedagang) |
| Tech Spec: Skin Care Effects | Tiada | Brightening, Hydrating, Smoothing, Anti-dark circle, Anti-puffiness | Dijana AI (tiada keutamaan pedagang) |
| Tech Spec: Brand | Tiada | Glossier | Dijana AI (tiada keutamaan pedagang) |
| Secondhand | Tiada | False | Dijana AI (tiada keutamaan pedagang) |
| Variant Description | Tiada | Teks biasa 2,312 aksara (HTML dilucutkan) | Pilihan |
| Price | $28.00 | $28.00 USD | Diperlukan |
| Available for Sale | Tiada | True | Diperlukan |
| Checkout URL | Tiada | URL pembayaran varian terus | Diperlukan |
| Variant URL | Tiada | URL halaman produk dengan parameter varian | Diperlukan |
| Rating | Tiada | Tiada | Pilihan |
| Image Count | 10 | 10 | Diperlukan |
| SKU | FOE-000-00-00 | Tiada | — |
| Barcode | 810086254095 | Tiada | — |
| Tags | 11 tag dalaman (bfcm-eligible, pricing_export, dll.) | Tiada | — |
| Product Type | Skincare | Tiada | — |
Dijana AI (tiada keutamaan pedagang) bermakna AI Shopify menjana nilai tersebut. Pedagang tidak mempunyai mekanisme langsung untuk mengisytiharkan atau mengatasi medan ini. Medan Diperlukan dikawal oleh pedagang atau platform dan dijamin hadir. Medan Pilihan hadir apabila tersedia. Medan bertanda — hanya wujud dalam /products.json dan tidak mempunyai padanan dalam Catalog API.
Titik akhir /products.json memberi ejen satu dinding HTML bersama medan logistik dalaman. Catalog API memberinya ringkasan berstruktur yang dilucutkan daripada tag dalaman dan difokuskan pada apa yang diperlukan oleh ejen untuk membuat cadangan dan menyelesaikan pembelian.
Ejen yang cuba menjawab “apakah krim mata ringan yang baik untuk lingkaran hitam” perlu bekerja dengan jauh lebih keras apabila yang ada hanyalah HTML mentah. Hasilnya lebih berkemungkinan terlepas penempatan sebenar anda.
Rupa Sebenar Penerangan HTML kepada Ejen
Penerangan HTML Full Orbit bermula seperti ini, tepat seperti yang muncul dalam /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...
Sebelum ejen boleh mengekstrak satu ayat berguna, ia perlu melucutkan nama kelas CSS, tag span, pengisytiharan charset sebaris, dan artifak pengekodan rosak seperti ° dan â. Data kajian klinikal terbenam sebaris dengan dakwaan produk. Senarai bahan dalam item senarai bercampur dengan salinan pemasaran.
Bandingkan dengan apa yang dikembalikan oleh Catalog API sebagai penerangan ringkas:
“A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.”
Itu 98 aksara. Ia terus, teks biasa, dan boleh dihuraikan serta-merta. Ejen boleh menggunakannya dalam cadangan tanpa sebarang pemprosesan.
Jurangnya bukan sekadar tentang panjang. Ia tentang ketumpatan isyarat. Penerangan Catalog API memberitahu ejen dengan tepat apa yang dilakukan oleh produk. Penerangan HTML membuat ejen meneka.
Masalah “Inferred Fields”: Apabila AI Shopify Menulis Salinan Produk Anda
Inilah bahagian yang kebanyakan jenama belum pertimbangkan lagi.
Catalog API Shopify menandakan medan tertentu dengan label “Inferred” dalam dokumentasi rujukannya. Ini ialah medan yang AI Shopify jana secara automatik apabila pedagang tidak menyediakannya secara eksplisit. Dokumentasi menyatakan bahawa medan inferred mungkin tidak selalu hadir dan ketepatannya berbeza-beza bergantung pada data produk yang tersedia.
Berikut ialah medan tepat yang ditandakan sebagai Inferred merentas titik akhir Search dan Lookup:
| Medan | Titik Akhir | Penerangan |
|---|---|---|
description |
Search + Lookup | Penerangan produk terperinci |
uniqueSellingPoint |
Search + Lookup | Proposisi nilai yang tersendiri |
topFeatures |
Search + Lookup | Tatasusunan ciri produk utama |
techSpecs |
Search + Lookup | Tatasusunan spesifikasi teknikal |
options |
Search + Lookup | Tatasusunan pilihan/varian produk |
attributes |
Search | Atribut produk sebagai pasangan nama-nilai |
secondhand |
Search + Lookup | Sama ada varian itu terpakai |
Sebagai perbandingan, medan yang ditandakan oleh Shopify sebagai Diperlukan ialah medan transaksi: price, availableForSale, checkoutUrl, variantUrl, shop. Shopify memiliki lapisan transaksi. Lapisan penerangan adalah milik anda untuk diisi, atau AI Shopify mengisinya.
Medan yang paling penting untuk cadangan ejen, description, uniqueSellingPoint, topFeatures, dan techSpecs, semuanya dijana AI tanpa mekanisme keutamaan pedagang.
Jika jenama anda belum mengisi nilai bersih dan berstruktur untuk medan ini, versi produk anda yang menghadap ejen sedang ditulis oleh AI Shopify. Bukan oleh anda.
Data Catalog API Full Orbit dalam perbandingan kita sebenarnya menunjukkan semua medan ini diisi. Melihat nilainya, ia terbahagi kepada dua kumpulan yang mencadangkan asal usul berbeza.
Sesetengahnya kelihatan seperti data produk berstruktur yang berkemungkinan disediakan terus oleh Glossier:
secondhand: False, bendera binari, bukan sesuatu yang anda jana daripada penerangantechSpecs: Brand: Glossier, metadata produk asastechSpecs: Dispenser Type: Tube, atribut produk fizikaltechSpecs: Product Form: Cream, atribut kategori produk
Yang lain berbunyi seperti salinan yang dijana daripada penerangan HTML:
uniqueSellingPoint: "Combines brightening, hydrating, and smoothing effects in one tube-packaged eye cream.", ayat yang disintesis, bukan medan produk standardtopFeatures, lima pernyataan manfaat yang mencerminkan bahasa dalam penerangan HTML tetapi distrukturkan semula ke dalam baris diskretdescription: "A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.", versi teks biasa termampat daripada perenggan pembukaan HTML
Corak ini mencadangkan spesifikasi teknikal dan bendera binari mungkin datang daripada taksonomi produk Shopify dan medan produk standard, manakala medan berat salinan (USP, ciri utama, penerangan ringkas) lebih berkemungkinan dijana daripada penerangan produk. Kedua-duanya tidak disahkan, hanya Glossier dan Shopify yang tahu mekanisme input sebenar. Tetapi data adalah konsisten dengan pembahagian tersebut.
Walau apa pun, output Full Orbit adalah koheren dan berguna untuk ejen. Risikonya adalah dengan produk di mana bahan sumber lebih nipis. Pertimbangkan apa yang berlaku dengan:
- Produk di mana penerangan HTML kebanyakannya bahasa pemasaran dengan sedikit butiran khusus
- Produk baharu di mana penerangan belum dibangunkan sepenuhnya
- Produk yang diformulasikan semula di mana salinan lama masih aktif
- Produk di mana penempatan anda halus dan memerlukan konteks untuk disampaikan dengan tepat
Dalam setiap kes ini, penerangan inferred AI mungkin terlepas inti sepenuhnya. Itulah penerangan yang digunakan oleh ejen apabila mereka mengesyorkan produk anda kepada seseorang.
Anda tidak mendapat peluang untuk menyemak nilai medan inferred sebelum ia dihidangkan kepada ejen. Satu-satunya cara untuk memastikan ejen bekerja daripada penerangan yang tepat dan dikawal jenama ialah mengisi medan sendiri.
Bagaimana Ejen Sebenarnya Mencari Produk Anda: Search, Kemudian Lookup
Aliran kerja Catalog MCP mengikuti corak dua langkah yang mempunyai implikasi langsung terhadap cara data katalog anda digunakan.
Langkah 1: Search. Ejen menterjemahkan gesaan pengguna seperti “carikan krim mata ringan yang membantu dengan lingkaran hitam di bawah $30” ke dalam pertanyaan carian terhadap Katalog. Keputusan dikelompokkan mengikut Universal Product ID (UPID), yang menghalang pendua apabila produk yang sama dijual oleh berbilang pedagang. Setiap hasil carian termasuk:
- Tajuk dan penerangan produk
- Julat harga merentas semua penjual
- Pilihan tersedia (saiz, warna, dll.)
- Senarai pedagang dengan harga dan URL pembayaran khusus mereka
Langkah 2: Lookup. Menggunakan UPID daripada hasil carian, ejen mendapatkan butiran varian komprehensif untuk produk tertentu, termasuk penerangan penuh, ciri utama, spesifikasi teknikal, semua harga peringkat varian, dan URL pembayaran untuk setiap tawaran pedagang.
Implikasi pengelompokan UPID patut diberikan perhatian. Jika produk anda ialah SKU yang sama dijual oleh berbilang pedagang Shopify (melalui borong, penjual semula sah, atau pengaturan pasaran), tawaran tersebut dipersembahkan bersama dalam satu hasil terkelompok, dengan perbandingan harga. Ejen (dan pengguna) boleh melihat semua harga tersedia sekaligus. Kualiti katalog bukan sahaja mempengaruhi sama ada produk anda muncul, tetapi sama ada tawaran anda yang dipilih apabila berbilang pedagang menjual barangan yang sama.
Mengapa Ini Penting Apabila Ejen Menjadi Pembeli
Perubahan yang berlaku sekarang ialah ejen AI sedang bergerak daripada pembantu penyelidikan kepada peserta transaksi. Ejen beli-belah bukan sekadar memaparkan maklumat. Mereka semakin mampu memulakan pembelian, menggunakan tepat jenis URL pembayaran peringkat varian yang dikembalikan oleh Catalog API.
Apabila ejen boleh menambah produk ke troli atau menjana pautan pembayaran, kualiti data yang dimilikinya tentang produk anda secara langsung mempengaruhi sama ada produk anda dicadangkan, dan sama ada cadangan itu tepat.
Tiga perkara dipertaruhkan:
Kebolehtemuan. Jika ejen tidak dapat menghuraikan dengan yakin apa yang produk anda lakukan dan untuk siapa, ia tidak akan memaparkannya sebagai respons kepada pertanyaan yang relevan. Medan bersih dan berstruktur memberi ejen keyakinan untuk membuat cadangan.
Ketepatan. Ejen yang bekerja daripada HTML mungkin menjana ringkasan produk anda sendiri berdasarkan apa yang boleh diekstrak. Ringkasan itu mungkin meninggalkan dakwaan utama, salah gambar kes penggunaan, atau menggugurkan data yang disahkan secara klinikal sepenuhnya. Anda tidak mengawal apa yang ejen katakan tentang produk anda, tetapi anda mengawal input yang dimilikinya untuk bekerja.
Penukaran. Catalog API termasuk URL pembayaran terus untuk setiap varian. Ejen dengan keupayaan transaksi memerlukan tepat ini: laluan yang boleh dibaca mesin daripada cadangan kepada pembelian. Jika medan itu tidak diisi dan tepat, laluan penukaran terputus sebelum ia bermula.
Medan Yang Mendorong Keputusan Ejen
Tidak semua medan katalog membawa berat yang sama untuk titik akhir agentik. Berdasarkan cara ejen AI memproses dan mengutamakan data produk, berikut ialah yang paling penting:
| Medan | Nama Medan API | Status | Mengapa Ia Penting |
|---|---|---|---|
| Penerangan ringkas | description |
Dijana AI (tiada keutamaan pedagang) | Isyarat utama untuk pemadanan pertanyaan dan salinan cadangan |
| Proposisi jualan unik | uniqueSellingPoint |
Dijana AI (tiada keutamaan pedagang) | Membezakan produk anda dalam konteks perbandingan |
| Ciri utama | topFeatures |
Dijana AI (tiada keutamaan pedagang) | Dipetakan kepada pertanyaan niat pengguna seperti “terbaik untuk lingkaran hitam” |
| Spesifikasi teknikal | techSpecs |
Dijana AI (tiada keutamaan pedagang) | Membolehkan penapisan mengikut format, bahan, atau jenis dispenser |
| Atribut produk | attributes |
Dijana AI (tiada keutamaan pedagang) | Pasangan nama-nilai digunakan untuk penapisan berstruktur |
| Tersedia untuk dijual | availableForSale |
Diperlukan | Ejen menurunkan keutamaan atau melangkau item kehabisan stok |
| URL pembayaran | checkoutUrl |
Diperlukan | Diperlukan untuk sebarang keupayaan ejen transaksi |
| URL varian | variantUrl |
Diperlukan | Laluan sandaran apabila pembayaran asli tidak tersedia |
Medan inferred ialah yang menggambarkan apa produk anda dan mengapa seseorang patut membelinya. Medan diperlukan ialah yang menyelesaikan transaksi. Shopify menjamin kumpulan kedua. Kumpulan pertama ialah tanggungjawab anda.
Apa yang Perlu Diaudit dalam Katalog Anda Hari Ini
Jika anda pemilik jenama yang menguruskan katalog Shopify, terdapat beberapa perkara khusus yang patut disemak sekarang, sebelum ejen AI menjadi bahagian trafik yang lebih besar dan sebelum AI transaksi menjadi norma.
Semak penerangan ringkas anda. Adakah setiap produk mempunyai ringkasan teks biasa yang ringkas yang mendahulukan apa yang produk lakukan? Bukan slogan anda. Bukan cangkuk pemasaran anda. Penerangan fungsional yang boleh digunakan oleh ejen untuk memadankan produk dengan permintaan pengguna.
Semak medan ciri anda. Adakah anda mengisi medan ciri utama yang diskret, sama ada secara asli dalam Shopify atau melalui metafield atau suapan Catalog API? Jika semua maklumat produk anda berada dalam satu blok penerangan HTML, anda memberi ejen satu gumpalan tidak terbeza untuk digunakan.
Semak data ketersediaan anda. Produk kehabisan stok yang masih muncul sebagai tersedia mewujudkan ralat cadangan. Ejen yang mengesyorkan produk yang pengguna tidak boleh beli menghakis kepercayaan terhadap ejen dan jenama anda.
Semak URL pembayaran anda. Jika anda berintegrasi dengan mana-mana suapan beli-belah atau platform perdagangan AI, sahkan bahawa URL pembayaran peringkat varian diisi dengan tepat. Pautan pembayaran yang rosak atau generik memutuskan laluan penukaran sepenuhnya.
Semak penerangan varian anda. Halaman produk sering mempunyai penerangan terperinci yang tidak dibawa ke peringkat varian. Untuk produk dengan berbilang SKU, ejen mungkin membuat pertanyaan pada peringkat varian dan menemui medan kosong.
Semak medan inferred anda. Catalog MCP Shopify menandakan medan sebagai “Inferred” apabila pedagang tidak mengisinya secara eksplisit. Untuk medan yang paling diberi berat oleh ejen (penerangan ringkas, proposisi jualan unik, ciri utama), sahkan bahawa jenama anda telah mengisi nilai eksplisit dan bukannya menyerahkannya kepada inferens AI. Tiada mekanisme untuk menyemak atau membetulkan nilai inferred sebelum ia dihidangkan kepada ejen.
Semak sumber Catalog Mapping anda. Jika anda menggunakan Pelan Agentik, Shopify Catalog Mapping (Tetapan > Shopify Catalog Mapping) membolehkan anda mengarahkan semula sumber tiga medan utama kepada metafield atau metaobject berbanding atribut produk lalai. Ini ialah input yang membekalkan saluran paip inferens ML.
Medan produk
Tukar sumber untuk medan standard pada Katalog Shopify
Shopify Catalog Mapping (Tetapan > Shopify Catalog Mapping). Setiap sumber boleh diarahkan semula kepada metafield atau metaobject. Ini mengawal apa yang masuk ke saluran paip ML, bukan apa yang dihasilkan oleh saluran paip tersebut.
Peralihan Lebih Luas: Katalog sebagai Infrastruktur
Untuk kebanyakan era Shopify, katalog produk ialah bahan jualan, kandungan yang anda tulis untuk manusia yang melayari kedai anda. PDP ialah titik akhir.
Model itu sedang berubah. Katalog anda kini ialah infrastruktur yang dibaca oleh pelbagai jenis pengguna: manusia di kedai anda, perangkak enjin carian, enjin perbandingan harga, dan semakin hari, ejen AI yang membuat cadangan dan pembelian bagi pihak pengguna.
Jenama yang melabur dalam kualiti katalog sekarang (medan berstruktur, teks bersih, metadata lengkap) akan mempunyai kelebihan berganda apabila perdagangan agentik berkembang. Jenama yang tidak akan mendapati produk mereka diringkaskan secara tidak tepat, diturunkan keutamaan oleh ejen yang tidak dapat menghuraikan data, atau hilang daripada cadangan sepenuhnya.
Contoh Glossier memberi pengajaran bukan kerana Glossier telah melakukan sesuatu yang salah. Penerangan HTML mereka kaya, terperinci, dan jelas ditulis untuk pembaca manusia. Ia memberi pengajaran kerana ia menunjukkan bahawa kandungan yang ditulis untuk bacaan manusia dan data yang distrukturkan untuk penggunaan ejen adalah dua perkara berbeza. Kedua-duanya penting sekarang.
Rujukan Dokumentasi Shopify
Halaman berikut daripada dokumentasi pembangun Shopify ialah sumber utama untuk maklumat Catalog MCP dan Catalog API dalam artikel ini.
Gambaran keseluruhan Katalog
- About Shopify Catalog: gambaran keseluruhan Catalog MCP, Storefront MCP, dan Catalog REST API, termasuk definisi medan Inferred
- Universal Commerce Protocol (UCP): standard yang menjadi asas Catalog MCP
Rujukan MCP
- Catalog MCP reference: alat, parameter, dan skema respons untuk
search_global_productsdanget_global_product_details - Storefront MCP reference: alternatif berskop kedai tunggal kepada Catalog MCP
Rujukan Catalog REST API
- Catalog REST API overview: pengesahan, had kadar, dan indeks titik akhir
- Search endpoint: skema medan penuh untuk hasil Search, termasuk medan yang ditandakan Inferred
- Lookup endpoint: skema medan penuh untuk respons butiran produk, termasuk medan yang ditandakan Inferred
- Lookup by variant: skema lookup peringkat varian
- Bulk lookup: pengambilan butiran produk secara pukal
Soalan Lazim
Apakah perdagangan agentik?
Perdagangan agentik merujuk kepada ejen AI yang secara autonomi menyelidik, membandingkan, dan mengesyorkan produk bagi pihak pengguna, dan semakin hari, menyelesaikan pembelian.
- Ejen beli-belah membaca data produk secara programatik, bukan dengan melayari kedai
- Mereka menjana cadangan berdasarkan medan berstruktur seperti penerangan, ciri, dan spesifikasi
- Ejen transaksi boleh memulakan pembayaran menggunakan URL pembayaran peringkat varian
- Kualiti data produk anda secara langsung mempengaruhi sama ada produk anda dicadangkan
Bagaimana ejen beli-belah AI membaca katalog Shopify?
Catalog MCP Shopify ialah laluan utama untuk perdagangan agentik. Ia mengikuti aliran Search, kemudian Lookup.
- Catalog MCP: Laluan yang disyorkan. Mencari semua pedagang Shopify yang layak secara global; memerlukan pengesahan JWT
- Catalog REST API: Data yang sama seperti MCP, boleh ditanya terus
- Storefront MCP: Berskop kepada kedai tunggal; tiada pengesahan diperlukan; berguna untuk ejen jenama tunggal
/products.json: Titik akhir awam legasi; mengembalikan HTML mentah; tiada ciri berstruktur atau URL pembayaran- Ejen yang menggunakan Catalog MCP mengikuti aliran dua langkah: Search mengikut kata kunci/keutamaan untuk mendapatkan UPID, kemudian Lookup mengikut UPID untuk mendapatkan butiran varian penuh
Medan produk manakah yang paling penting untuk ejen AI?
Medan isyarat tertinggi untuk titik akhir agentik ialah yang dipetakan terus kepada cara ejen memadankan produk dengan niat pengguna.
- Penerangan teks biasa ringkas (contoh Full Orbit ialah 98 aksara)
- Proposisi jualan unik
- Ciri utama diskret
- Spesifikasi teknikal berstruktur
- Status ketersediaan
- URL pembayaran peringkat varian
Adakah ia penting jika penerangan produk saya ditulis dalam HTML?
Ya. Markup HTML menambah bunyi bising yang perlu dilucutkan oleh ejen sebelum memproses.
- Penerangan HTML 4,000 aksara dengan kelas CSS dan tag sebaris lebih sukar untuk dihuraikan berbanding ringkasan teks biasa 100 aksara
- Catalog API melucutkan HTML tetapi tidak boleh membetulkan penerangan yang secara semantik tidak jelas setelah markup dibuang
- Penerangan yang ditulis untuk persembahan visual mungkin tidak berkesan apabila dipaparkan sebagai teks biasa
- Penerangan terbaik adalah jelas dan mudah diimbas dalam kedua-dua konteks bacaan manusia dan mesin