Docs

我應該把哪些 SEO 規則放進 AGENTS.md 或 CLAUDE.md？

為每個新頁面放入一組簡短、可檢查的規則：一個問題與一個 H1、獨一無二的標題與描述、canonical、hreflang、伺服器算繪的文字、與可見文字一致的 JSON-LD、Sitemap 項目、有來源的事實，並且絕不碰已經運作正常的頁面。規則能指引代理，但無法證明線上頁面是正確的。

重點事實

規則應該放在哪個檔案，AGENTS.md 還是 CLAUDE.md？

如果有超過一個程式代理在儲存庫中工作，就使用 AGENTS.md，因為 Codex 與 Cursor 會讀取它，而 Claude Code 會讀取或匯入它。CLAUDE.md 只保留給 Claude 專用的備註，並加上一行匯入，讓 Claude 也能取得共用的規則：

# CLAUDE.md
@AGENTS.md

我應該複製哪些規則？

這些規則簡短、具體且可檢查，這也是各程式代理自己的文件所建議的。把它們貼成該檔案的一個段落：

## 新頁面的 SEO 規則

- 只新增內容頁面。絕不更動首頁或已經運作正常的頁面。
- 每頁只回答一個問題。H1 就是那個問題；第一段直接回答它。
- 獨一無二的 <title>（最多 60 個字元）與 meta 描述（70 到 165 個字元）。
- 每個頁面都有自我參照的 rel="canonical"。
- 每個語言版本都以 hreflang 連結其他版本；canonical 留在自己的語言中。
- 文字在伺服器算繪的 HTML 中，而不是只由 JavaScript 載入。
- JSON-LD 只描述頁面可見的文字。
- 事實中的每個數字或日期都連結到說明它的來源。不要捏造。
- 把頁面加入 Sitemap，並從相關頁面連結過去。
- 頁面是否完成，要看它在線上網址的檢查結果，而不是建置是否通過。

每條規則的理由是什麼？

每條規則都回應一種已知的頁面失敗方式：

規則理由
每頁都有 canonicalGoogle 把 rel=canonical 視為強烈的訊號，而 Sitemap 只是較弱的訊號
語言之間使用 hreflangGoogle 會以 hreflang 替代連結來識別各語言版本，且 canonical 要與該語言一致
伺服器算繪的文字不執行 JavaScript 的爬蟲否則只會看到空白頁面
JSON-LD 與可見文字一致Google 的結構化資料指南禁止為隱藏內容加上標記
絕不碰運作正常的頁面改寫可能讓頁面失去它原本已經贏得的流量

規則無法保證什麼？

規則無法保證已發布的結果：Claude Code 自己的文件表示，這個檔案是上下文，而不是強制執行的設定。部署失敗、canonical 錯誤或算繪為空白，只會在線上網址上出現，所以請在那裡檢查每個頁面，並在 Search Console 中觀察索引。

逐步操作

  1. 選擇檔案. 在儲存庫根目錄使用 AGENTS.md；如果您保留 CLAUDE.md，就在其中加入 @AGENTS.md。
  2. 貼上規則. 複製規則區塊，並依您網站的路徑與語言調整。
  3. 保持簡短. 保持遠低於 200 行；只屬於某個資料夾的規則，請移到巢狀檔案中。
  4. 線上檢查. 每次部署後，開啟新的網址，確認標題、canonical、內容與 JSON-LD。

常見錯誤

  • 寫下「遵循 SEO 最佳實務」這類含糊的規則，讓代理無法檢查。
  • 同時保留 CLAUDE.md 與 AGENTS.md，卻沒有匯入，導致 Claude Code 從未讀取共用的規則。
  • 貼上冗長的 SEO 手冊，把真正重要的規則埋沒了。
  • 把規則檔案當成已發布頁面正確的證明。

easyIndex 如何解決

easyIndex 透過 MCP 一步一步把頁面規則交給您的程式代理，在提交時稽核每個頁面，並在發布後於線上網站檢查；步驟只有在 easyIndex 檢查到證據時才會完成，而不是依據代理的回報。

它從不更動您的網站或儲存庫，並可與 Claude Code、Codex、Cursor 或任何 MCP 用戶端搭配使用。每個網站每月 US$30，先有 7 天免費試用。

常見問題

Claude Code 會讀取 AGENTS.md 嗎？

會，從 v2.1.277 開始，當沒有 CLAUDE.md 時會讀取；若有 CLAUDE.md，請加入 @AGENTS.md 這一行將它納入。

這些規則能讓我的網站被 ChatGPT 引用嗎？

沒有任何規則能保證。它們讓頁面清楚且可被檢索；是否引用它們，由 ChatGPT 決定。

我應該把 llms.txt 加進規則中嗎？

這是可選的。伺服器算繪的頁面、canonical 與 Sitemap 才是首要的。

子資料夾可以有自己的規則嗎？

可以。程式代理會讀取目錄樹中最近的 AGENTS.md，因此巢狀檔案可以放置該資料夾專用的規則。

延伸閱讀

最後驗證日期 .

AGENTS.md 或 CLAUDE.md 的 SEO 規則