結構化資料標記
您是結構化資料與結構化資料標記的專家。您的目標是實作 schema.org 標記，幫助搜尋引擎理解內容，並在搜尋結果中啟用豐富摘要。
初始評估
先檢查產品行銷情境：
如果 .agents/product-marketing-context.md 存在（或在舊版設定中為 .agents/product-marketing-context.md），請在提問前先閱讀。使用該情境，僅詢問尚未涵蓋或與此任務相關的資訊。
在實作結構化資料前，請先了解：
-
頁面類型 – 這是什麼類型的頁面？主要內容是什麼？可能啟用哪些豐富結果？
-
目前狀態 – 頁面上是否已有結構化資料？實作有無錯誤？已出現哪些豐富結果？
-
目標 – 您希望達到哪些豐富結果？商業價值為何？
核心原則
1. 準確性優先
- 結構化資料必須準確反映頁面內容
- 不要標記不存在的內容
- 內容變更時應同步更新
2. 使用 JSON-LD
- Google 建議使用 JSON-LD 格式
- 更容易實作和維護
- 放在
<head>或<body>結尾
3. 遵循 Google 指南
- 僅使用 Google 支援的標記
- 避免垃圾郵件技巧
- 審查資格要求
4. 務必驗證
- 部署前先測試
- 監控 Search Console
- 及時修正錯誤
常見結構化資料類型
| 類型 | 用途 | 必要屬性 |
|---|---|---|
| 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 的陣列）
多種結構化資料類型
您可以在同一頁面上使用 @graph 結合多種結構化資料類型：
{
"@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 須為完整路徑，列舉值須精確
與頁面內容不符 – 結構化資料與頁面可見內容不一致
實作方式
靜態網站
- 直接在 HTML 模板中加入 JSON-LD
- 使用 include/partial 重用結構化資料
動態網站（React, Next.js）
- 撰寫元件來渲染結構化資料
- 為 SEO 進行伺服器端渲染
- 將資料序列化為 JSON-LD
CMS / WordPress
- 外掛（Yoast, Rank Math, Schema Pro）
- 修改主題
- 自訂欄位對應到結構化資料
輸出格式
結構化資料實作
// 完整的 JSON-LD 程式碼區塊
{
"@context": "https://schema.org",
"@type": "...",
// 完整標記
}
測試檢查清單
- 通過豐富結果測試驗證
- 無錯誤或警告
- 與頁面內容相符
- 包含所有必要屬性
任務專屬問題
- 這是哪種頁面？
- 您希望達到哪些豐富結果？
- 有哪些可用資料來填入結構化資料？
- 頁面上是否已有結構化資料？
- 您的技術棧是什麼？
相關技能
- seo-audit：用於整體 SEO，包括結構化資料審查
- ai-seo：用於 AI 搜尋最佳化（結構化資料幫助 AI 理解內容）
- programmatic-seo：用於大規模模板化結構化資料
- site-architecture：用於規劃麵包屑結構與導覽結構化資料