View source for Bot policy

<languages/>
{{Policy-cross-project}}
{{process header
 | title    = <translate><!--T:1--> Bot policy and guidelines</translate>
 | section  =
 | previous = {{pa|prev}} {{ll|Meta:Policies and guidelines|2=<translate><!--T:2--> Policies and guidelines</translate>}}
 | next     =
 | shortcut = [[BP]]
 | notes    = <translate><!--T:3-->
This page outlines standards and guidelines related to {{ll|bot|bots}} which are enforced on some projects (see [[<tvar name="2">Bot policy/Implementation</tvar>]]); this can be checked by visiting "<tvar name="1">Project:Bot policy</tvar>" on that wiki, which should point here or redirect to the local policy.

<!--T:4-->
'''This page is also policy on Meta, including [[<tvar name="1">#Automatic approval</tvar>|automatic approval]] and global bots.''' To request bot access on Meta, please go to [[<tvar name="2">Meta:Requests for adminship#Requests for bot flags</tvar>]].
</translate>
}}
[[File:Meta-Wiki Bot-2000px.png|150px|{{dir|{{PAGELANGUAGE}}|left|right}}]]
<translate>
<!--T:5-->
'''[[<tvar name="1">Special:MyLanguage/Bot</tvar>|Bots]]''' are automated or semi-automated [[<tvar name=2>{{lwp|process (computing)}}</tvar>|processes]] that edit pages with reduced or no direct human supervision. Because bots may potentially strain server resources or disrupt the project, bots must follow the policy and guidelines outlined below. The policy outlines the way bots may be used on applicable projects; bots which do not follow the policy may be blocked immediately until the operator has resolved any issues or non-compliance.

== Policy == <!--T:6-->

=== Bot account === <!--T:7-->

<!--T:8-->
A bot must be run using a separate account from the operator, as no human editor should be granted a bot flag. Its user page should clearly and visibly denote it as a bot to distinguish it from human editors, and '''operators must be available to answer any comments''' themselves. No user is permitted to make use of automated answering scripts. Some operators may choose to redirect the bot's talk page to their own, if their bot is not configured to detect messages.

=== Authorisation === <!--T:9-->

<!--T:10-->
There are three ways to obtain bot access on a wiki.
</translate>
{{Anchor|global}}
<translate>
==== Global bots ==== <!--T:11-->
</translate>
{{indent|1=
<translate><!--T:12-->
Global bots are given access on all wikis that allow global bots. As of November 12, 2022 and as a result of [[<tvar name="rfc">Requests for comment/Make all new wikis global bot wikis</tvar>|this RFC]], newly created content wikis will have global bot access enabled by default. Local projects can decide to opt-in or opt-out at any time through community consensus ([[<tvar name="1">Bot policy/Implementation#Where it is policy</tvar>|see list]]). Operators applying for a global bot flag must meet the following requirements:
</translate>
* <translate><!--T:49--> The bot operator must start a discussion that will last for 2 weeks at [[<tvar name="1">Steward requests/Bot status#Global bot status requests</tvar>]];</translate>
* <translate><!--T:50--> The discussion will be publicized via MassMessage ([[<tvar name="1">Bot policy/New global bot discussion</tvar>|New global bot discussion]]), where interested community members and wikis can be subscribed;</translate>
* <translate><!--T:51--> The bot operator must demonstrate the bot task is welcomed on multiple Wikimedia projects. A good way to show it is to be flagged on 5 or more wikis for a single task;</translate>
* <translate><!--T:52--> The operator should make sure to adhere to the wiki's preference as related to the use of the bot flag.</translate>
* <translate><!--T:15--> The global bot status gives the bot access to a restricted number of projects and wikis that allow global bot access. New wikis are added to this set by default. [[<tvar name="1">Special:WikiSets/14</tvar>|An exhaustive list of wikis that are not included]] is available. (You can request local bot flags on projects where global bots are not allowed.)</translate>
}}
<translate>
==== Automatic approval ==== <!--T:16-->
</translate>
{{indent|1=
<translate><!--T:17-->
If automatic approval is explicitly allowed on the wiki, bot operators can [[<tvar name="1">Steward requests/Bot status</tvar>|request a '''local''' bot flag directly from stewards]]. To qualify for this, the following requirements must be met:
</translate>
* <translate><!--T:18--> this must be permitted by the local bot policy or request page;</translate>
* <translate><!--T:19--> the bot must edit regularly without a bot flag for at least a week <u>or</u> make 100 edits on the applicable wikis for demonstration purposes;</translate>
* <translate><!--T:20--> the bot must ''only'' fix double-redirects.</translate>
}}
<translate>
==== Community consensus ==== <!--T:21-->
</translate>
{{indent|1=
<translate><!--T:22-->
Otherwise if there is a local community interested in processing bot applications, bots must obtain community approval on the most relevant local discussion page before editing without a bot flag at high speeds or without human supervision. Once there is consensus, a local bureaucrat will add the flag, or a [[<tvar name="1">Steward requests/Bot status</tvar>|steward may be requested to do so]].

<!--T:23-->
If there is no local community and the above does not apply, the bot must operate without a bot flag or not at all.
</translate>
}}
<translate>
=== Unacceptable usage === <!--T:24-->
</translate>
* <translate><!--T:25--> '''Controversial changes:''' Bots may be used to perform edits which are most likely supported by other local editors; they should ''never'' be used to perform controversial edits. If you intend to expand the scope of the bot beyond that which was supported by the community, make note of this at the relevant discussion page to ensure that there is no opposition. If your bot flag was given by automatic approval, you must not exceed the limits described under "[[<tvar name="1">#Automatic approval</tvar>|Automatic approval]]".</translate>
* <translate><!--T:26--> '''Data retrieval:''' Bots may '''not''' be used to retrieve bulk content for any use not directly related to an approved bot task. This includes dynamically loading pages from another website, which may result in the website being blacklisted and permanently denied access. If you would like to download bulk content or mirror a project, please do so by [[<tvar name="1">download:</tvar>|downloading or hosting your own copy of our database]].</translate>
* <translate><!--T:27--> '''Spellchecking:''' No bot may automatically correct spelling mistakes without explicit community approval, particularly in the main content namespace. It is not technically possible in most languages to automatically correct spelling mistakes without a significant margin of error.</translate>

<translate>
=== Removal of global bot status === <!--T:44-->
</translate>

<translate><!--T:45--> Global bot permissions will be removed:</translate>
* <translate><!--T:53--> At the bot's operator request</translate>
* <translate><!--T:54--> If the bot is persistently used to perform tasks that are outside the global bot remit</translate>
* <translate><!--T:55--> If the bot is found to be inactive, with the following provisions:</translate>
** <translate><!--T:56--> A global bot account is deemed inactive if it has not made any edits for a whole year on any project that allows global bot access.</translate>
** <translate><!--T:57--> Before a global bot account's permissions are removed on the basis of inactivity, its operator must be notified at least on their home wiki(s) and at Meta-Wiki.</translate>

<translate>
== Guidelines == <!--T:28-->

=== Name === <!--T:29-->

<!--T:30-->
Although not required, the bot name should clearly contain the word "bot" in its user name to more easily distinguish it from human editors; the most common forms are derived from the operator's username (such as <tvar name="1">[[w:User:Pathosbot|Pathosbot]]</tvar>), or using disambiguation style (such as <tvar name="2">[[s:User:Xenophon (bot)|Xenophon (bot)]]</tvar>).

=== Edit throttle and peak hours === <!--T:31-->

<!--T:32-->
Bots running without a bot flag should edit at intervals of over 1 minute between edits (= less than 1 edit per minute). Once they have been authorised and appropriately flagged, they should operate at an absolute minimum interval of 5 seconds (12 edits per minute). Bots should try to avoid running during the busiest hours, as they rapidly use server resources that should be reserved for human readers and editors. During these hours, they should operate at intervals of 20 seconds (3 edits per minute) to conserve resources.

<!--T:33-->
Bots' editing speeds can be automatically adjusted based on server load (slave database server lag) by appending an extra parameter to the query string of each requested URL; see [[<tvar name="1">mw:Special:MyLanguage/Manual:Maxlag parameter</tvar>|maxlag documentation on mediawiki]].

=== Supervision === <!--T:34-->

<!--T:35-->
Unless the bot is publicly stated to run autonomously, the operator should remain available, occasionally check for messages, and be ready to shut down the bot if it does not perform as desired or if complaints are received. If the operator is not available, the bot may be blocked until any issues are resolved.

== Best practices == <!--T:46-->

<!--T:47-->
Please read [[<tvar name="1">wikitech:Help:Toolforge/Developing successful tools</tvar>]] for strong recommendations that will make life easier for you and for everyone else in the future!
</translate>

<translate><!--T:48--> Briefly:</translate>
* <translate><!--T:58--> Pick a license</translate>
* <translate><!--T:59--> Publish the code</translate>
* <translate><!--T:60--> Have co-maintainers</translate>
* <translate><!--T:61--> Write some documentation</translate>

<translate>
== See also == <!--T:36-->
</translate>
{{Special global permissions/Seealso|global-bot}}

* <translate><!--T:37--> Global bot wikis: [[<tvar name="1">Special:WikiSets/2</tvar>|wikiset overview]] &bull; [<tvar name="url">{{fullurl:Special:Log|type=gblrights&page=Special:WikiSets/2}}</tvar> wikiset changelog]</translate>
* <translate><!--T:38--> [[<tvar name="1">Steward requests/Bot status</tvar>|Bot status request to stewards]]</translate>
* <translate><!--T:39--> About bots:</translate>
** {{ll|Bot}}
** <translate><!--T:41--> [[<tvar name="1">Special:MyLanguage/Interwiki bot</tvar>|Interwiki bot]] and [[<tvar name=2>Special:MyLanguage/Interwiki sorting order</tvar>|Interwiki sorting order]]</translate>
** <translate><!--T:42--> [[<tvar name="1">mw:Special:MyLanguage/Manual:Pywikibot</tvar>|Pywikibot framework]] (supports any MediaWiki installation)</translate>

[[Category:Bot policy{{#translation:}}]]
[[Category:Cross-project policies{{#translation:}}]]

{{user groups}}