X-Robots-Tag 標頭

語法

一個或多個索引規則，使用逗號分隔的列表：

X-Robots-Tag: <indexing-rule>
X-Robots-Tag: <indexing-rule>, …, <indexing-ruleN>

可選的 <bot-name>: 指定後續規則應適用的使用者代理：

X-Robots-Tag: <indexing-rule>, <bot-name>: <indexing-rule>
X-Robots-Tag: <bot-name>: <indexing-rule>, …, <indexing-ruleN>

請參見指定使用者代理範例。

指令

以下任一索引規則均可使用：

all

對於索引或在搜尋結果中呈現無任何限制。此規則為預設值，若明確列出則無效。

noindex

不要在搜尋結果中顯示此頁面、媒體或資源。若未指定，頁面、媒體或資源可能會被索引並顯示在搜尋結果中。

nofollow

不要跟隨此頁面上的連結。若未指定，搜尋引擎可能會使用頁面上的連結來發現這些被連結的頁面。

none

等同於 noindex, nofollow。

nosnippet

不要在搜尋結果中顯示此頁面的文字摘要或影片預覽。靜態影像縮圖（若有）仍可能可見。若未指定，搜尋引擎可能會根據頁面上的資訊生成文字摘要和影片預覽。若要排除某些內容區段不出現在搜尋結果摘要中，請使用 data-nosnippet HTML 屬性。

indexifembedded

即使有 noindex 規則，若頁面透過 iframe 或類似 HTML 元素嵌入其他頁面，搜尋引擎仍可索引該頁面的內容。indexifembedded 僅在搭配 noindex 時有效。

max-snippet: <number>

在搜尋結果中使用最多 <number> 個字元作為文字摘要。若未指定有效的 <number>，則會被忽略。

max-image-preview: <setting>

在搜尋結果中，此頁面的圖片預覽最大尺寸。若未指定，搜尋引擎可能會顯示預設尺寸的圖片預覽。若你不希望搜尋引擎使用較大的縮圖，請指定 max-image-preview 值為 standard 或 none。可用值包括：

none

不顯示圖片預覽。

standard

可顯示預設尺寸的圖片預覽。

large

可顯示較大的圖片預覽，寬度最多達到視窗寬度。

max-video-preview: <number>

對於此頁面上的影片，在搜尋結果中使用最多 <number> 秒的影片摘要。若未指定，搜尋引擎可能會顯示影片摘要，並自行決定摘要的長度。若未指定有效的 <number>，則會被忽略。特殊值如下：

0

最多可使用靜態圖片，符合 max-image-preview 設定。

-1

無影片長度限制。

notranslate

不要在搜尋結果中提供此頁面的翻譯。若未指定，搜尋引擎可能會將搜尋結果的標題和摘要翻譯成搜尋查詢語言。

noimageindex

不要索引此頁面的圖片。若未指定，頁面上的圖片可能會被索引並顯示在搜尋結果中。

unavailable_after: <date/time>

請求在指定的 <date/time> 後，不要在搜尋結果中顯示此頁面。若未指定有效的 <date/time>，則會被忽略。日期必須使用例如 RFC 822、RFC 850 或 ISO 8601 格式。預設情況下，內容無過期日期。若未指定，此頁面可能無限期顯示於搜尋結果中。爬蟲預期會在指定日期和時間後顯著減少對該 URL 的爬取頻率。

描述

當 URL 被爬取時，透過 <meta name="robots"> 和 X-Robots-Tag 定義的索引規則會被發現。大多數爬蟲支援在 X-Robots-Tag HTTP 標頭中使用的規則，這些規則也可以在 <meta name="robots"> 元素中使用。

如果 X-Robots-Tag 內部或 X-Robots-Tag HTTP 標頭與 <meta name="robots"> 元素之間的爬蟲規則衝突，則採用限制性較大的規則。例如，若頁面同時有 max-snippet:50 和 nosnippet 規則，將適用 nosnippet 規則。如果路徑被 robots.txt 檔案阻擋爬取，則索引規則不會被發現或應用。某些值是互斥的，例如 index 和 noindex，或 follow 和 nofollow。在這些情況下，爬蟲的行為未定義，可能有所不同。

與 robots.txt 的互動

若資源被 robots.txt 檔案阻擋爬取，則使用 <meta name="robots"> 或 X-Robots-Tag HTTP 標頭指定的索引或服務規則將無法被檢測，並因此被忽略。

被阻擋爬取的頁面若被其他文件引用，可能仍會被索引（參見 nofollow 指令）。若要從搜尋索引中移除頁面，X-Robots-Tag: noindex 通常有效，但爬蟲必須先重新訪問該頁面以檢測 X-Robots-Tag 規則。

範例

使用 X-Robots-Tag

以下的 X-Robots-Tag 標頭加入了 noindex，要求爬蟲不要在搜尋結果中顯示此頁面、媒體或資源：

HTTP/1.1 200 OK
Date: Tue, 03 Dec 2024 17:08:49 GMT
X-Robots-Tag: noindex

多個標頭

以下回應包含兩個 X-Robots-Tag 標頭，每個標頭指定一個索引規則：

HTTP/1.1 200 OK
Date: Tue, 03 Dec 2024 17:08:49 GMT
X-Robots-Tag: noimageindex
X-Robots-Tag: unavailable_after: Wed, 03 Dec 2025 13:09:53 GMT

指定使用者代理

可以指定規則適用於哪些使用者代理。以下範例包含兩個 X-Robots-Tag 標頭，分別要求 googlebot 不要跟隨此頁面的連結，並要求一個虛構的 BadBot 爬蟲不要索引此頁面或跟隨任何連結：

HTTP/1.1 200 OK
Date: Tue, 03 Dec 2024 17:08:49 GMT
X-Robots-Tag: BadBot: noindex, nofollow
X-Robots-Tag: googlebot: nofollow

在以下回應中，相同的索引規則被定義在單一標頭中。每個索引規則適用於其後所指定的使用者代理：

HTTP/1.1 200 OK
Date: Tue, 03 Dec 2024 17:08:49 GMT
X-Robots-Tag: BadBot: noindex, nofollow, googlebot: nofollow

若多個爬蟲被指定且規則不同，搜尋引擎將採用負面規則的總和。例如：

X-Robots-Tag: nofollow
X-Robots-Tag: googlebot: noindex

當 googlebot 爬取包含這些標頭的頁面時，將被解釋為具有 noindex, nofollow 規則。

規範

不屬於任何現行規範的一部分。

參見

• robots.txt
• 搜尋引擎
• <meta name="robots"> HTML 元素（「robots 標籤」）
• robots.txt 組態安全指南
• RFC 9309: 機器人排除協議
• 使用 X-Robots-Tag HTTP 標頭（developers.google.com）