同一商品網址給人看 HTML，給代理看不收錄的 Markdown

Vercel 在 2026 年 10 月 16 日宣布，開源的 Next.js 商店範本 Vercel Shop 正式開放。它接 Shopify，讓同一個店面同時對人、搜尋引擎和代理程式。頁面沒有寫作者，標成約 3 分鐘。

公告的說法是：代理已經在網站上購物，但用的多半是做人和搜尋引擎的頁面。要給代理更好的購物方式，就要把商品資料做成它們可以直接讀的，並給它們專用的購物工具。範本建立在 Shopify 的 Hydrogen SDK 上，用來取商品目錄、購物車、訂單、付款和結帳。Vercel 和 Shopify 今年較早說過要重做 Hydrogen，讓它不綁在單一 JavaScript 框架；重做後的 SDK 也在同一天正式開放。

同一個網址，瀏覽器看 HTML，代理看 Markdown

公告說，商品頁可以變成機器可讀的內容，包含價格、是否有貨和選項。同一個商品網址可以給人看視覺頁，也可以給代理讀不必先拆版面的商品資料。範本還在頁面放結構化資料，並提供網站地圖，讓搜尋和回答引擎找到商品。

範本說明把這件事寫得更窄。首頁、商品、商品集合和搜尋網址，在客戶端要求 text/markdown，或在網址後面加上 .md（例如 /products/[handle].md，首頁是 /index.md）時，回傳結構化 Markdown。一般瀏覽器還是拿到 HTML。不必另做設定。¹

Markdown 回應會送 X-Robots-Tag: noindex，並用標準網址指回 HTML 頁，所以搜尋引擎收錄的是人看的那一頁，不是 Markdown 副本。Markdown 說明這個商品或集合是什麼，不列出、也不賣庫存。即時的各規格庫存、購物車和結帳，來自 Shopify 的 Universal Commerce Protocol，由店面轉送到 /.well-known/ucp 和 /api/ucp/mcp。Markdown 只把代理指過去，不重複商品清單或各規格存量。

Markdown 用的是這次部署設定的 Shopify 國家和語言。若開了 Shopify Markets，給 AI 讀的內容要和對應的購物頁是同一個市場。

目錄不在 llms.txt，完整網址在網站地圖

店面會發 /llms.txt，用商店設定裡的說明做一份短索引，並解釋代理怎樣透過 UCP 幫人買東西。它連到商店政策、最多 50 個商品集合、網站地圖和爬取指引，不複製整份目錄。完整的網址清單仍是網站地圖。

說明頁列出的發現面還有：schema.org 描述商品、集合、麵包屑、組織和站內搜尋；爬取指引把爬蟲指向網站地圖，並擋掉購物車、帳戶、登入、搜尋，以及已排序或已篩選的集合網址。這些路徑不該被當成要收錄的商品頁。

公告另外說，UCP 給代理一套標準做法：搜目錄、讀商品、查是否有貨、組購物車、拿結帳連結。UCP 的說明寫，協定包含目錄搜尋與查詢、組購物車、身份連結、結帳和訂單，並內建 MCP。² 「結帳連結」是這篇公告的用詞；協定頁寫的是結帳這項能力。範本把這些放在商家自己的網域，代理用 MCP 搜商品、組購物車，不必把整個網站點一遍。

購物助手和人看的頁共用一個購物車

範本把目錄、購物車和結帳，跟 Next.js 店面、給代理的商品資料和購物工具，以及由 eve 驅動的購物助手放在一起。店面和助手在同一份程式裡，所以改設計和改助手怎麼幫人找商品，是同一套。人可以自己瀏覽，也可以叫助手找商品並加入購物車。兩邊共用購物車，從一邊換到另一邊，已加入的東西還在。範本裡的 skills 用來引導寫程式的代理做安裝、改版和更新範本。這些都沒有使用量或轉換數字。

同一天他們用這個範本開了 vercel.store，賣限量商品。購物代理可以幫人找商品、加入購物車，再去結帳。沒有寫賣了多少。

22% 不是這個範本的結果

公告說 Shopify、Next.js 和 Vercel 已經支撐 AG1、Bombas 和 PAIGE 的店面。PAIGE 重做電商架構後，黑色星期五到網路星期一營收增加 22%、轉換增加 76%，而且沒有停機。客戶頁的日期是 2025 年 4 月 3 日，講的是改成這三樣技術，不是 2026 年 10 月才開放的 Vercel Shop。

同一份客戶頁裡，22% 有兩種寫法。開頭卡片寫流量增加 22%、沒有停機，轉換率增加 76%。正文寫黑色星期五營收增加 22%、轉換率增加 76%。公告則寫成黑色星期五到網路星期一的營收和轉換。不能把 22% 同時當成流量和營收，也不能算進這個代理範本。³

常見問題

• 代理是直接讀那頁 HTML 嗎？不是。同一個網址，瀏覽器拿 HTML。要求 text/markdown，或網址加上 .md，才拿 Markdown。Markdown 帶 noindex，並用標準網址指回 HTML，所以搜尋收錄的是人看的頁。Markdown 不包含即時庫存。
• 庫存、購物車和結帳在哪？在商家自己的網域上，由店面把 Shopify 的 UCP 轉到 /.well-known/ucp 和 /api/ucp/mcp。llms.txt 只是短索引，最多列 50 個集合，不是完整目錄。完整網址在網站地圖。
• 多市場的店會不會給代理看錯國家？說明頁寫，Markdown 用這次部署設定的國家和語言。開了 Shopify Markets 時，給 AI 讀的內容要和對應購物頁是同一個市場。公告沒有另給做法。
• PAIGE 的 22% 是這個範本帶來的嗎？不是。那是 2025 年 4 月的客戶故事，講改成 Shopify、Next.js 和 Vercel。22% 在客戶頁同時被寫成流量和黑色星期五營收，轉換率是 76%。公告寫的是黑色星期五到網路星期一。都沒有停機。不能放進 Vercel Shop 的成效。
• 購物車、帳戶和篩選頁要不要讓搜尋收錄？範本的爬取指引把購物車、帳戶、登入、搜尋，以及已排序或已篩選的集合網址擋掉，並把爬蟲指向網站地圖。這些不是商品頁。

編輯解讀

一句話重點：這個範本讓同一個商品網址對人出 HTML、對要求 Markdown 的客戶端出不收錄的說明；真正的庫存和結帳走商家網域上的 UCP，不走那份 Markdown。

這對你的網站意味著什麼：

• 若要給代理一份好讀的商品說明，用同一網址的 Markdown，並讓它 noindex、標準網址指回 HTML。不要另做一套會被搜尋收錄的副本。
• 不要把價格和庫存寫死在 Markdown 或 llms.txt。即時存量、購物車和結帳跟 UCP。llms.txt 維持短索引，目錄留給網站地圖。
• 有多個國家或語言時，代理讀到的市場要和人看到的那一頁相同。
• 對外不要引用 PAIGE 的 22% 或 76% 當作代理購物的成效。那是更早的架構改版，而且 22% 在流量和營收之間沒有對齊。

適用與不適用的情境：適用於用這個範本或同樣做法，決定商品頁要不要同時出 Markdown 和 UCP。不適用於把正式開放當成已經提高轉換，或把 vercel.store 當成有銷售數字的案例。

需要注意的限制：這是 Vercel 和 Shopify 的產品公告，兩家都賣這套店面。沒有代理成交率、引用次數或和舊店面的對照。PAIGE、AG1、Bombas 是原本就用這三樣技術的品牌，不是這次範本的測試組。執行長的兩段話是產品背書，沒有放進正文。

延伸閱讀：

• 美國 Universal Cart：車內結帳或單向交到商家網站

名詞與資料來源

1. Vercel Shop：〈AEO & GEO〉 https://vercel.shop/docs/anatomy/aeo-geo（檢索：2026-10-17）。寫明 text/markdown、.md、noindex，以及 UCP 路徑。
2. Universal Commerce Protocol https://ucp.dev（檢索：2026-10-17）。列出目錄搜尋、購物車、結帳、訂單，以及 MCP。
3. Vercel 客戶故事：〈How PAIGE grew revenue by 22% with Shopify, Next.js, and Vercel〉 https://vercel.com/customers/how-paige-grew-revenue-by-22-with-shopify-next-js-and-vercel（頁面日期：2025-04-03；檢索：2026-10-17）。開頭寫流量 22%，正文寫黑色星期五營收 22%。
4. Vercel：〈Vercel and Shopify make agents first-class shoppers〉 https://vercel.com/blog/vercel-and-shopify-make-agents-first-class-shoppers（刊登：2026-10-16；檢索：2026-10-17）