google-search

Overview

This is a comprehensive MCP server that provides Google search capabilities through Playwright browser automation. It features advanced anti-bot detection bypass techniques including intelligent browser fingerprint management, automatic browser state saving and restoration, and smart headless/headed mode switching. The tool can be used both as a command-line tool and as an MCP server, enabling AI assistants like Claude to perform real-time searches without relying on paid SERP APIs. The project is well-documented with TypeScript implementation, robust error handling, and comprehensive cross-platform support including Windows-specific adaptations.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• google_searchquery: string

  Executes Google search and returns results with title, link, and snippet

  Try:Search for the latest AI researchTry:Find information about climate change effects
• get_htmlquery: string

  Retrieves raw HTML of Google search result pages

  Try:Get the HTML of search results for web development toolsTry:Retrieve raw HTML for JavaScript frameworks

Comparable tools

Installation

# Install from source
git clone https://github.com/web-agent-master/google-search.git
cd google-search
# Install dependencies
npm install
# Compile TypeScript code
npm run build
# Link package globally (required for MCP functionality)
npm link

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": ["google-search-mcp"]
    }
  }
}

FAQ

Does this tool violate Google's terms of service?

This tool is intended for learning and research purposes. Users should comply with Google's terms of service and policies, avoid sending requests too frequently, and be mindful of regional access requirements.

How does it bypass Google's anti-bot detection?

The tool uses multiple techniques including intelligent browser fingerprint management, automatic browser state saving and restoration, smart headless/headed mode switching, and randomization of device and locale settings to simulate real user behavior.

Compare google-search with