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.16

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.16
File Size Uploaded
hanzo_tools_browser-0.5.16.tar.gz 43.2 kB Details

Built distribution (wheel)

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

Total release size: 82.5 kB

Release files / hanzo_tools_browser-0.5.16.tar.gz

Download URL hanzo_tools_browser-0.5.16.tar.gz
Size 43.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f03dd88bc15186874851b0332bcf941e8e7597b7499e5d3a0a4feb55637eb2a5
BLAKE2b-256 checksum
How to use checksums
92b35ee6b552d0cd7da2ac67ea92203aee398e5e2f2e6a72e3b3e716fc01abb6
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.16-py3-none-any.whl

Download URL hanzo_tools_browser-0.5.16-py3-none-any.whl
Size 39.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
033bfdc38854ec1988da0e4c910b2e24a8cb77cc020323eeee7943e150386378
BLAKE2b-256 checksum
How to use checksums
67592d2747db500ed72c8b0e24538553ee8d91f0695e83b7c04184c2f367d81b
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

This release

0.5.16 This release

2 release files

0.5.15

2 release files

0.5.12

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