FAQ

若要開始使用 IndexNow，請先確認您的內容管理系統 (CMS)、主機託管提供商或 SEO 外掛是否已支援 IndexNow。許多平台提供內建支援或相容的附加元件，因此您可能不需要手動設定。

如果您的平台不支援 IndexNow，您可以透過產生金鑰檔案、驗證您的網站並使用 IndexNow API 提交 URL 來手動實作。

在手動設定 IndexNow 之前，請先查閱您的 CMS 文件或外掛程式庫。

以下 CMS 提供原生 IndexNow 整合，或透過 SEO 外掛或擴充功能支援：

• WordPress
• Shopify
• Wix
• GoDaddy
• Duda
• XenForo
• Milestone
• Joomla!
• Drupal
• Bitrix24
• PrestaShop
• MODX
• Shopware
• OpenCart
• Typo3
• Umbraco

其他內容管理系統可能透過其外掛程式庫中提供的第三方外掛或擴充功能原生支援 IndexNow。請洽詢您的 CMS 或主機託管提供商，以了解如何為您的網站啟用 IndexNow。

Cloudflare 提供原生 IndexNow 整合。但此清單並非詳盡無遺。請洽詢您的提供商，以取得為您的網站啟用 IndexNow 的具體說明。

傳統搜尋引擎依賴網路爬蟲來發現內容更新，但這個過程可能很慢，需要數天甚至數週的時間。IndexNow 讓您在新增、更新或刪除內容時立即提交 URL。

這可以提升您的網站在支援搜尋引擎中的索引速度，並有助於讓您的內容在 AI 驅動的搜尋結果中保持最新。更快的索引可以帶來更好的可見度和更及時地納入搜尋結果中，這有助於改善 SEO 表現。

網站應在內容新增、更新或移除時通知 IndexNow，以便搜尋引擎在其索引中反映最新版本。

典型情況包括：

• 新內容：產品頁面、影片、旅遊清單、職缺公告、部落格文章或活動公告。
• 更新的內容：產品說明、影片標題/中繼資料、目的地指南、公司簡介或政策頁面。
• 價格或供應狀態變更：庫存狀態、促銷活動或已過期的優惠。
• 使用者產生的內容：新的評論、留言或論壇帖子（以遞增方式提交以避免過度通知，例如每筆評論從 1-20，然後每 5 筆至 100，每 10 筆至 1000）。
• 已移除的內容：已刪除的產品、影片、旅遊優惠或已過期的活動。

透過在這些時間點通知 IndexNow，您可以幫助搜尋引擎更快、更有效率地索引您網站的正確版本。

當您的 CMS、主機託管提供商或 SEO 外掛支援 IndexNow 時，您不需要金鑰檔案。提交會自動處理。

對於手動設定，您需要建立 API 金鑰。此金鑰可證明您的網域所有權，並驗證您的提交，讓搜尋引擎知道這些提交來自授權來源。

產生 API 金鑰的步驟

1. 產生金鑰字串

• 使用 GUID/UUID 產生器或命令列工具。
• 您的金鑰必須為 8 到 128 個字元長。
• 允許的字元：小寫字母 (a 到 z)、大寫字母 (A 到 Z)、數字 (0 到 9) 和連字號 (-)。

2. 建立金鑰檔案

• 開啟文字編輯器或程式碼編輯器（例如 Notepad、TextEdit、VS Code）。
• 將您的 API 金鑰貼入檔案中。
• 以 UTF-8 編碼儲存檔案，檔案名稱為金鑰，後面加上 .txt。
• 範例：如果您的金鑰是 abcd1234，請建立一個名為 abcd1234.txt 的檔案，內容為 abcd1234。

3. 上傳檔案

• 將金鑰檔案放在您網站的根目錄中，或同一主機上任何可公開存取的資料夾中（無需登入）。
• 確認該檔案可透過公開 URL 存取，例如：https://yourdomain.com/{your-key}.txt
• 範例：如果您的網域是 yourdomain.com 且您的金鑰是 I-love-IndexNow-3000，則檔案應位於 https://yourdomain.com/I-love-IndexNow-3000.txt。
• 或者，您可以使用其他公開位置，例如 https://yourdomain.com/keys/well-known.txt。如果您使用非根目錄位置，請在提交 URL 時使用 keyLocation 參數指定金鑰檔案位置。

產生金鑰檔案後，將其上傳到以下位置之一：

• 您網站的根目錄（建議）。
• 或者，如果無法存取根目錄，則上傳到主機託管提供商上的可公開存取的資料夾（無需登入）。

然後在瀏覽器中開啟檔案的 URL：
https://yourdomain.com/{your-key}.txt

如果檔案載入並僅顯示您的金鑰，則表示您的網站已驗證。搜尋引擎會使用此檔案在接受 IndexNow 提交之前確認網域所有權。如果驗證失敗，請參閱下方的疑難排解章節以取得常見修正方法。

您可以按照以下步驟在不中斷服務的情況下輪換 IndexNow API 金鑰：

產生新金鑰，使用您最初使用的相同方法（手動或基於工具的方法）。

• 將根目錄中的舊金鑰檔案替換為新的 {key}.txt 檔案。
• 開始使用新金鑰提交 URL。這會自動促使搜尋引擎在下次提交時驗證新金鑰。

搜尋引擎會在 URL 提交過程中偵測到更新的金鑰時自動重新驗證所有權。

您可以在新增、更新或刪除內容時，透過向 IndexNow API 提交 URL 來立即通知搜尋引擎。

1. 格式化請求 URL：

您可以將請求提交至以下其中一個參與端點。
每個端點會將您的提交直接發送至其各自的搜尋引擎，而您的提交將與所有啟用 IndexNow 的搜尋引擎共用：

• IndexNow 全域端點： https://api.indexnow.org/indexnow?url={your-added-or-updated-or-deleted-url}&key={your-key}
• Amazon： https://indexnow.amazonbot.amazon/indexnow?url={your-url}&key={your-key}
• Bing： https://www.bing.com/indexnow?url={your-url}&key={your-key}
• Naver： https://searchadvisor.naver.com/indexnow?url={your-url}&key={your-key}
• Seznam.cz： https://search.seznam.cz/indexnow?url={your-url}&key={your-key}
• Yandex： https://yandex.com/indexnow?url={your-url}&key={your-key}
• Yep： https://indexnow.yep.com/indexnow?url={your-url}&key={your-key}

2. 將 {your-url} 替換為您已新增、更新或刪除的頁面的完整 URL，並將 {your-key} 替換為您已驗證的 IndexNow API 金鑰。

3. 使用瀏覽器、腳本或 HTTP 用戶端提交請求。

4. 確認提交成功：

• 如果您收到 HTTP 200 回應，表示您的提交已被接受並處理。
• 注意：對於您的第一個請求，您可能會收到 HTTP 202 回應。這表示 URL 已收到，搜尋引擎將在索引內容之前驗證您的金鑰。驗證完成後，後續成功的提交通常會回傳 HTTP 200。

IndexNow 支援每個 POST 請求批次提交最多 10,000 個 URL。當您有多個已更新、新增或刪除的頁面需要以單一批次通知搜尋引擎時，這非常有用。

在您的 POST 請求中使用此 JSON 格式：

POST /indexnow HTTP/1.1
Host: <searchengine>
Content-Type: application/json; charset=utf-8

{
  "host": "www.example.com",
  "key": "fa8c0a469da44e9b8f6a769f291829f5",
  "urlList": [
    "https://www.example.com/url1",
    "https://www.example.com/folder/url2",
    "https://www.example.com/url3"
  ]
}

將您的 POST 請求提交至：
https://api.indexnow.org/indexnow

提交多個 URL 時的注意事項：

• 每個請求最多提交 10,000 個 URL。
• 使用 UTF-8 編碼並設定正確的 Content-Type 標頭。

IndexNow 允許您在單一 JSON 承載中每個 POST 請求提交最多 10,000 個 URL。提交超過此數量可能會導致請求失敗或回傳 HTTP 422（無法處理的實體）回應。

為確保成功處理，請始終將批次提交控制在 10,000 個 URL 的限制以下。

您可以使用以下 URL 結構提交至任何參與的搜尋引擎：

https://<searchengine>/indexnow?url={your-url}&key={your-key}

例如，如果您要提交至 IndexNow，URL 將是：

https://api.indexnow.org/indexnow?url=https%3A%2F%2Fwww.example.com%2Fpage1&key=50283fcd8c764cfd9bd79a8b4002f647

如何正確格式化您的 IndexNow 提交 URL：

• 將 key 參數替換為您實際的 IndexNow API 金鑰。
• 務必對提交的頁面 URL 進行 URL 編碼（例如 %3A 代表 :，%2F 代表 /）。

IndexNow 要求 URL 按照 RFC-3986 標準進行編碼。這可確保特殊字元透過 API 安全傳輸。

常見的 URL 編碼範例：

• : 變成 %3A
• / 變成 %2F
• ? 變成 %3F
• = 變成 %3D
• & 變成 %26

為什麼正確編碼 IndexNow URL 很重要：

正確的編碼可確保搜尋引擎正確解析和處理 IndexNow URL。未能編碼 URL 可能導致錯誤或提交被跳過。

使用 IndexNow 提交 URL 後，搜尋引擎會根據其爬取配額、排程邏輯和品質訊號來評估是否應爬取該 URL。如果頁面通過內部檢查，將會被爬取以獲取最新內容。

提交 URL 並不保證立即索引。但是，IndexNow 增加了重要變更被更快發現和爬取的可能性，幫助搜尋引擎更快地呈現您的內容。

是的。每個透過 IndexNow 提交的 URL 都會計入您網站的爬取配額。

但是，使用 IndexNow 表示您向搜尋引擎發出訊號，表明這些 URL 很重要且應優先處理。這通常會使提交的 URL 比未提交的頁面更快被爬取。

除非有實質的內容變更，否則請避免一天多次提交相同的 URL。對於經常更新的頁面，最佳做法是在更新之間至少等待 5 分鐘再重新提交。

對於高頻率更新，請僅在影響內容或結構的實質變更時使用 IndexNow。提交不必要的更新可能會浪費爬取配額而不會提升可見度。

如果您的內容經常更新，請將 IndexNow 提交集中在有意義的變更上，例如頁面內容、定價或供應狀態的更新。避免提交每個小型版面配置或外觀變更。

若要有效處理頻繁更新：

• 自動化提交，使用能偵測真正內容變更的腳本。
• 重新提交相同的 URL 前至少等待 5 分鐘。
• 監控索引行為，以平衡內容新鮮度和爬取效率。

可以。您應該提交已重新導向的 URL 以及回傳 HTTP 404 或 HTTP 410 狀態碼的頁面。

使用 IndexNow 提交已重新導向或已刪除的 URL 可讓搜尋引擎：

• 當頁面使用 301、302 或 meta refresh 進行重新導向時更新其索引。
• 當頁面被刪除並回傳 404 或 410 時移除過時或損壞的連結。
• 為使用者維持準確且最新的搜尋結果。

IndexNow 支援提交已刪除、移動或重新導向的內容的 URL。納入這些更新有助於確保搜尋引擎反映您網站最準確的結構並提升爬取效率。

IndexNow 的用途是通知搜尋引擎最近新增、更新或刪除的 URL。它不是設計用來一次提交網站上的所有 URL。

如果您的整個網站最近已更新（例如遷移或重新設計後），可以使用 IndexNow 提交所有 URL。對於持續的發現和長期索引，請使用 XML 網站地圖。

若要提升索引涵蓋範圍和新鮮度，請使用以下方法：

• 使用 IndexNow 提交高優先級或經常變更的頁面。
• 使用網站地圖為搜尋引擎提供您網站上所有 URL 的完整清單。

這種組合可確保快速的內容發現和全面的搜尋結果可見度。

是的。同時使用 IndexNow 和網站地圖可以提升內容可見度並確保更廣泛的搜尋引擎涵蓋範圍。

IndexNow 透過以下方式提升搜尋可見度：

• 在內容新增、更新或刪除時立即通知。
• 更快發現重要變更。
• 為經常變更的內容提供即時更新。

網站地圖透過以下方式增強搜尋涵蓋範圍：

• 提供您網站上所有 URL 的完整清單。
• 發現不常變更或位於網站結構較深層的頁面。
• 為全面索引提供長期爬取支援。

結合 IndexNow 和網站地圖可確保您的內容被傳統和 AI 驅動的搜尋引擎快速呈現且徹底發現。

不應該。IndexNow 旨在通知搜尋引擎有關最近的新增、更新或刪除。它不適用於追溯提交較舊的變更。

若要幫助搜尋引擎發現先前更新的頁面，請遵循此方法：

• 使用 IndexNow 提交在設定 IndexNow 之後變更的 URL。
• 使用具有準確 lastmod 值的網站地圖來呈現在實作之前更新的內容。
• 這種組合可確保搜尋引擎能看到最近的和歷史的變更。

是的。IndexNow 即使對只有幾個頁面的小型網站也很有幫助。它讓您能立即通知搜尋引擎有關更新，增加更快爬取和索引的可能性。

在小型網站上使用 IndexNow 可以幫助您：

• 讓新的或更新的內容更快獲得可見度。
• 透過鎖定已變更的頁面來提升爬取效率。
• 控制您的更新在搜尋結果中出現的速度。

自動化有助於確保及時的 URL 通知，而不會使搜尋引擎過載或超過速率限制。關鍵在於偵測真正的變更並只提交重要的內容。

若要有效地自動化 IndexNow：

• 使用後端腳本或 CMS 掛鉤在內容新增、更新或刪除時觸發提交。
• 偵測並篩選有意義的更新（例如價格、供應狀態、內容），而非僅外觀或版面配置的變更。
• 實作去彈跳邏輯以防止快速重複提交（例如同一 URL 的提交之間至少等待 5 分鐘以上）。
• 記錄每次提交並監控 HTTP 回應碼以發現問題。
• 將 IndexNow 整合到發佈工作流程或部署管線中，使提交自動且可靠地進行。

您可以建立一個腳本來偵測動態內容變更並將更新的 URL 直接提交至 IndexNow API，藉此自動化 IndexNow 提交。這可確保在關鍵內容變更時即時通知搜尋引擎。
以下是一個 Python 範例，模擬檢查內容資料庫中最近修改的 URL 並自動提交至 IndexNow。

請將模擬的 content_db 字典替換為即時整合，查詢您的 CMS、發佈平台或後端資料庫以偵測最近更新的內容。

import requests
import time

# 設定
API_KEY = "your-api-key"
HOST = "example.org"
KEY_LOCATION = "https://{HOST}/{API_KEY}.txt"
INDEXNOW_API_URL = "https://api.indexnow.org/indexnow"

# 模擬內容資料庫（時間戳 = 現在 - 隨機偏移值）
content_db = {
    "/product?id=101": int(time.time()) - 100,  # 約 100 秒前修改
    "/news?id=202": int(time.time()) - 4000,   # 約 1 小時以上前修改
    "/blog?id=303": int(time.time()) - 200     # 約 200 秒前修改
}

def detect_dynamic_changes():
    current_time = int(time.time())
    changed_urls = []
    for url, last_modified in content_db.items():
        if current_time - last_modified < 3600:  # 過去一小時
            changed_urls.append(f"https://{HOST}{url}")
    return changed_urls

def submit_urls(url_list):
    payload = {
        "host": HOST,
        "key": API_KEY,
        "keyLocation": KEY_LOCATION,
        "urlList": url_list
    }
    headers = {"Content-Type": "application/json; charset=utf-8"}
    response = requests.post(INDEXNOW_API_URL, json=payload, headers=headers)

    if response.status_code in (200, 202):
        print("URL 提交成功：", url_list)
    elif response.status_code == 429:
        print("已達速率限制。請稍後再試。")
    else:
        print("失敗：", response.status_code, response.text)

if __name__ == "__main__":
    changed_urls = detect_dynamic_changes()
    if changed_urls:
        submit_urls(changed_urls)
    else:
        print("未偵測到動態內容變更。")

提交 URL 時，您可能會收到以下 HTTP 回應碼：

• 200 OK：URL 已成功接收。
• 202 Accepted：提交已接受但尚未處理。
• 400 Bad Request：您的 URL 或 API 金鑰可能格式不正確。
• 422 Unprocessable Entity：伺服器理解請求但無法處理。
• 429 Too Many Requests：您已達到速率限制。請稍後再試。

記錄您的 HTTP 回應以監控提交成功率並識別問題。這有助於及早發現問題，特別是速率限制或格式錯誤。

設定適當的記錄有助於您監控 URL 提交並排除 IndexNow 整合中的錯誤。

在 IndexNow 記錄系統中應包含的重要欄位：

• 提交的時間戳記
• 完整的已提交 URL
• HTTP 回應碼（例如 200、400、429）
• 重試次數或失敗
• 提交方法（GET 或 POST）
• 使用的 API 金鑰（管理多個金鑰時選用）

為什麼記錄對 IndexNow 很重要：

• 有助於偵測提交模式和重複發生的錯誤。
• 讓發現和修正失敗的提交更為容易。
• 確認 URL 是否被接受並正確索引。

監控和測試您的 IndexNow 實作可確保您的 URL 被正確提交並被搜尋引擎接收。

若要有效監控和測試 IndexNow 提交：

• 使用 curl 或 wget 等工具測試 URL 提交並查看 HTTP 回應碼。
• 檢查成功回應（HTTP 200）或錯誤（例如 400、429）。
• 記錄所有提交及其時間戳記和伺服器回應。
• 查閱搜尋引擎提供的索引報告或工具以追蹤爬取行為。

每個子網域被視為獨立的主機，這表示您必須為每個子網域建立和管理個別的金鑰檔案。

對於具有以下子網域的網站：

• blog.example.com
• shop.example.com
• support.example.com

您應該對每個子網域執行以下操作：

• 在子網域的根目錄中託管其自身的 {key}.txt 檔案。
• 使用該子網域的專屬 API 金鑰提交 URL。

這可確保每個子網域都被獨立驗證並在搜尋引擎中正確索引。

如果您的網站提供多種語言的內容，請使用 IndexNow 分別提交每個語言版本的 URL。

例如：

• https://example.com/en/product
• https://example.com/fr/product
• https://example.com/de/product

如何為 IndexNow 最佳化多語言提交：

• 為每個語言版本提交獨立的 URL。
• 確保每個版本在適用時使用 canonical 和 hreflang 標籤。
• 對所有提交的連結進行 URL 編碼以符合 RFC-3986 標準。

以這種方式使用 IndexNow 有助於搜尋引擎更快地發現和爬取本地化內容。

如果您的 IndexNow 金鑰檔案已上傳但未通過驗證，通常表示檔案的命名、放置或可存取性不正確。

• 檔案名稱：檔案必須完全以您的 API 金鑰命名，後面加上 .txt（例如，如果您的金鑰是 I-love-IndexNow-3000，則將檔案命名為 I-love-IndexNow-3000.txt）。
• 檔案位置：它應該位於您網域的根目錄中（而非子資料夾，除非您的主機另有要求）。

需要檢查的常見問題：

• 檔案內容：裡面的文字必須與您的 API 金鑰完全一致。
• 檔案可存取性：它必須在 https://yourdomain.com/{your-key}.txt 上無需登入、防火牆或 IP 限制即可存取。

如何測試

在瀏覽器中開啟檔案的 URL。如果它僅顯示您的金鑰為純文字，搜尋引擎就可以驗證您的網站。如果檔案遺失、不匹配或被封鎖，IndexNow 提交將不被接受。

使用 IndexNow 提交 URL 可通知搜尋引擎內容已變更，但不保證索引。您的 URL 可能未被索引的原因包括：

• 您網域的爬取配額限制。
• 低品質、單薄或重複的內容。
• 技術問題，例如 404 錯誤、robots.txt 封鎖或 noindex 標籤。
• 因爬取排程而導致的索引延遲。
• 搜尋引擎可能根據其演算法選擇不索引某個 URL。

請確保您的內容品質高、有內部連結且可供爬蟲存取。

透過 IndexNow 提交 URL 會通知所有參與的搜尋引擎內容已變更，但每個引擎會自行決定是否索引。

您的 URL 可能在一個引擎上已索引但在另一個上未索引的原因包括：

• 各搜尋引擎評估內容品質的差異。
• 不同的爬取預算或 URL 優先順序策略。
• 獨特的索引演算法和排名系統。
• 各引擎之間的時間差或爬取排程差異。

搜尋引擎使用自己的標準來決定哪些內容出現在其結果中。若要檢查 URL 是否已索引，請使用各引擎的網站檢測或報告工具。

IndexNow 不公開揭示確切的速率限制，因為每個參與的搜尋引擎會為每個網站設定自己的每日提交閾值。

如果您收到 HTTP 429（Too Many Requests）回應，請採取以下步驟：

• 暫停提交並在 Retry-After 標頭指定的時間後重試。
• 減少提交的頻率或批次大小。
• 記錄提交活動以監控速率限制錯誤。

若要避免達到速率限制，請遵循以下最佳做法：

• 僅在內容變更時提交。不要重新提交未變更的 URL。
• 監控 HTTP 回應碼並相應地調整提交模式。

HTTP 400 Bad Request 錯誤表示 IndexNow 提交失敗，因為請求格式不正確或缺少必要資訊。

IndexNow 回傳 400 錯誤的常見原因：

• IndexNow API 金鑰遺失或不正確。
• 提交的 URL 未正確進行 URL 編碼。
• 請求結構不符合 IndexNow 格式。
• url 或 key 等參數拼寫錯誤或遺失。

如何修正使用 IndexNow 時的 400 錯誤：

• 驗證您的 IndexNow API 金鑰 — 確保提交中的金鑰與金鑰檔案中託管的金鑰一致。
• 檢查提交的 URL 是否正確編碼 — 對 :、/ 和 & 等字元使用符合 RFC-3986 的編碼。
• 檢閱 IndexNow 請求的結構 — 無論是透過 GET 或 POST 提交，請確認格式符合 IndexNow 協定指南。
• 修正拼寫錯誤或格式問題 — 檢查是否有多餘字元，例如尾部逗號或錯位的括號。
• 使用記錄來監控 IndexNow 提交 — 追蹤錯誤和回應碼以識別和修正重複發生的問題。

透過解決這些問題，您可以確保 IndexNow 提交被參與的搜尋引擎正確接受和處理。

HTTP 422 Unprocessable Entity 錯誤表示伺服器理解您的 IndexNow 提交，但由於一個或多個問題而無法處理。

IndexNow 回傳 422 錯誤的常見原因：

• 提交的 URL 與您已驗證的網域不匹配。
• IndexNow 金鑰檔案遺失或無法存取。
• 相同的 URL 在沒有有意義的變更的情況下被重複提交。

如何解決 IndexNow 中的 422 錯誤：

• 驗證金鑰檔案位置和可存取性 — 確保金鑰檔案正確託管在根目錄中，並可在 https://yourdomain.com/{your-key}.txt 公開存取。
• 確認網域與您的金鑰匹配 — 僅提交與您已驗證的 IndexNow 金鑰匹配的網域下的 URL。
• 僅提交最近變更的內容 — 避免提交未變更的 URL。IndexNow 專為新增、更新或刪除的內容而設計。
• 監控並記錄您的提交 — 使用記錄追蹤重複錯誤、避免重複提交並確認成功傳送。

修正這些問題有助於確保您的 IndexNow 請求被參與的搜尋引擎接受和處理。

429 錯誤表示您在短時間內向 IndexNow 提交了太多 URL，已超過您網站的提交速率限制。

如何解決 IndexNow 429 錯誤：

• 檢查 Retry-After 標頭以了解在重新提交之前需要等待多長時間。
• 減少提交頻率，避免不必要或重複的提交。
• 除非有重大變更，否則在重新提交相同的 URL 之前至少等待 10 分鐘。
• 記錄您的請求並監控回應碼以避免再次達到速率限制。

每個搜尋引擎為 IndexNow 設定自己的限制。放慢速度並分散提交可以提升傳送成功率。

以下是可能導致 IndexNow 無法正確運作的常見實作問題：

• 將金鑰檔案託管在網域根目錄之外。
• 使用錯誤的檔案名稱（必須與您的金鑰完全一致並以 .txt 結尾）。
• 忘記對提交 URL 中的特殊字元進行 URL 編碼。
• 重複提交未變更的 URL。
• 使用未驗證或不匹配的金鑰。
• 在金鑰檔案可公開存取之前就進行提交。

請確保金鑰檔案正確放置且可公開存取，並且提交請求的格式正確。