Google Search Tool
A Playwright-based Node.js tool that bypasses search engine anti-scraping mechanisms to execute Google searches. Local alternative to SERP APIs with MCP server integration.
Overview
Google Search Tool is a Playwright-based Node.js application designed to bypass search engine anti-scraping mechanisms, allowing users to execute Google searches and extract results locally without relying on paid SERP APIs.
To use the Google Search Tool, you can run it directly from the command line by providing search keywords. It can also be integrated as a Model Context Protocol (MCP) server for real-time search capabilities in AI assistants like Claude.
- Local SERP API alternative, executing searches without external dependencies. - Advanced anti-bot detection bypass techniques, including intelligent browser fingerprint management and state restoration. - MCP server integration for seamless AI assistant functionality. - Completely open source and free to use, allowing customization and extensibility.
- Conducting automated Google searches for research purposes.
- Integrating search capabilities into AI assistants for enhanced user interaction.
- Bypassing search engine restrictions for data extraction in a compliant manner.
Add to your AI client
Use these steps to connect Google Search Tool in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"google-search-web-agent-master": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-search-web-agent-master"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"google-search-web-agent-master": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-search-web-agent-master"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"google-search-web-agent-master": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-search-web-agent-master"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"google-search-web-agent-master": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-search-web-agent-master"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-search-web-agent-master": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-search-web-agent-master"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"google-search-web-agent-master": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-search-web-agent-master"
]
}
}
}FAQ
Is Google Search Tool free to use?
Yes! It is completely open source and free for everyone.
Can I use it for commercial purposes?
While it is open source, please ensure compliance with Google's terms of service.
How does it handle anti-bot detection?
It employs various techniques such as browser state management and randomization of settings to minimize detection risks.