Manual:Pywikibot/Create your own script

This page lists some very basic tips for getting started writing your own bot. Make sure you've set up your  file!

You can either use the following commands in a shell, or in a script.

To open a shell, run ;

As a script, please save the file as  in the   directory, then run.


 * To gain access to the pywikibot library from your Python script, use:


 * to retrieve a page, use the following, where pageName is the title of the page you would like to retrieve, e.g., Wikipedia:Bots or India:


 * to update a page, use:


 * look at some of the pywikibot files for other ideas --  is relatively easy to read even if you're new to pywikibot.


 * you can find all available Page methods in the  file.


 * gives you a setup that can be used for many different bots, all you have to do is define the string editing on the page text.


 * To iterate over a set of pages, see pywikibot/pagegenerators.py (see also old-doc>Special:MyLanguage/Manual:Pywikibot/pagegenerators.py|old documentation) for some objects that return a set of pages. An example use of the CategoryPageGenerator that does something for each page in the Category:Living people category: