io.github.HarimxChoi
google-surf-mcp
Google search via Playwright with a warm Chrome profile. No API key, no proxies.
stdiocommunityservice
Package Details
google-surf-mcp
Transportstdio
Environment Variables
CHROME_PATH(str)
Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted.
SURF_PROFILE_ROOT(str)
Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp.
SURF_LOCALE(str)
Browser locale, e.g. en-US.
SURF_TZ(str)
IANA timezone, e.g. America/New_York. Defaults to system timezone.
SURF_HEADLESS(str)
Set to 'false' to run Chrome visibly (demos/debugging). Defaults to true. CAPTCHA recovery always runs visible regardless.
SURF_IDLE_CLOSE_MS(str)
Idle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000.
SURF_ALLOW_PRIVATE(str)
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.