Robots exclusion standard

:selfref|"For restricting Wikipedia bots, see ".|

The robot exclusion standard, also known as the Robots Exclusion Protocol or robots.txt protocol, is a convention to prevent cooperating web spiders and other web robots from accessing all or part of a website which is otherwise publicly viewable. Robots are often used by search engines to categorize and archive web sites, or by webmasters to proofread source code. The standard complements Sitemaps, a "robot inclusion standard" for websites.

About the standard

A robots.txt file on a website will function as a request that specified robots ignore specified files or directories in their search. This might be, for example, out of a preference for privacy from search engine results, or the belief that the content of the selected directories might be misleading or irrelevant to the categorization of the site as a whole, or out of a desire that an application only operate on certain data.

For websites with multiple sub-domains, each sub-domain must have its own robots.txt file. If example.com had a robots.txt file but a.example.com did not, the rules that would apply for example.com will not apply to a.example.com.

Disadvantages

The protocol, however, is purely advisory. It relies on the cooperation of the web robot, so that marking an area of a site out of bounds with robots.txt does not guarantee privacy. Some web site administrators have tried to use the robots file to make private parts of a website invisible to the rest of the world, but the file is necessarily publicly available and its content is easily checked by anyone with a web browser.

There is no official standards body or RFC for the robots.txt protocol. It was [http://www.robotstxt.org/wc/norobots.html created by consensus] in June 1994 by members of the robots mailing list ([e-mail]). The information specifying the parts that should not be accessed is specified in a file called robots.txt in the top-level directory of the website. The robots.txt patterns are matched by simple substring comparisons, so care should be taken to make sure that patterns matching directories have the final '/' character appended, otherwise all files with names starting with that substring will match, rather than just those in the directory intended.

Automated Content Access Protocol

ACAP, which is a possible plug-in for the Robots Exclusion Standard, was released as v1.0 on November 30, 2007.

robots.txt search engine

Of recent interest is the percentage of website pages that have robots.txt files and which specific robots are given privileges to crawl specific website files. To help understand these issues, a publicly available robots.txt search engine, BotSeer, has been developed to search and index robots.txt files.

Examples

This example allows all robots to visit all files because the wildcard "*" specifies all robots:User-agent: *Disallow:

This example keeps all robots out:User-agent: *Disallow: /

The next is an example that tells all crawlers not to enter four directories of a website:User-agent: *Disallow: /cgi-bin/Disallow: /images/Disallow: /tmp/Disallow: /private/

Example that tells a specific crawler not to enter one specific directory:User-agent: BadBot # replace the 'BadBot' with the actual user-agent of the botDisallow: /private/

Example that tells all crawlers not to enter one specific file:User-agent: *Disallow: /directory/file.html

Note that all other files in the specified directory will be processed.

Example demonstrating how comments can be used:
# Comments appear after the "#" symbol at the start of a line, or after a directiveUser-agent: * # match all botsDisallow: / # keep them out

Compatibility

In order to prevent access to all pages by robots, do not use

Disallow: * # DO NOT USE! Use "/" instead.

as this is not a stable standard extension.

Instead:Disallow: /should be used.

Nonstandard extensions

Crawl-delay directive

Several major crawlers support a Crawl-delay parameter, set to the number of seconds to wait between successive requests to the same server: [cite web |url=http://help.yahoo.com/l/us/yahoo/search/webcrawler/slurp-03.html |title=How can I reduce the number of requests you make on my web site? |accessdate=2007-03-31 |format=HTML |work=Yahoo! Slurp ] [cite web |url=http://search.msn.com/docs/siteowner.aspx?t=SEARCH_WEBMASTER_FAQ_MSNBotIndexing.htm&FORM=WFDD#D |title=MSNBot is crawling a site too frequently |accessdate=2007-02-08 |format=HTML |work=Troubleshoot issues with MSNBot and site crawling ]

User-agent: *Crawl-delay: 10

Allow directive

Some major crawlers support an Allow directive which can counteract a following Disallow directive. [cite web |url=http://www.google.com/support/webmasters/bin/answer.py?answer=40364
title=Webmaster Help Center - How do I block Googlebot? |accessdate=2007-11-20 | format=HTML] [cite web
url=http://help.yahoo.com/l/us/yahoo/search/webcrawler/slurp-02.html
title=How do I prevent my site or certain subdirectories from being crawled? - Yahoo Search Help | accessdate=2007-11-20 | format=HTML ] This is useful when you disallow an entire directory but still want some HTML documents in that directory crawled and indexed. It should be noted that while by standard the first matching robots.txt pattern always wins, Google's implementation differs in that it first evaluates all Allow patterns and only then all Disallow patterns. Yet, in order to be compatible to all robots, if you want to allow single files inside an otherwise disallowed directory, you need to place the Allow directive(s) first, followed by the Disallow, for example:

Allow: /folder1/myfile.htmlDisallow: /folder1/

This example will Disallow anything in /folder1/ except /folder1/myfile.html, since the latter will match first. In case of Google, though, the order is not important.

Extended standard

An [http://www.conman.org/people/spc/robots2.html Extended Standard for Robot Exclusion] has been proposed, which adds several new directives, such as Visit-time and Request-rate. For example:

User-agent: *Disallow: /downloads/Request-rate: 1/5 # maximum rate is one page every 5 secondsVisit-time: 0600-0845 # only visit between 06:00 and 08:45 UTC (GMT)

The first version of the Robot Exclusion standard does not mention anything about the "*" character in the Disallow: statement. Modern crawlers like Googlebot and Slurp recognize strings containing "*", while MSNbot and Teoma interpret it in different ways. [cite web |url=http://www.ghita.ro/article/23/web_robots_and_dynamic_content_issues.html#problems |title=Web robots and dynamic content issues |accessdate=2007-04-01 |format=HTML |work=MSNbot issues with robots.txt ]

References

ee also

*Distributed web crawling
*Focused crawler
*Internet Archive
*Library of Congress Digital Library project
*National Digital Information Infrastructure and Preservation Program
*nofollow and Spam in blogs
*Spider trap
*Web archiving
*Web crawler
*Meta Elements for Search Engines

External links

* [http://robots.googletoad.com Online Robots.txt Generator]
* [http://www.robotstxt.org/wc/exclusion.html Robots Exclusion]
* [http://www.google.com/support/webmasters/bin/topic.py?topic=8843 How Google Crawls My Site]
* [http://www.google.com/support/webmasters/bin/answer.py?answer=35237&query=robots.txt&topic=&type= Using the robots.txt analysis tool]
* [http://www.mediawiki.org/wiki/Robots.txt About Robots.txt at the Mediawiki website]
* [http://www.kloth.net/internet/badbots.php List of Bad Bots] - rogue robots and spiders which ignore these guidelines
* [http://www.searchtools.com/robots/robots-txt.html More info about Robots.txt]
* [http://en.wikipedia.org/robots.txt Wikipedia's Robots.txt - an example]
* [http://www.mcanerin.com/EN/search-engine/robots-txt.asp Robots.txt Generator + Tutorial]
* [http://www.howrank.com/Robots.txt-Tool.php Robots.txt Generator Tool]
* [http://www.diovo.com/2008/09/robotstxt-is-not-a-security-measure/ Robots.txt is not a security measure]
* [http://yro.slashdot.org/comments.pl?sid=377285&cid=21554125 The history behind robots.txt]
* [http://botseer.ist.psu.edu/ BotSeer, Robots.txt search engine]