JSON-LD 結構化數據校驗器
校驗 JSON-LD 結構化數據語法與 schema.org 必填字段,支持 Article、Product、FAQ、Breadcrumb、HowTo、Organization 等 12+ 類型,並生成可直接嵌入網頁的腳本。
等待處理
使用說明
- 1 粘貼 JSON-LD 文本,或從「生成器」選擇類型並填寫字段
- 2 查看語法錯誤、字段缺失警告和富結果預覽
- 3 複製校驗後的 JSON-LD 腳本,嵌入到網頁 head 中
相關工具
關於此工具
JSON-LD 是 Google 推薦的結構化數據格式,通過在網頁中嵌入一段 JSON 告訴搜索引擎「這是一個產品」「這是一篇教程」,從而在搜索結果中獲得富媒體展示(星級、價格、麵包屑、FAQ 摺疊)。錯誤的 JSON-LD 會導致富結果失效甚至觸發手動操作處罰。
本工具校驗兩層:JSON 語法本身(解析錯誤、引號缺失、尾逗號等),以及 schema.org 規範(@context、@type、各類型的必填字段,例如 Article 需要 headline、author、datePublished;Product 需要 name 和 offers;FAQPage 的 mainEntity 必須是 Question 數組)。校驗通過後展示富結果的預覽效果。
如果不會手寫 JSON-LD,使用「生成器」選擇類型、填表,即可得到一份合規的 JSON-LD 腳本,複製到網頁 head 中即可生效。
常見問題
這個工具和 Google 官方的富結果測試工具有什麼區別? +
Google 富結果測試(search.google.com/test/rich-results)只能在線提交 URL 測試,且只檢查 Google 自己支持的類型。本工具在瀏覽器本地運行,可以直接粘貼 JSON-LD 片段,無需部署到線上;覆蓋更多 schema.org 類型,且能本地預覽富結果樣式。建議先用本工具本地校驗通過,再提交到 Google 官方工具做最終驗證。
JSON-LD、Microdata、RDFa 三選一用哪個? +
推薦 JSON-LD。Google 官方明確表示 JSON-LD 是首選方式,因為它把結構化數據從 HTML 標記中解耦,維護方便。Microdata 需要在 HTML 標籤上加 itemprop,會讓模板代碼變亂;RDFa 在 SEO 圈已幾乎廢棄。本工具只處理 JSON-LD。
@type 寫錯了會怎樣? +
如果寫成 Schema.org 不認識的類型,Google 會忽略整段結構化數據;如果是大小寫錯誤(如 article 而不是 Article),同樣無效。本工具內置 12+ 種常見類型的白名單,遇到拼寫錯誤會給出建議。完整類型列表見 schema.org/docs/full。
FAQPage 的 mainEntity 為什麼必須用 Question 數組? +
schema.org 規範要求 FAQPage.mainEntity 是 Question 對象的數組,每個 Question 又有 acceptedAnswer(Answer 對象)。少一層嵌套、用錯字段名都會讓 Google 不識別。本工具會校驗嵌套結構並給出錯誤定位。
為什麼我的 JSON-LD 看起來正確但 Google 還是沒顯示富結果? +
可能原因:1) 站點整體質量不夠,Google 暫時不信任;2) 該類型富結果只在部分國家/語言生效(如 HowTo 僅英文);3) 結構化數據與頁面可見內容不一致(Google 會交叉驗證);4) 觸發了人工審核拒絕。可用 Google Search Console 的「人工操作」報告確認。