Browser

​

Key Features

• Screenshot Rendering - Capture web page screenshots
• Structured Data - Extract HTML and page text
• JavaScript Support - Pages with dynamic content fully rendered
• Custom Viewport - Control screen resolution
• Element Interaction - Click, scroll, form fill (advanced)
• Network Isolation - Secure rendering environment

​

How to Enable

​

For Agents

1. Agents > Select Agent > Settings > Capabilities
2. Attach Browser

​

For MCP Gateways

1. Gateways > Select Gateway > Capabilities
2. Attach Browser

​

Usage Examples

​

Capture Screenshot

Render https://example.com to a screenshot

• PNG image of rendered page
• Page title and URL
• Viewport dimensions

​

Extract Page Content

Get the text content from https://news.example.com/article

• Full page text (markdown formatted)
• Headings and structure
• Links and metadata

​

Capture Dynamic Page

Screenshot the dashboard at https://app.example.com/dashboard

​

Rendering Options

​

Screenshot

{
  "url": "https://example.com",
  "action": "screenshot",
  "viewport": {
    "width": 1280,
    "height": 720
  }
}

​

HTML Extraction

{
  "url": "https://example.com",
  "action": "html"
}

​

Text Extraction

{
  "url": "https://example.com",
  "action": "text"
}

​

Configuration

{
  "browser": {
    "timeout_seconds": 30,
    "viewport_width": 1280,
    "viewport_height": 720,
    "javascript_enabled": true,
    "timeout_wait_until": "networkidle"
  }
}

​

Advanced Features

​

Wait Conditions

• load - DOM loaded
• domcontentloaded - Initial HTML parsed
• networkidle - Network quiet (default)

​

Custom Headers

{
  "headers": {
    "User-Agent": "Custom Agent",
    "Authorization": "Bearer token"
  }
}

​

Cookies

{
  "cookies": [
    {
      "name": "session",
      "value": "abc123"
    }
  ]
}

​

Common Use Cases

​

Price Monitoring

Screenshot product pages to track price changes

1. Render competitor pages
2. Extract prices
3. Compare with your prices

​

Content Scraping

Extract article text from news sites

1. Get page text
2. Parse structure
3. Extract key information

​

Visual Testing

Screenshot app at different breakpoints

1. Render at desktop size
2. Render at mobile size
3. Compare visuals

​

Data Extraction

Get structured data from tables and lists

1. Get HTML
2. Parse with Code Runner
3. Extract data

​

Resource Limits

​

Cost

​

Browser vs Computer Browser

​

Limitations

• Stateless: no session persistence between requests
• Cannot maintain logged-in state (use Computer for that)
• Cannot interact with complex multi-step JS applications
• Some sites may block automated rendering
• Timeouts on very slow pages

​

Best Practices

​

Use Screenshots for Visual Content

• Product pages
• Design verification
• Visual inspection
• Chart/graph capture

​

Use Text for Content Extraction

• Article content
• Structured data
• Link extraction
• SEO information

​

Set Appropriate Timeouts

{
  "timeout_seconds": 30,
  "timeout_wait_until": "networkidle"
}

​

Handle Errors Gracefully

​

Troubleshooting

​

Screenshot is blank

• Page loading failed
• Wrong viewport size
• Page requires authentication
• Try increasing timeout

​

Timeout error

• Page too slow
• Waiting for external resources
• Reduce timeout or increase wait condition
• Simplify the URL

​

Access denied

• Site blocking automated access
• Use different User-Agent header
• Try at different time

​

Content missing

• Content loaded via JavaScript asynchronously
• Increase timeout
• Use “load” wait condition instead of “networkidle”

​

Privacy & Security

• Rendering is isolated per request
• No cookies stored between requests
• Headers/auth not retained
• Rendered pages not logged
• Results deleted after delivery

​

Next Steps

• Computer Capability — Stateful browser with persistent sessions
• Web Search - Find Content
• HTTP Client - API Access
• Code Runner - Process Data