Files
python-sdk/pkg/hanzo-tools-browser
zeekay 167ed4ed80 fix(browser): auto-start CDP bridge on BrowserTool init
The CDP bridge server (ws://localhost:9223 + http://localhost:9224)
was never starting because the entrypoint loader instantiates
BrowserTool directly, bypassing the package-level register_tools()
which called start_cdp_bridge().

Now BrowserTool.__init__() auto-starts the bridge when backend is
not "playwright", ensuring the browser extension can connect and
be used as the preferred backend over headless Playwright.
2026-03-06 00:32:42 -08:00
..

hanzo-tools-browser

Browser automation tools for Hanzo MCP using Playwright.

Installation

pip install hanzo-tools-browser

Tools

browser - Complete Playwright API

70+ browser actions for full automation.

Navigation:

browser(action="navigate", url="https://example.com")
browser(action="go_back")
browser(action="reload")

Input:

browser(action="click", selector="button.submit")
browser(action="fill", selector="input[name=email]", text="[email protected]")
browser(action="type", selector="textarea", text="Hello")

Touch/Mobile:

browser(action="tap", selector=".button")
browser(action="swipe", selector=".carousel", direction="left")
browser(action="emulate", device="mobile")  # or tablet, laptop

Assertions:

browser(action="expect_visible", selector=".modal")
browser(action="expect_text", selector="h1", expected="Welcome")
browser(action="expect_url", expected="*/dashboard*")

Content:

browser(action="get_text", selector=".content")
browser(action="screenshot", full_page=True)
browser(action="pdf")

Parallel Agents:

# Each agent gets isolated session
browser(action="new_context")  # Separate cookies/storage

Device Presets:

  • mobile - iPhone-like (390x844, touch)
  • tablet - iPad-like (1024x1366, touch)
  • laptop - MacBook-like (1440x900)
  • iphone_14, pixel_7, ipad_pro, etc.

License

MIT