Skip to main content

Stateful, programmatic web browsing

Project description

Latest version released on PyPi Build status of the master branch

<nav class="contents" id="contents" role="doc-toc">



Major features

Stateful programmatic web browsing in Python

  • The browser class mechanize.Browser implements the interface of urllib2.OpenerDirector, so any URL can be opened not just http.

  • Easy HTML form filling.

  • Convenient link parsing and following.

  • Browser history (.back() and .reload() methods).

  • The Referer HTTP header is added properly (optional).

  • Automatic observance of robots.txt.

  • Automatic handling of HTTP-Equiv and Refresh.


To install for normal usage:

pip3 install mechanize

To install for development:

git clone
cd mechanize
pip3 install -e .

To install manually, simply add the mechanize sub-directory somewhere on your PYTHONPATH.




python-mechanize was the creation of John J. Lee. Maintenance was taken over by Kovid Goyal in 2017.

Much of the code was originally derived from the work of the following people:

  • Gisle Aas – [libwww-perl]

  • Jeremy Hylton (and many others) – [urllib2]

  • Andy Lester – [WWW::Mechanize]

  • Johnny Lee (coincidentally-named) – MSIE CookieJar Perl code from which mechanize’s support for that is derived.


  • Gary Poster and Benji York at Zope Corporation – contributed significant changes to the HTML forms code

  • Ronald Tschalar – provided help with Netscape cookies

Thanks also to the many people who have contributed bug reports and patches.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mechanize-0.4.8.tar.gz (218.1 kB view hashes)

Uploaded source

Built Distribution

mechanize-0.4.8-py2.py3-none-any.whl (110.3 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page