Boloop 製作的閱讀示意圖:解析、真實描述、功能資格與實際搜尋呈現是不同的檢查。
Boloop 做結構化資料檢查時,出現過一種很容易讓人提前結束工作的畫面:測試器顯示有效項目,頁面上卻仍有圖片抓取限制,軟體也沒有可核實的報價和評分。
綠色結果有價值,只是它回答的問題比「SEO 做好了沒有」窄得多。後來我把檢查拆開記錄:資料能否解析、描述是否真實、目標功能要求是否滿足,以及搜尋中實際發生了什麼。
先把兩個驗證器的工作分清
Schema.org Validator 協助檢查所用詞彙和結構是否成立。Google 複合式搜尋結果測試面向 Google 支援的搜尋功能,可能識別文章、軟體或麵包屑導覽,但不會把所有 Schema.org 類型都列為獨立的複合式搜尋結果。
Boloop 的作品頁用了 CreativeWork 和圖片實體。Google 測試當時只顯示有效麵包屑導覽,這不能推導出作品描述無效,也不意味著應該刪掉其餘真實語義去迎合項目數量。
反過來,一個類型在工具裡被識別,也不足以證明它已滿足某項搜尋呈現的全部文件要求。Google 的結構化資料說明明確區分其搜尋功能約定與更廣泛的 Schema.org 詞彙。
軟體頁的綠色,暴露了工具與資格的差別
我們檢查 Magpie 推薦頁時,Google 測試列出了有效的 SoftwareApplication,同時把缺少報價和彙整評分顯示為非嚴重提示。
如果只截一張綠色截圖,很容易寫出「軟體複合式搜尋結果已經全部通過」。但逐項對照Google 軟體應用程式文件,其中要求價格,以及符合條件的評論或評分。工具提示的措辭並沒有替我們補齊這些事實。
我選擇讓缺失的資料繼續留白。開放原始碼授權不能自動證明所有發行方式都免費,GitHub stars 不是使用者評分,本站按讚也不能換算成星級。若頁面沒有真實、可見、適用的報價和評論,就不能為了消掉提示填一個零價格或一組分數。
這一頁可以具有真實的語義描述,同時還沒有滿足目標複合式搜尋結果的全部要求。把兩項結論分開,後續才知道缺的是資料,還是程式碼。
作者、發布者和更新時間各有各的位置
Boloop 同時有原創文章、外部推薦和互動作品。網站負責發布一個推薦頁面,不會因此成為被推薦軟體或原文的作者。修正作者關係時,我們保留第三方創作者,只把已確認的原創文章作者統一為 Tink,並讓它們引用同一個公開人物身分。
頁面上的名字、About 資訊和結構化資料需要相互對應。sameAs 只連接已核實的公開身分,不能因為想豐富人物節點而加入未經確認的公司、經歷或社群帳號。
日期也有類似問題。我們的 CMS 原有公開時間欄位會隨重新發布而更新,因此介面把它明確標為「最近更新」,結構化資料繼續使用 dateModified。沒有可靠的首次發表紀錄時,不從建立日期猜一個 datePublished,也不把最近一次重新發布悄悄寫成第一次發表。
這樣做減少了一些欄位,卻讓讀者看到的時間含義更準確。
圖片欄位還要追到真實回應
文章宣告了 image,檢查並沒有結束。圖片需要確實與內容有關,頁面能看到,引用位址能被相應抓取系統存取。圖片 URL、正文、結構化資料和分享資訊之間也應保持一致。
2026 年 10 月 22 日,我們在缺陷修復指南上發現:圖片本身能載入,Google 測試也識別到有效文章,但資源路徑仍受到 API 的檢索規則和 noindex 回應標頭限制。這個例子說明,欄位存在和網頁看起來正常,都不能替代圖片存取檢查。
同樣,沒有適用圖片的頁面也不應該把 Logo、裝飾紋理或虛構截圖塞進欄位。新配圖可以在內容需要時製作,並清楚說明它是閱讀示意圖,不能冒充產品真實介面。
把驗收結果寫成四層
我現在為結構化資料保留四類結論:
| 檢查層 | 要回答的問題 | |---|---| | 解析 | 線上實際 HTML 或算繪後的資料能否讀出,語法是否正常? | | 語義 | 實體、關係和欄位是否對應當前可見內容與可靠來源? | | 功能資格 | 對照目標搜尋功能的官方要求,還缺哪些適用事實或存取條件? | | 實際表現 | Search Console 與搜尋結果中,是否觀察到抓取、索引和相應呈現? |
每個實際測試保留自己的頁面、語言和結果。某次繁體中文測試如果尚未完成,就不能拿英文結果代替;一個工具停在提交介面,也不能被寫成頁面測試失敗或成功。
這套拆分讓我們停止用「零錯誤」概括所有事情。標記描述正確,是已經做完的一部分;搜尋引擎會不會抓取、索引和採用某種呈現,還要看後續證據。Google 軟體文件也說明,結構化資料功能並不保證呈現。
如果你正讓 AI 給網站補 Schema,可以要求它同時交付可見欄位對照和缺失事實清單。比起一口氣產生更多類型,這更容易發現一段看起來完整的 JSON-LD 到底有沒有描述真實的網站。
繼續核對真實圖片回應
上面的圖片存取案例,完整記錄在圖片在網頁上能顯示,搜尋引擎為什麼抓不到,包含回應標頭與公開發布資格的檢查。如果由 AI 修改程式碼,可以結合AI 生成程式碼驗收清單,在檢查標記以外驗證實際執行結果。