g-search

G-Search MCP is an MCP server that enables parallel Google searches using multiple keywords concurrently. It leverages Playwright to automate browser interactions, returning structured JSON with search results for each query. The server supports capabilities such as setting a result limit, page load timeouts, locale preferences, and optional debug mode to visually display the browser during operation. You can drive the server via the npx command shown in the Quick Start, and pass query parameters through the provided search tool interface to obtain organized results for downstream processing.

Prerequisites:

• Node.js 18 or higher
• npm or yarn

Install from source:

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Install Playwright browser:

npm run install-browser

4. Build the server (if applicable):

npm run build

Run directly with npx (no local install required):

npx -y g-search-mcp

Tips and notes:

• The MCP returns results in JSON with a structure including queries and their corresponding results (title, link, snippet).
• You can adjust search behavior using keywords embedded in your requests (limits, timeouts, locale). For higher result counts, specify limit in the tool's parameters (e.g., limit: 20).
• Debug mode can be enabled to show the browser window, which is useful for troubleshooting CAPTCHA or verification steps. Use the debug flag or pass a request parameter debug: true.
• Install the Playwright browser once via npm run install-browser; this ensures Chromium is available for Google searches.
• If CAPTCHA or verification appears, the server will attempt automatic verification and may switch to visible browser mode to complete human verification when needed.