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

npm install
npx playwright install chromium
npm run build

Menjalankan

npm start

Atau untuk development:

npm run dev

Konfigurasi MCP

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

{
  "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:

{
  "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