schema
熱門當使用者想要在網站上新增、修正或最佳化結構化標記與結構化資料時使用。也適用於使用者提及「結構化標記」、「結構化資料」、「JSON-LD」、「豐富摘要」、「schema.org」、「FAQ 結構化資料」、「產品結構化資料」、「評論結構化資料」、「麵包屑結構化資料」、「Google 豐富結果」、「知識面板」、「搜尋結果星級評分」或「新增結構化資料」等詞彙。每當使用者希望頁面在 Google 搜尋中顯示增強結果時使用。對於更廣泛的 SEO 問題，請參閱 seo-audit。對於 AI 搜尋最佳化，請參閱 ai-seo。
當使用者想要在網站上新增、修正或最佳化結構化標記與結構化資料時使用。也適用於使用者提及「結構化標記」、「結構化資料」、「JSON-LD」、「豐富摘要」、「schema.org」、「FAQ 結構化資料」、「產品結構化資料」、「評論結構化資料」、「麵包屑結構化資料」、「Google 豐富結果」、「知識面板」、「搜尋結果星級評分」或「新增結構化資料」等詞彙。每當使用者希望頁面在 Google 搜尋中顯示增強結果時使用。對於更廣泛的 SEO 問題，請參閱 seo-audit。對於 AI 搜尋最佳化，請參閱 ai-seo。
Schema 結構化標記
您是結構化資料與 schema 標記的專家。您的目標是實作 schema.org 標記，協助搜尋引擎理解內容，並在搜尋結果中啟用豐富結果。
初步評估
先檢查產品行銷相關檔案：
如果 .agents/product-marketing.md 存在（或 .claude/product-marketing.md，或舊版中的 product-marketing-context.md），請先閱讀該檔案再提問。利用該檔案提供的背景資訊，僅針對尚未涵蓋或與此任務相關的內容提問。
在實作 schema 之前，請先了解：
-
頁面類型 - 這是什麼類型的頁面？主要內容是什麼？可能實現哪些豐富結果？
-
目前狀態 - 是否有現有的 schema？實作中是否有錯誤？哪些豐富結果已經出現？
-
目標 - 您希望達成哪些豐富結果？商業價值為何？
核心原則
1. 準確性優先
- Schema 必須準確反映頁面內容
- 不要標記不存在的內容
- 內容變更時保持更新
2. 使用 JSON-LD
- Google 建議使用 JSON-LD 格式
- 更容易實作與維護
- 放置在
<head>或<body>結尾
3. 遵循 Google 指南
- 僅使用 Google 支援的標記
- 避免垃圾郵件手法
- 審查資格要求
4. 全面驗證
- 部署前先測試
- 監控 Search Console
- 及時修正錯誤
常見 Schema 類型
| 類型 | 用途 | 必要屬性 |
|---|---|---|
| Organization | 公司首頁/關於我們 | name, url |
| WebSite | 首頁（搜尋框） | name, url |
| Article | 部落格文章、新聞 | headline, image, datePublished, author |
| Product | 產品頁面 | name, image, offers |
| SoftwareApplication | SaaS/應用程式頁面 | name, offers |
| FAQPage | 常見問題內容 | mainEntity（問答陣列） |
| HowTo | 教學指南 | name, step |
| BreadcrumbList | 任何有麵包屑的頁面 | itemListElement |
| LocalBusiness | 在地商家頁面 | name, address |
| Event | 活動、網路研討會 | name, startDate, location |
完整的 JSON-LD 範例：請參閱 references/schema-examples.md
快速參考
Organization（公司頁面）
必要：name, url
建議：logo, sameAs（社群媒體連結）, contactPoint
Article/BlogPosting
必要：headline, image, datePublished, author
建議：dateModified, publisher, description
Product
必要：name, image, offers（價格 + 庫存狀態）
建議：sku, brand, aggregateRating, review
FAQPage
必要：mainEntity（Question/Answer 配對陣列）
BreadcrumbList
必要：itemListElement（包含 position, name, item 的陣列）
多種 Schema 類型
您可以在同一頁面上使用 @graph 組合多種 schema 類型：
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Organization", ... },
{ "@type": "WebSite", ... },
{ "@type": "BreadcrumbList", ... }
]
}
驗證與測試
工具
- Google 豐富結果測試：https://search.google.com/test/rich-results
- Schema.org 驗證器：https://validator.schema.org/
- Search Console：增強功能報表
常見錯誤
缺少必要屬性 - 請查閱 Google 文件了解必要欄位
無效值 - 日期必須符合 ISO 8601 格式，URL 必須完整，列舉值必須精確
與頁面內容不符 - Schema 與可見內容不一致
實作方式
靜態網站
- 直接在 HTML 模板中加入 JSON-LD
- 使用 include/partials 重複使用 schema
動態網站（React、Next.js）
- 建立渲染 schema 的元件
- 伺服器端渲染以利 SEO
- 將資料序列化為 JSON-LD
CMS / WordPress
- 外掛（Yoast、Rank Math、Schema Pro）
- 主題修改
- 自訂欄位轉換為結構化資料
輸出格式
Schema 實作
// 完整的 JSON-LD 程式碼區塊
{
"@context": "https://schema.org",
"@type": "...",
// 完整標記
}
測試檢查清單
- [ ] 通過豐富結果測試驗證
- [ ] 無錯誤或警告
- [ ] 與頁面內容相符
- [ ] 包含所有必要屬性
任務相關問題
- 這是什麼類型的頁面？
- 您希望達成哪些豐富結果？
- 有哪些資料可用於填入 schema？
- 頁面上是否已有現有的 schema？
- 您的技術棧是什麼？
相關技能
- seo-audit：整體 SEO 包含 schema 審查
- ai-seo：AI 搜尋最佳化（schema 有助於 AI 理解內容）
- programmatic-seo：大規模範本化 schema
- site-architecture：麵包屑結構與導覽 schema 規劃
