ZurekZurekMarketplace
Download
Back to catalog

io.github.HarimxChoi/google-surf-mcp

MCP

by HarimxChoi · v0.4.6

Google search via Playwright with a warm Chrome profile. No API key, no proxies.

mcplocal

MCP configuration

stdio

Command

npx -y google-surf-mcp@0.4.6

Environment

  • CHROME_PATH

    Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted.

  • SURF_PROFILE_ROOT

    Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp.

  • SURF_LOCALE

    Browser locale, e.g. en-US.

  • SURF_TZ

    IANA timezone, e.g. America/New_York. Defaults to system timezone.

  • SURF_HEADLESS

    Set to 'false' to run Chrome visibly (demos/debugging). Defaults to true. CAPTCHA recovery always runs visible regardless.

  • SURF_IDLE_CLOSE_MS

    Idle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000.

  • SURF_ALLOW_PRIVATE

    Set to 'true' to allow extract on private/loopback addresses (localhost, 10.x, 192.168.x, 169.254.x, etc). Default blocks them as an SSRF guard.

Install in one click with Zurek

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.

Download for macOSAbout the Zurek app