跳至主要內容
Lizely

結構化資料檢查器與提取工具

從貼上的 JSON 提取 HTML-LD 和 Microdata，檢查每個發現的項目，並以連結證據的指南方式呈現缺失的高價值屬性，而不是聲稱符合豐富結果的資格。

隱私權：你的檔案不會離開裝置，所有處理均在瀏覽器本機完成。

使用方式

  1. 1.貼入交付的 HTML 原始碼或受控的渲染 DOM 匯出；檢查器從不抓取或執行頁面。
  2. 2.執行提取，然後分別檢視 JSON-LD 解析錯誤、Microdata 項目、宣告的型態、屬性以及重點缺失屬性警告。
  3. 3.修正原始模板，並使用官方工具針對你實際目標的搜尋功能驗證部署的 URL。

關於結構化資料檢查器與提取工具

結構化資料檢查與提取器會將貼上的 HTML 轉換為文件中已存在結構化資料的可讀清單。它會尋找 JSON-LD 指令碼區塊與 HTML Microdata 項目，顯示每個發現的型別，並為支援的資料集報告專注屬性缺口。所有解析過程都在瀏覽器端執行，不會從遠端 URL 請求來源、作為網頁執行或傳送至 Lizely。

第一項任務是提取，而非評分。JSON-LD 可包含一個物件、物件陣列，或包含多個節點的 @graph。檢查器會將這些容器擴充套件為獨立項目，同時保留其宣告的 @type 值與可見屬性。若遇到格式錯誤的 JSON 模組，將單獨報告，因此一個錯誤的指令碼不會導致其他正確項目被遺失。

Microdata 在普通 HTML 中使用 itemscope、itemtype 和 itemprop 屬性。檢查器會走訪解析後的文件，為頂層項目建立受限制的屬性檢視。它會辨識透過內容屬性、連結、媒體來源屬性、日期值與文字內容所暴露的值。巢狀項目會保持可視的巢狀狀態，而不是被靜默地壓縮成無關的字串。

驗證範圍比提取更為精準。Schema.org 定義了廣泛的詞彙，而搜尋產品則針對特定體驗發布其要求與建議的屬性。檢查器僅在產品有明確規則集時，應用明確且可檢視的型態檔案。未知型態仍會被提取，但不會被賦予臆造的規則。警告僅表示本機型態未找到屬性，並不代表搜尋引擎會拒絕該頁面。

語法正確性與搜尋資格是兩個不同的問題。正確的 JSON 可描述不準確、隱藏或無關的內容。外觀完整的物件仍可能違反搜尋政策、與可見頁面矛盾、使用不支援的功能，或失敗於部署測試。相反地，非 Google 功能的 Schema.org 屬性對其他消費者仍可能具有意義。因此結果會區分解析錯誤、缺失重點屬性與資訊性觀察。

檢查器不會抓取實際網頁。此邊界避免了跨域錯誤、私有網路請求以及可能與爬蟲實際接收內容不符的誤導性審計。請複製交付的 HTML 或受控的 DOM 匯出內容至輸入欄位。若框架在載入後注入標記，請比較原始回應、渲染的 DOM 與爬蟲可見輸出，再做結論。

貼上的文件中沒有執行的指令碼。一個分離的模板片段會將解析的節點維持在活頁頁面上之外，並會將提取的值作為文字呈現。這個工具不會遵循連結、載入圖片、提交表單或評估內嵌的 JavaScript。輸入大小和項目數量受到限制，因此誤將整個網站資料 Dump 不會導致頁面當機。

使用提取的清單來回答具體問題。目標型態是否已存在？模板是否產生了重複項目？某變體是否缺少必要欄位？JSON-LD 模組是否無法解析？Microdata 是否因使用錯誤屬性導致空白 URL？修正原始模板後，再使用官方驗證工具針對實際目標的搜尋功能進行驗證。

Google 建議使用 JSON-LD 來支援多種結構化資料功能，因其通常較易維護，但也支援 Microdata 與 RDFa（有明確檔案說明）。本工具僅提取 JSON-LD 與 Microdata。RDFa 超出目前產品範疇，不會被視為缺失或無效的結構化資料。此限制明確顯示，結果不可誤認為通用語義網驗證工具。

需求屬性指南無法取代內容審查。標籤應代表使用者實際可以看到的內容，並應使用具體且準確的值。僅為壓低警告而新增欄位，可能會讓實現變得不那麼可信。較少但完整且真實的屬性，優於一個充滿通用或虛構值的大型物件。

變更後，應使用 Google 的豐富結果測試驗證公開的 URL（當型態針對 Google 功能時），在重新爬取後檢視 Search Console 增強報告，並在代表性記錄上測試實際頁面模板。搜尋引擎決定是否以及何時顯示豐富呈現。本機檢查器無法保證索引、排序或豐富結果。

重點測試案例涵蓋有效的 JSON-LD 物件、@graph、頂層陣列、格式錯誤的 JSON、缺失必要屬性、多種型態、基本 Microdata 提取與巢狀值。負面案例包括看起來可執行的貼入文字、過大來源與不支援的結構。這些測試保護了決定性的解析行為，並不代表模擬所有消費者。

請將此工具視為正式測試前的透明預檢：貼上授權的 HTML，檢查每個提取的項目，先解決解析錯誤，根據連結的文件審查資料屬性警告，然後驗證部署後的回應。輸出是關於貼上文件的證據，而非對搜尋外觀的承諾。

方法與來源

一個分離的瀏覽器模板會建立一個隔離的文件片段。提取器會擴充套件 JSON-LD 物件、陣列和 @graph 節點，遍歷有界頂層微資料項目，規範宣告的型別和屬性，並僅套用明確支援型別的屬性樣板。解析錯誤、樣板警告和資訊性限制會保持分離。

常見問題

一個乾淨的結果是否保證 Google 會出現豐富結果？
不會。檢查器僅報告貼入標記的事實；是否符合豐富結果還取決於可見內容、特定功能政策、部署、索引以及 Google 的最終決定。
檢查器會抓取或執行我的網頁嗎？
不會。它會在一個脫離的瀏覽器範本片段中解析貼入的 HTML，不會請求 URL、執行指令碼、載入資源或提交原始內容。
為何會提取一個不熟悉的 Schema.org 型態，卻不進行評估？
提取可以通用，但必須屬性規則則依消費者與功能而異。此工具在沒有明確合約的前提下，不會自行創設驗證規範。

相關工具

SEO 與網站管理 使用指南

查看全部