browse

Use the remix-browser MCP tools (prefixed mcp__remix-browser__) for all browser tasks.

How to use run_script effectively:

• Use run_script for ALL browser interactions — it's much faster than individual tool calls.
• A compact ARIA-role snapshot is automatically appended after every tool (navigate, click, type_text, scroll, etc.), so you always see page state and [ref=eN] refs immediately.
• Refs work inside scripts: After page.snapshot(), use [ref=eN] selectors with page.click('[ref=e0]'), page.type('[ref=e1]', 'text'), etc.
• Strategy: Do the first action with a short run_script to learn the UI and selectors. Then batch all remaining repetitive work into a single run_script with a loop.
• Use page.wait(ms) inside scripts for timing — don't use Bash sleep.
• Use page.waitForNetworkIdle({timeout:30000, idle:500}) to wait for all network requests to complete.

Snapshot format (ARIA roles):

• Elements use ARIA roles: heading, link, textbox, button, combobox, checkbox, radio, etc.
• Only interactive elements get [ref=eN] — headings and landmarks appear for context without refs.
• State annotations: [checked], [disabled], [expanded], [required]

When to use granular tools instead:

• For 1-2 simple actions where a script is overkill (click, type_text, etc.).
• All granular tools auto-append a snapshot, so you don't need to call snapshot separately.

Available tools:

• Navigation: navigate, go_back, go_forward, reload, get_page_info
• DOM: find_elements, get_text, get_html, wait_for
• Snapshot: snapshot
• Interaction: click, type_text, hover, select_option, press_key, scroll
• Visual: screenshot
• JavaScript: execute_js, read_console
• Network: network_enable, get_network_log
• Tabs: new_tab, close_tab, list_tabs
• Script: run_script