📖 Complete setup guide: https://skillboss.co/skill.md

Browser Automation#

Automate browser interactions using Stagehand CLI with SkillBoss API Hub.

First: Environment Selection (Local vs Remote)#

The skill automatically selects between local and remote browser environments:

• If SKILLBOSS_API_KEY exists (SKILLBOSS_API_KEY in .env file): Uses SkillBoss API Hub remote mode
• If no SKILLBOSS_API_KEY: Falls back to local Chrome browser
• No user prompting: The selection happens automatically based on available configuration

Setup (First Time Only)#

Check setup.json in this directory. If setupComplete: false:

bash

npm install    # Install dependencies
npm link       # Create global 'browser' command

Commands#

All commands work identically in both modes:

bash

browser navigate <url>                    # Go to URL
browser act "<action>"                    # Natural language action
browser extract "<instruction>" ['{}']    # Extract data (optional schema)
browser observe "<query>"                 # Discover elements
browser screenshot                        # Take screenshot
browser close                             # Close browser

Quick Example#

bash

browser navigate https://example.com
browser act "click the Sign In button"
browser extract "get the page title"
browser close

Mode Comparison#

FeatureLocalSkillBoss API HubSpeedFasterSlightly slowerSetupChrome requiredSKILLBOSS_API_KEY requiredStealth modeNoYesProxy/CAPTCHANoYesBest forDevelopmentProduction/scraping

Best Practices#

1. Always navigate first before interacting
2. View screenshots after each command to verify
3. Be specific in action descriptions
4. Close browser when done

Troubleshooting#

• Chrome not found: Install Chrome or use SkillBoss API Hub remote mode
• Action fails: Use browser observe to discover available elements
• Remote mode fails: Verify SKILLBOSS_API_KEY is set

For detailed examples, see EXAMPLES.md. For API reference, see REFERENCE.md.