UCP 檢查器
輸入一家商店的位址,看看它的 UCP 探索檔案是否真的存在——並且真的有效。
UCP(通用商務協議)是讓 AI 助理替商店購物的開放標準。支援 UCP 的商店會在 /.well-known/ucp 發布一份機器可讀的 JSON 設定檔——協議版本、提供的服務、接受的付款處理方,以及用於簽署的公開金鑰。本檢查器透過伺服器取得該檔案,按官方規範中的託管與設定檔規則檢查它,並探測其中宣告的端點。Agent Readiness 檢查器把探索檔案當作眾多信號之一;本工具是針對 UCP 的深度檢查。配套文章什麼是 UCP 以及如何檢查它會手工帶你讀一份真實文件。
最後更新:
檢查一家商店
結果
檢查結果
解析後的檔案
原始檔案(JSON)
已複製。
沒有可展示的文件——本次取得未傳回可用的設定檔。
🔒 目標由我們的檢查伺服器取得,絕不經過你的瀏覽器——因此不受 CORS 限制,商店看到的是檢查伺服器的請求,而不是你的。你的任何資訊都不會傳給商店。
/.well-known/ucp 裡有什麼
UCP 設定檔是一個 JSON 物件,必須包含 ucp 成員。其中 ucp.version、ucp.services 與 ucp.payment_handlers 是必填的——後兩者即使為空也必須存在。ucp.capabilities 是可選的,不過有用的商務設定檔通常至少宣告一項。頂層的 keys[] 陣列可以發布商店的公開簽署金鑰(RFC 7517 JWK 集)。
版本是日期,絕不是「draft」之類的詞:第一個版本是 2026-01-11,最新穩定版是 2026-08-25。宣告舊版本的設定檔仍可通過校驗,但本檢查器會發出警告並列出下面的破壞性變更——因為對方可能拒絕版本與設定檔自身不一致的項目。仍提供舊版本的商店會在 supported_versions 中列出它們,各自指向自己的版本設定檔。
在 2026-08-25 的破壞性變更中,以下幾項會影響已發布的設定檔:舊的 signing_keys[] 欄位被刪除,改為頂層 keys[] JWK 集;履行設定被重組(標誌去掉 allows_ 前置詞,multi_destination 從對映改為陣列);買家同意從固定布林標誌改為以反向網域名稱識別為鍵的動態對映;付款擴充從 dev.ucp.shopping.* 移到 dev.ucp.common.payment.*。
託管規則很嚴格,因為設定檔屬於信任材料:設定檔必須透過 HTTPS 提供,不得重新導向(任何 3xx 都是失敗),並且必須攜帶 Cache-Control: public 與至少 60 秒的 max-age——絕不能是 private、no-store 或 no-cache。Shopify 商店預設在 /.well-known/ucp 提供 2026-08-25 設定檔——試試示範按鈕。
這個檢查器能做什麼——不能做什麼
它在伺服器上取得、校驗與探測。檢查器直接請求 https://<網域>/.well-known/ucp(一次請求,不跟隨重新導向),按本頁規則校驗檔案,並用 HEAD 請求探測檔案中宣告的每個端點(HEAD 被拒絕時改用 GET)。你的瀏覽器從不直接聯繫目標,因此檢查不受 CORS 限制。
它不下單、不以買家身分驗證、不校驗付款處理方的密碼學。能通過這裡的設定檔,只證明商店可以被探索、其端點可以到達——不證明結帳能成功、價格正確,或付款處理方值得信任。
它不檢查 ACP、AP2 或 x402 文件——只檢查 UCP。宣告的端點無法到達只算警告,不是錯誤:端點可能需要驗證,而 401 或 404 回應仍算「可到達」,因為伺服器作出了回應。只有徹底連線失敗才算無法到達。
在信任一份設定檔之前,先對自己誠實
有效的設定檔不等於能用的結帳。探索只是第一步:設定檔說明商店提供什麼、端點在哪裡。那些端點是否接受真實請求、傳回真實價格、完成真實訂單,是另一個問題,本檢查器不回答它。
舊版本只警告、不失敗,是有原因的。2026-04-08 的商店仍可與講 2026-04-08 的平台交易——但只講 2026-08-25 的平台必須拒絕版本不一致的項目,所以舊設定檔會縮小能來購物的對象範圍。
404 通常意味著「這裡沒有 UCP」,而不是「商店壞了」。網際網路上大多數網站根本不發布 UCP 設定檔——反面示範正是如此。請把缺失的設定檔看作關於商店 Agent 就緒程度的事實,而不是商店本身的錯誤。
關鍵事實
| 通用商務協議 | 讓 AI 助理探索商店的商品目錄、結帳與售後,並代表買家交易的開放標準。 |
| 探索檔案 | 發布在商店自有網域下 /.well-known/ucp 的 JSON 設定檔。 |
| 最新版本 | 2026-08-25。版本是日期;第一個版本是 2026-01-11。 |
| 必填欄位 | ucp.version、ucp.services、ucp.payment_handlers——後兩者即使為空也必須存在。ucp.capabilities 是可選的。 |
| 快取規則 | Cache-Control: public 且 max-age 至少 60 秒;絕不能是 private、no-store 或 no-cache。 |
| 重新導向規則 | 設定檔必須透過 HTTPS 提供且不得重新導向——任何 3xx 回應都是失敗。 |
| 官方規範 | Universal Commerce Protocol (UCP) Official Specification |
常見問題
為什麼檢查要在伺服器上執行,而不是在我的瀏覽器裡?
因為瀏覽器會阻擋跨來源讀取。sysosx.com 上的頁面不能直接取得另一家商店的 /.well-known/ucp——除非商店的伺服器用 CORS 標頭明確允許,而大多數商店並不會。檢查器從自己的伺服器取得該檔案(不受此限制),再把結果傳回給你的瀏覽器。
我的商店在 Shopify 上——需要自己發布什麼嗎?
不需要。Shopify 預設在每個店面的 /.well-known/ucp 提供 2026-08-25 設定檔——試試示範按鈕,它會檢查 allbirds.com。如果你的商店在 Shopify 上而檢查失敗,問題出在別處(商店前面的重新導向,或自訂網域沒有指向店面)。
文件存在,但結論是「部分就緒」——先修什麼?
先修復標記為「失敗」的項目:缺失的必填欄位(版本、服務或付款處理方)、無效的 JSON 文件,或重新導向。警告——快取標頭低於 60 秒、舊版本、無法到達的端點——只是建議,本身不會阻止「UCP 就緒」的結論。