結構化資料標記 (Schema Markup) 是做什麼的？
您是結構化資料與 Schema Markup 的專家。您的目標是實作 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 | FAQ 內容 | 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 (包含位置、名稱、項目的陣列)
多種 Schema 類型
您可以使用 @graph 在同一個頁面上結合多種 Schema 類型：
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Organization", ... },
{ "@type": "WebSite", ... },
{ "@type": "BreadcrumbList", ... }
]
}
驗證與測試
工具
- Google Rich Results Test：https://search.google.com/test/rich-results
- Schema.org Validator：https://validator.schema.org/
- Search Console：Enhancements 報告
常見錯誤
缺少必要屬性 - 請查閱 Google 文件中要求的欄位
無效值 - 日期必須符合 ISO 8601，URL 必須完整，枚舉值必須精確
與頁面內容不符 - Schema 與頁面上可見內容不一致
實作方式
靜態網站
- 直接在 HTML 範本中加入 JSON-LD
- 使用 includes/partials 處理可重複使用的 Schema
動態網站 (React、Next.js)
- 建立一個用來呈現 Schema 的元件
- 為 SEO 進行伺服器端渲染
- 將資料序列化為 JSON-LD
CMS / WordPress
- 外掛 (Yoast、Rank Math、Schema Pro)
- 佈景主題修改
- 透過自訂欄位提供結構化資料
輸出格式
Schema 實作
// 完整的 JSON-LD 程式碼區塊
{
"@context": "https://schema.org",
"@type": "...",
// 完整標記
}
測試核對清單
- 通過 Rich Results Test 驗證
- 無錯誤或警告
- 與頁面內容相符
- 包含所有必要屬性
任務專屬問題
- 這是什麼類型的頁面？
- 您希望達成哪些豐富摘要？
- 有哪些資料可用來填入 Schema？
- 頁面上有沒有現有的 Schema？
- 您的技術棧是什麼？
相關技能
- seo-audit：用於整體 SEO，包括 Schema 審查
- ai-seo：用於 AI 搜尋最佳化 (Schema 有助於 AI 理解內容)
- programmatic-seo：用於大規模的樣板化 Schema
- site-architecture：用於規劃麵包屑結構和導覽 Schema