# MCP Browser Tool

Alat browser otomatis berbasis **Playwright** untuk **AI Agent** yang memungkinkan agent melakukan pencarian web, navigasi, scraping, dan otomatisasi halaman melalui protokol **Model Context Protocol (MCP)**.

## Fitur

- **Pencarian Web** - Cari informasi dari berbagai mesin pencari (DuckDuckGo, Bing, Brave, Mojeek)
- **Navigasi Halaman** - Buka URL, scroll, back/forward, refresh halaman
- **Scraping Konten** - Ambil teks, HTML, screenshot, tabel, dan JSON-LD dari halaman
- **Interaksi Halaman** - Klik elemen, ketik teks, tekan tombol keyboard, upload file
- **Manajemen Tab** - Buka, tutup, dan pindah antar tab browser (maks. 8 tab)
- **Session Management** - Simpan dan muat session browser (termasuk cookies & localStorage)
- **Anti Deteksi** - Stealth mode untuk menghindari deteksi bot
- **Network Monitoring** - Tangkap dan filter request/response API

## Cara Penggunaan

### Prasyarat

- Node.js 18+
- Playwright browser binaries (install dengan `npx playwright install chromium`)

### Instalasi

```bash
npm install
npx playwright install chromium
npm run build
```

### Menjalankan

```bash
npm start
```

Atau untuk development:

```bash
npm run dev
```

### Konfigurasi MCP

Tambahkan ke konfigurasi MCP client (seperti Claude Desktop, Zed, Nalar, dll.):

```json
{
  "mcpServers": {
    "browser-tool": {
      "command": "node",
      "args": ["/path/to/mcp-browser-tool/dist/index.js"]
    }
  }
}
```

#### Opsi CLI

| Argumen | Deskripsi |
|---------|-----------|
| `--sessions-dir <path>` | Tentukan direktori untuk menyimpan session browser (default: `sessions/` di folder project) |
| `--downloads-dir <path>` | Tentukan direktori untuk menyimpan file download (default: `downloads/` di folder project) |

Contoh dengan direktori kustom:

```json
{
  "mcpServers": {
    "browser-tool": {
      "command": "node",
      "args": [
        "/path/to/mcp-browser-tool/dist/index.js",
        "--sessions-dir", "/path/ke/sessions",
        "--downloads-dir", "/path/ke/downloads"
      ]
    }
  }
}
```

> **Catatan:** Secara default, direktori `sessions/` dan `downloads/` dibuat di dalam folder `mcp-browser-tool` itu sendiri — **bukan** di current working directory (CWD) proses. Ini mencegah polusi direktori di project lain saat MCP server dijalankan.

## Lisensi

MIT