---
id: mechanize
version: "0.4.10"
license: BSD
license_treatment: permissive
maintenance: aging
---

# mechanize — Stateful, programmatic web browsing

License: permissive · Maintenance: aging · Downloads: 364.6K/mo

## What it is and what it does

mechanize is a Python library that lets you write code to interact with websites as if you were a browser—opening URLs, filling and submitting forms, following links, and managing browser history. It wraps around html5lib for HTML parsing and provides a stateful interface modeled on urllib2, so you can automate repetitive web tasks without running a full browser. It handles common web conventions automatically: adding the Referer header, respecting robots.txt, and processing HTTP-Equiv and Refresh directives.

The library is useful for web scraping, testing, site monitoring, and automation tasks where you need to interact with forms or navigate between pages programmatically. It's a mature, production-stable tool that has been maintained since 2008, though releases have slowed in recent years.

Use it for:

- Scrape data from websites that require form submission and multi-step navigation.
- Automate login flows and session management for testing or monitoring tasks.
- Build link checkers or site crawlers that need to follow and validate page hierarchies.
- Test web applications by simulating user interactions like form filling and submission.
- Monitor websites for changes by fetching and parsing pages programmatically.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Automate programmatic interaction with HTTP web servers by simulating a stateful browser—fill forms, follow links, manage history, and parse HTML without a GUI.

Yes, if you need lightweight programmatic web interaction without a full browser engine. The low install friction, permissive license, and stable API make it suitable for automation and scraping tasks. However, consider that maintenance is aging—last release was 840 days ago—so evaluate whether the package meets your Python version and modern web compatibility needs before committing to a new project.

## Install

pip install mechanize
uv add mechanize
poetry add mechanize

## Installing mechanize

Before you install: Low install friction; single dependency on html5lib. Maintenance status is aging—last release was 840 days ago, though the repository remains active with a recent commit on 2025-05-26 and 759 stars.

License in practice: BSD license (permissive); you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install mechanize

import mechanize
browser = mechanize.Browser()
browser.open('http://example.com')
for link in browser.links():
    print(link.text, link.url)

Verify before relying:

- Whether the package works reliably with modern Python versions (requires_python is unspecified in metadata).
- Current state of compatibility with modern web standards and HTML5 parsing edge cases.
- Whether the aging maintenance status signals planned deprecation or stable legacy support.

## Package facts

- License: BSD (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 364.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

web scraping automation, programmatic browser, HTTP form filling, web automation python, stateful web client, HTML link following, web crawler library, web-automation, scraping, testing

[View on SkillFed](https://skillfed.io/packages/mechanize) · [View on PyPI](https://pypi.org/project/mechanize/)