Google Search

by jae-jae

210 stars

2.6k downloads

Not rated

GitHub Website

About

Automates parallel Google searches with intelligent CAPTCHA detection, browser state persistence, and user behavior simulation to bypass anti-bot measures while returning structured results.

Details

Author: jae-jae
Repository: jae-jae/g-search-mcp
GitHub stars: 210
Downloads: 2,563
License: MIT License
Categories: Search, Automation, Other, Web Scraping, AI, Design, Developer Tools, Frontend, Infrastructure
Tags: #web

- Parallel searching with multiple keywords simultaneously
- Opens multiple tabs in a single browser instance
- Automatic CAPTCHA detection with visible browser mode
- Simulates real user browsing behavior to reduce detection
- Returns structured JSON search results
- Configurable parameters (limit, timeout, locale, debug)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Google Search

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 g-search-mcp
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "%APPDATA%/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "%APPDATA%/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "%APPDATA%/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "%APPDATA%/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "%APPDATA%/Claude",
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

From the repository

Run directly with npx:

npx -y g-search-mcp

First time setup - install the required browser by running the following command in your terminal:

npx playwright install chromium

Configure this MCP server in Claude Desktop:

`search`

Execute Google searches with multiple keywords and return results. Parameters: queries (array of search queries, required), limit (maximum results per query, default is 10), timeout (page loading timeout in milliseconds, default is 60000), noSaveState (avoid saving browser state, default is false), locale (locale setting for search results, default is en-US), debug (enable debug mode, overrides command line flag)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "google search": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "-y",
                "g-search-mcp"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Linux

{
    "cwd": "~/Claude",
    "env": [],
    "args": [
        "-y",
        "g-search-mcp"
    ],
    "shell": false,
    "command": "npx"
}

Macos

{
    "cwd": "~/Library/Application Support/Claude",
    "env": [],
    "args": [
        "-y",
        "g-search-mcp"
    ],
    "shell": false,
    "command": "npx"
}

Windows

{
    "cwd": "%APPDATA%/Claude",
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "g-search-mcp"
    ],
    "shell": false,
    "command": "cmd"
}

A powerful MCP server for Google search that enables parallel searching with multiple keywords simultaneously.

This project is modified fromgoogle-search.

- Parallel Searching: Supports searching with multiple keywords on Google simultaneously, improving search efficiency
- Browser Optimization: Opens multiple tabs in a single browser instance for efficient parallel searching
- Automatic Verification Handling: Intelligently detects CAPTCHA and enables visible browser mode for user verification when needed
- User Behavior Simulation: Simulates real user browsing patterns to reduce the possibility of detection by search engines
- Structured Data: Returns structured search results in JSON format for easy processing and analysis
- Configurable Parameters: Supports various parameter configurations such as search result limits, timeout settings, locale settings, etc.

First time setup - install the required browser by running the following command in your terminal:

Use the--debugoption to run in debug mode (showing browser window):

Configure this MCP server in Claude Desktop:

MacOS:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%/Claude/claude_desktop_config.json

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

- search- Execute Google searches with multiple keywords and return results

- Uses Playwright browser to perform searches
- Supports the following parameters:

- queries: Array of search queries to execute (required parameter)
- limit: Maximum number of results to return per query, default is 10
- timeout: Page loading timeout in milliseconds, default is 60000 (60 seconds)
- noSaveState: Whether to avoid saving browser state, default is false
- locale: Locale setting for search results, default is en-US
- debug: Whether to enable debug mode (showing browser window), overrides the --debug flag in command line

Use the search tool to search for "machine learning" and "artificial intelligence" on Google

{ "searches": [ { "query": "machine learning", "results": [ { "title": "What is Machine Learning? | IBM", "link": "https://www.ibm.com/topics/machine-learning", "snippet": "Machine learning is a branch of artificial intelligence (AI) and computer science which focuses on the use of data and algorithms to imitate the way that humans learn, gradually improving its accuracy." }, ... ] }, { "query": "artificial intelligence", "results": [ { "title": "What is Artificial Intelligence (AI)? | IBM", "link": "https://www.ibm.com/topics/artificial-intelligence", "snippet": "Artificial intelligence leverages computers and machines to mimic the problem-solving and decision-making capabilities of the human mind." }, ... ] } ] }

Search Result Quantity: For more search results:

Please return the top 20 search results for each keyword

Increase Timeout Duration: For slow loading situations:

Please set the page loading timeout to 120 seconds

This will adjust thetimeoutparameter to 120000 milliseconds.

- Change Search Region: Specify a different locale setting:

Please use Chinese locale (zh-CN) for searching

- Dynamic Debug Activation: To display the browser window during a specific search operation:

Please enable debug mode for this search operation

git clone https://github.com/jae-jae/g-search-mcp.git cd g-search-mcp

- fetcher-mcp: A powerful MCP server for fetching web page content using Playwright headless browser. Features intelligent content extraction, parallel processing, resource optimization, and more, making it an ideal tool for web content scraping.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Self-hosted Stealth Scraping & Federated Search for AI Agents. A 100% private, free alternative to Firecrawl, Jina Reader, and Tavily. Featuring Universal Anti-bot Bypass + Semantic Research Memory, Copy-Paste setup

Scrapes Google search results using a headless browser. Requires Chrome to be installed.

Adds powerful web scraping and search capabilities to LLM clients like Cursor and Claude.

A browser screenshot tool to capture scrolling screenshots of webpages using Playwright, with support for intelligent section identification and multiple output formats.

Take screenshots and read console logs from web pages using Playwright.

CloakBrowser MCP server for AI agents: Playwright-powered browsing, clean tool forwarding, Docker support, and multi-session HTTP transport.

Control a browser for web automation tasks using Playwright on Cloudflare Workers.

Control a browser for web automation tasks like navigation, typing, clicking, and taking screenshots using Playwright on Cloudflare Workers.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Google Search

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

`search`

Claude Desktop / Cursor

Linux

Macos

Windows

Install

About

Details

Jump to

Setting up with Highlight

From the repository

search

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

@mendableai/firecrawl Mcp Server

Umut Naci

Playwright

Sequential Thinking

Brave Search

Filesystem

`search`