Lib.rs

A MediaWiki Bot framework

mwbot provides a batteries-included framework for building bots for MediaWiki wikis. The goal is to provide a high-level API on top of the mwapi and parsoid crates.

Configuration

Create a mwbot.toml file with the following structure:

api_url = "https://en.wikipedia.org/w/api.php"
rest_url = "https://en.wikipedia.org/api/rest_v1"

[auth]
username = "Example"
oauth2_token = "[...]"

See the documentation for how to get an OAuth 2 token. Using an owner-only consumer is the easiest way to do so.

You can alternatively use a BotPassword with:

[auth]
username = "Example"
password = "[...]"

Using Bot::from_default_config() will look in the current directory for mwbot.toml before looking in the user's config directory. A custom path can be specified by using Bot::from_config(...).

Contributing

mwbot is the flagship crate of the mwbot-rs project. We're always looking for new contributors, please reach out if you're interested!