如何用 Claude Code 或 Codex 為我的網站加入 JSON-LD 結構化資料？

請代理在您的頁面範本中，依照每頁實際顯示的資料產生 JSON-LD，只使用讀者看得到的類型與數值，並在伺服器端呈現。把這條規則寫進 CLAUDE.md 或 AGENTS.md，讓每個新頁面都照做。然後在 Google 的豐富搜尋結果測試中測試已發布的網址，而不是程式碼。

重點事實

Google 建議在其支援的 3 種結構化資料格式中優先使用 JSON-LD，前提是您的網站設定允許。 (Google Search Central：結構化資料標記簡介)
Google 的指南規定，不得標記讀者看不到的內容；缺少必要屬性的項目，不符合豐富結果的資格。 (Google Search Central：結構化資料一般指南)
Google 表示，出現在 AI 摘要或 AI 模式中不需要特別的 schema.org 標記，而結構化資料也應與可見的文字一致。 (Google Search Central: AI features and your website)
Organization 標記應放在首頁或一個關於我們的頁面，沒有必要屬性，其標誌至少須為 112x112 像素。 (Google Search Central：Organization 結構化資料)
Claude Code 在每個工作階段都會載入專案的 CLAUDE.md，旁邊還有最多 200 行或 25KB 的自動記憶。 (Claude Code 文件：Claude 如何記住您的專案)
Codex 會在開始任何工作前讀取 AGENTS.md，並預設合併最多 32 KiB 的指示檔案。 (OpenAI Codex 文件：使用 AGENTS.md 的自訂指示)

我應該請代理加入哪些結構化資料類型？

只請它加入與每個頁面內容相符的類型，不要多加：

頁面	結構化資料類型	主要屬性
首頁或關於我們頁面	Organization（或 LocalBusiness）	name、url、logo、sameAs
指南或部落格文章	Article	headline、author、datePublished、dateModified、publisher
產品頁	Product	name，以及 offers 中頁面所示的價格
頁面上有可見的問與答	FAQPage	只包含頁面上印出的問題

我要給 Claude Code 或 Codex 什麼提示詞？

給它一組可套用到每個範本的規則，並禁止編造數值：

為這個網站加入 JSON-LD 結構化資料。
- 在頁面範本中，依據頁面實際呈現的同一份資料建立。
  絕不寫死頁面沒有顯示的數值。
- Organization（name、url、logo、sameAs）只放在首頁。
- 指南與部落格文章使用 Article：headline、author、datePublished、
  dateModified（真實的最後變更日期）、publisher = Organization。
- Product、LocalBusiness 或 FAQPage 只用於該內容確實可見的頁面。
- 若某個值未知，就省略該屬性，不要編造。
- 在伺服器端呈現，放在 <script type="application/ld+json"> 中。
- 列出您變更的每個頁面，以及它現在包含的類型。

我要把規則寫在哪裡，新頁面才會有結構化資料？

寫在代理會自行載入的指示檔案中。Claude Code 會在每個工作階段開始時讀取 ./CLAUDE.md 或 ./.claude/CLAUDE.md，/init 會建立第一版。Codex 會在開始任何工作前從專案根目錄讀取 AGENTS.md。這裡寫一條簡短的規則，就能讓代理寫的下一個頁面與上一個保持一致。

如何確認代理沒有編造任何內容？

用豐富搜尋結果測試，測試已發布的網址，然後把每個數值與讀者看到的頁面逐一比對。網址測試會執行頁面的 JavaScript，貼上的程式碼則不會。接著在 Search Console 中使用網址檢查，確認 Google 找到了該標記。測試通過只證明語法正確，數值是否正確仍須您自己核對。

結構化資料能讓 ChatGPT 或 Google AI 引用我的網站嗎？

本身不能。Google 表示 AI 摘要與 AI 模式不需要特別的 schema，也不保證有效的標記會產生豐富結果。正確的 JSON-LD 能幫助搜尋引擎讀懂您是誰、頁面是什麼；但被引用的，仍是頁面上的回答。

逐步操作

列出頁面類型. 首頁、關於我們、指南、產品：每種各對應一個結構化資料類型。
把提示詞交給代理. 請它依頁面自身的資料在範本中建立 JSON-LD，不得編造數值。
儲存規則. 把它加入 CLAUDE.md 或 AGENTS.md，讓之後的頁面都遵循。
審查差異並部署. 確認數值來自頁面資料，而不是寫死的文字。
測試線上網址. 在已發布的頁面上執行豐富搜尋結果測試，然後在 Search Console 中使用網址檢查。

常見錯誤

讓代理填入頁面沒有顯示的評分、價格或作者。
為頁面上沒有印出的問題加入 FAQPage 標記。
測試貼上的程式碼，而不是線上網址，因而漏掉 JavaScript 呈現的內容。
每次建置都設定 dateModified，而不是只在內容真的改變時更新。

easyIndex 如何解決

easyIndex 從不更改您的網站：您的 AI 程式代理負責撰寫頁面與結構化資料，easyIndex 在提交時審查每一頁，並在發布後於線上網站再次檢查，包括是否帶有 JSON-LD 與真實的更新日期。步驟只依據這些證據完成，而不看代理的回報。

常見問題

JSON-LD、Microdata 或 RDFa 要選哪一種？

選 JSON-LD。Google 支援這三種格式，並在您的設定允許時建議使用 JSON-LD。

代理可以用 JavaScript 注入 JSON-LD 嗎？

Google 會處理渲染後存在的 JSON-LD，但對於不執行 JavaScript 的爬蟲，伺服器端呈現的標記較為安全。

每個頁面都要放 Organization 嗎？

Google 要求放在首頁或一個關於組織的頁面；其他頁面可以把它當作 publisher 引用。

Cursor 或其他代理也一樣嗎？

是的，任何會編輯您範本的代理都能遵循同一份提示詞；只是指示檔的名稱不同。

延伸閱讀

最後驗證日期 2026年10月13日.