Skip to main content

hanzo-tools-browser

Browser tools for Hanzo MCP: browser drives the user's own browser through the Hanzo extension (headless Playwright when none is connected), playwright is the same tool pinned to Playwright, and cdp sends a raw DevTools method.

Installation

pip install hanzo-tools-browser
pip install 'hanzo-tools-browser[playwright]' && playwright install chromium   # headless fallback

The loop

browser(action="navigate", url="https://example.com")
browser(action="snapshot", interactive=True)       # - button "Sign in" [ref=e2]
browser(action="click", selector="@e2")
browser(action="fill", selector="@e3", text="user@example.com")
browser(action="press", key="Enter")
browser(action="read", outline=True)               # the page as markdown
browser(action="screenshot", annotate=True)        # labels [N] = @eN, with a legend

selector takes a ref from the last snapshot or a CSS selector. A stale ref, or a click on an element covered by a banner or modal, is refused with what to do next.

Progressive surface

The schema carries the core actions: navigate, snapshot, click, fill, type, press, read, screenshot, evaluate, wait, tabs, help. browser(action="help") lists the rest by topic, and their parameters go in args:

browser(action="select", selector="@e4", args={"value": "Weekly"})

License

MIT

Metadata

Release files for hanzo-tools-browser 0.5.12

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hanzo-tools-browser 0.5.12
File Size Uploaded
hanzo_tools_browser-0.5.12.tar.gz 40.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hanzo-tools-browser 0.5.12
File Interpreter ABI Platform
hanzo_tools_browser-0.5.12-py3-none-any.whl Python 3 none any Details

Total release size: 76.4 kB

Release files / hanzo_tools_browser-0.5.12.tar.gz

Download URL hanzo_tools_browser-0.5.12.tar.gz
Size 40.0 kB
Tags Source
SHA-256 checksum
How to use checksums
ffdf8a25ebffe53c81de80cb38db9a9a14f2d02d7f4986eb65d6ed6a9365ba1a
BLAKE2b-256 checksum
How to use checksums
b55683b8a7da5cd0995816402846770bd7285edd17ddf5ca6ea8ac66c807a512
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.9

Release files / hanzo_tools_browser-0.5.12-py3-none-any.whl

Download URL hanzo_tools_browser-0.5.12-py3-none-any.whl
Size 36.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a2e84ad76a75085fa57b3a47bfae052da17d4ca1ea0a790b5314b0179f4b734c
BLAKE2b-256 checksum
How to use checksums
bd7629fca28d50c5de42ec1012686d512a6d8487529510e89054cd7764f1f9d8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.9

Release history Release notifications | RSS feed

0.5.15

2 release files

This release

0.5.12 This release

2 release files

0.5.11

2 release files

0.5.9

2 release files

0.5.8

2 release files

0.5.7

2 release files

0.5.6

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.0

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page