browser-automation

What I do

• Provide a safe, composable workflow for browsing tasks
• Use

  browser_query

  list and index selection to click reliably
• Confirm state changes after each action

Best-practice workflow

1. Inspect tabs with

   browser_get_tabs

2. Open new tabs with

   browser_open_tab

   when needed
3. Navigate with

   browser_navigate

   if needed
4. Wait for UI using

   browser_query

   with

   timeoutMs

5. Discover candidates using

   browser_query

   with

   mode=list

6. Click, type, or select using

   index

7. Confirm using

   browser_query

   or

   browser_snapshot

Selecting options

• Use

  browser_select

  for native

  <select>

  elements
• Prefer

  value

  or

  label

  ; use

  optionIndex

  when needed
• Example:

  browser_select({ selector: "select", value: "plugin" })

Query modes

• text

  : read visible text from a matched element

• value

  : read input values

• list

  : list many matches with text/metadata

• exists

  : check presence and count

• page_text

  : extract visible page text

Opening tabs

• Use

  browser_open_tab

  to create a new tab, optionally with

  url

  and

  active

• Example:

  browser_open_tab({ url: "https://example.com", active: false })

Troubleshooting

• If a selector fails, run

  browser_query

  with

  mode=page_text

  to confirm the content exists
• Use

  mode=list

  on broad selectors (

  button

  ,

  a

  ,

  *[role="button"]

  ) and choose by index
• Confirm results after each action