Google Surf
Anti-bot Google search MCP that replaces the usual search MCP + URL fetcher combo with one server. No API key, no proxies, includes graceful CAPTCHA recovery.
What is Google Surf?
Google Surf is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to anti-bot google search mcp that replaces the usual search mcp + url fetcher combo with one server. no api key, no proxies, includes graceful captcha recovery.
Anti-bot Google search MCP that replaces the usual search MCP + URL fetcher combo with one server. No API key, no proxies, includes graceful CAPTCHA recovery.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Anti-bot Google search MCP that replaces the usual search MC
Use Cases
Maintainer
Works with
Installation
NPM
npx -y google-surf-mcpManual Installation
npx -y google-surf-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Google Surf
google-surf-mcp is an anti-bot Google search server for the Model Context Protocol that combines real-time web search and full-page content extraction into a single server, eliminating the need to pair a search tool with a separate URL fetcher. It uses Playwright with layered stealth strategies and graceful CAPTCHA recovery to perform Google searches without API keys or paid proxies, and can extract HTML pages, PDFs, and academic papers from major publishers. It is particularly useful for research workflows where an AI assistant needs both search results and the full content of the pages found.
Prerequisites
- Node.js 18+ installed on your system
- Google Chrome or Chromium browser installed (auto-detected, or set CHROME_PATH)
- An MCP-compatible client such as Claude Desktop or Claude Code
- No Google API key or search API subscription required
Install via npx (no global install needed)
The server can be run directly with npx. The first run will download the package and its Playwright browser drivers automatically.
npx -y google-surf-mcpConfigure your MCP client
Add the server to your MCP configuration file. The simplest setup needs no environment variables — defaults work out of the box for most machines.
Optional: tune rate limiting and caching
Set SURF_RATE_LIMIT_PER_MIN to control how many Google-facing requests per minute are made (default 10). Search results are cached for 24 hours by default (SURF_CACHE_TTL_SEARCH_MS=86400000).
Optional: enable LLM-assisted CAPTCHA healing
Set SURF_LLM_HEAL=true and provide ANTHROPIC_API_KEY to enable LLM-assisted selector repair when stealth strategies need updating.
Test the server
Ask your AI assistant to search for something. The server will open a headless Chrome session, perform the search, and return titles, URLs, and snippets.
Google Surf Examples
Client configuration
Add to your claude_desktop_config.json or ~/.claude.json to register google-surf-mcp. No API keys are needed for basic use.
{
"mcpServers": {
"google-surf": {
"command": "npx",
"args": ["-y", "google-surf-mcp"],
"env": {
"SURF_RATE_LIMIT_PER_MIN": "10",
"SURF_HEADLESS": "true",
"SURF_CACHE_TTL_SEARCH_MS": "86400000"
}
}
}
}Prompts to try
Example prompts that use search, extraction, and combined search-and-read capabilities.
- "Search Google for 'Model Context Protocol best practices' and summarize the top 3 results"
- "Fetch the full content of https://modelcontextprotocol.io/introduction and summarize it"
- "Search for the latest news on OpenAI and extract the full article from the top result"
- "Find the arxiv paper on 'attention is all you need' and extract its abstract"
- "Search for 'typescript mcp server tutorial' and read the first result"Troubleshooting Google Surf
Chrome not found or fails to launch
Set the CHROME_PATH environment variable to the absolute path of your Chrome or Chromium binary, e.g. /usr/bin/google-chrome or /Applications/Google Chrome.app/Contents/MacOS/Google Chrome.
Google returns a CAPTCHA and search stalls
The server has built-in CAPTCHA recovery. If it keeps stalling, reduce SURF_RATE_LIMIT_PER_MIN (try 5 or 3) to slow down request frequency. You can also set SURF_HUMANLIKE_MODE=background for more human-like browsing behavior.
Extracted page content is truncated
Increase SURF_EXTRACT_MAX_CHARS beyond the default of 8000. Set it to 20000 or higher for long articles. For PDFs, ensure SURF_EXTRACT_OCR=false unless you specifically need OCR (requires Tesseract).
Frequently Asked Questions about Google Surf
What is Google Surf?
Google Surf is a Model Context Protocol (MCP) server that anti-bot google search mcp that replaces the usual search mcp + url fetcher combo with one server. no api key, no proxies, includes graceful captcha recovery. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Google Surf?
Install via npm with the command: npx -y google-surf-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Google Surf?
Google Surf works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Google Surf free to use?
Yes, Google Surf is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Google Surf Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Google Surf? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Google Surf in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Google Surf?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.