indexnow/SKILL.md
Facts to use
- IndexNow is a protocol to tell participating search engines that a URL changed. Microsoft Bing takes part. Participating engines share submitted URLs with each other. Google is not listed as a participant on indexnow.org.
- The site hosts a key file: a UTF-8 text file at the root, for example
https://example.com/<key>.txt, that contains the key. A key file in a subfolder (named withkeyLocation) covers only URLs in that folder. - One POST can submit up to 10,000 URLs for one host.
- Submit URLs when they are added, updated or deleted. Do not resubmit URLs that did not change.
Workflow
- Generate a key (8 to 128 characters: letters, digits and dashes).
- Publish
/<key>.txtwith the key as its only content. Check that it returns 200. - Submit changed URLs:
curl -X POST "https://api.indexnow.org/indexnow" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{"host":"example.com","key":"YOUR_KEY","keyLocation":"https://example.com/YOUR_KEY.txt","urlList":["https://example.com/pricing"]}' - 200 means the URLs were received. 202 means they were received and the key check is pending. 400 means the request format is wrong. 403 means the key is not valid (key file not found, or the key is not in the file). 422 means a URL does not belong to the host, or the key does not match the protocol. 429 means too many requests (possible spam).
- Automate: call the endpoint from the deploy pipeline or CMS publish hook with only the changed URLs.
- Check the IndexNow page in Bing Webmaster Tools for received URLs.
Output
The key file path, the automation code, and the response codes from a test submit.
Sources
- IndexNow documentation. https://indexnow.org/documentation
- IndexNow: Documentation for search engines. https://indexnow.org/searchengines