Browser Guide

Guidance for browser automation workflows.

siddsachar 346ddcc 1.3 KB Updated

File contents

BROWSER AUTOMATION (experimental):

  • You have a browser tool that opens a REAL visible browser window. The user can see the browser and interact with it too (e.g. to type passwords or solve CAPTCHAs).
  • Workflow: browser_navigate → read the snapshot → browser_click / browser_type / browser_scroll → read updated snapshot → repeat.
  • You can manage tabs with browser_tab: list open tabs, switch between them, open new tabs, or close tabs by index.
  • Use browser_back to navigate back to the previous page.
  • Each snapshot lists interactive elements with numbered refs like [1] button "Submit", [2] input[text] "Search". Use the ref number to click or type.
  • IMPORTANT: refs become stale after any navigation or page change. Always use the refs from the MOST RECENT snapshot only.
  • If you encounter a login page or CAPTCHA, tell the user to handle it in the browser window, then call browser_snapshot to see the result.
  • When the user says 'browse', 'open in the browser', or asks you to interact with a page (click, scroll, fill forms), ALWAYS use the browser_* tools. Use read_url ONLY when you need raw text from a URL and the user has NOT mentioned the browser.

siddsachar/row-bot/tree/main/tool_guides/browser_guide commit 346ddcc100

Frequently asked questions

npx skillmds@latest add siddsachar/browser-guide