> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser Automation

> The browser tool — navigate, interact with, and extract content from web pages.

## Overview

The `browser` tool provides web browsing capabilities to your agent. It can navigate to URLs, interact with page elements, extract content, and take screenshots. This is powered by a headless browser (Playwright) running on the host system.

## Capabilities

| Action | Description |
| - | - |
| `navigate` | Open a URL in the browser |
| `click` | Click on an element |
| `type` | Type text into an input field |
| `extract` | Extract text content from the page |
| `screenshot` | Take a screenshot of the page |
| `scroll` | Scroll the page |
| `wait` | Wait for an element or condition |

## Usage Examples

### Navigating and Extracting

The agent can browse a website and extract relevant information:

```json theme={null}
{
  "tool": "browser",
  "input": {
    "action": "navigate",
    "url": "https://news.ycombinator.com"
  }
}
```

Followed by:

```json theme={null}
{
  "tool": "browser",
  "input": {
    "action": "extract",
    "selector": ".titleline"
  }
}
```

### Form Interaction

```json theme={null}
{
  "tool": "browser",
  "input": {
    "action": "type",
    "selector": "#search-input",
    "text": "ArgentOS documentation"
  }
}
```

## Configuration

```json theme={null}
{
  "agents": {
    "defaults": {
      "browser": {
        "headless": true,
        "timeout": 30000,
        "viewport": { "width": 1280, "height": 720 }
      }
    }
  }
}
```

## Prerequisites

The browser tool requires Playwright to be installed:

```bash theme={null}
npx playwright install chromium
```

## Security Considerations

<Warning>
  The browser runs with the same permissions as the ArgentOS process. Be cautious with agents that have both browser and exec tools -- they can be powerful in combination.
</Warning>

* Consider restricting allowed domains in production environments
* Cookie and session data persists between browser actions within a session

## Limitations

<Note>
  * Browser state does not persist across gateway restarts
  * JavaScript-heavy SPAs may require explicit wait conditions
  * File downloads through the browser require separate handling
  * The browser runs headless by default; there is no visual UI to observe
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.