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

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.15
File Size Uploaded
hanzo_tools_browser-0.5.15.tar.gz 42.9 kB Details

Built distribution (wheel)

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

Total release size: 82.1 kB

Release files / hanzo_tools_browser-0.5.15.tar.gz

Download URL hanzo_tools_browser-0.5.15.tar.gz
Size 42.9 kB
Tags Source
SHA-256 checksum
How to use checksums
77a694d8dd99948b512473816aec9b014da4681fa0466f0354a750b3c1e873e1
BLAKE2b-256 checksum
How to use checksums
3c5e759f974f7f8626836e59edd2494befb5df2c76ef166db0797220f1fd6431
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.15-py3-none-any.whl

Download URL hanzo_tools_browser-0.5.15-py3-none-any.whl
Size 39.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a9408b44cbbc7884ffe57fea3eaa5472c6645ad94aa4130d50c6282c58af94e3
BLAKE2b-256 checksum
How to use checksums
64b6da049e1c5420c2838acdb645b227c1241bd6618cecca1dfab5f6355a4c1d
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.15 This release

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