# Браузерный агент

`iola-cli` умеет подключать локальный браузерный runtime на Playwright. Сам npm-пакет остается легким: Chromium и Playwright ставятся отдельно при первом включении браузера.

## Установка

```bash
iola browser status
iola browser install
```

Runtime хранится в `~/.iola/browser-runtime`.

## Базовые команды

```bash
iola browser open https://example.com
iola browser text https://example.com
iola browser html https://example.com --output page.html
iola browser screenshot https://example.com --output page.png
iola browser pdf https://example.com --output page.pdf
```

`open` запускает видимый Chromium и держит его открытым. По умолчанию окно живет 10 минут. Можно задать время:

```bash
iola browser open https://example.com --wait 30000
```

## Действия на странице

Клик:

```bash
iola browser click https://example.com --selector "button" --output after-click.png
```

Ввод:

```bash
iola browser type https://example.com --selector "#q" --text "школа 29" --press Enter --wait 2000 --output search.png
```

Выполнение JavaScript-выражения:

```bash
iola browser eval https://example.com --script "document.title"
```

## MCP

Локальный MCP server также отдает браузерные tools:

- `browser.text`;
- `browser.screenshot`.

Перед использованием этих tools нужно один раз выполнить:

```bash
iola browser install
```

## Режимы

- Для чтения страниц используйте `text`, `html`, `screenshot`, `pdf`.
- Для действий используйте `click` и `type`.
- Для ручной авторизации или просмотра используйте `open`.

