# google-search

> MCP Server

This repository offers a Playwright-based Node.js tool that bypasses anti-scraping measures to perform Google searches and extract results locally, serving as an alternative to paid SERP APIs and integrating with AI assistants.

## Overview

- **Category:** Developer Tools
- **Language:** TypeScript
- **Stars:** 619
- **Forks:** 30
- **Owner:** web-agent-master
- **GitHub:** https://github.com/web-agent-master/google-search
- **Created:** 2025-03-04T03:02:38+00:00
- **Updated:** 2025-03-28T09:00:45+00:00
- **Source:** https://model-context-protocol.com/servers/google-search-bypass-anti-scraping-tool

## Setup

## Setup

```bash
# Install from source
git clone https://github.com/web-agent-master/google-search.git
cd google-search
# Install dependencies
npm install
# Or using yarn
yarn
# Or using pnpm
pnpm install

# Compile TypeScript code
npm run build
# Or using yarn
yarn build
# Or using pnpm
pnpm build

# Link package globally (required for MCP functionality)
npm link
# Or using yarn
yarn link
# Or using pnpm
pnpm link
```

## Tools

## Available Tools

1.  Local SERP API Alternative (Provides local search execution without relying on paid APIs).
2.  Advanced Anti-Bot Detection Bypass Techniques (Employs intelligent browser fingerprint management and other methods to avoid detection).
3.  MCP Server Integration (Offers real-time search capabilities to AI assistants like Claude).
4.  Command Line Tool (Allows direct execution of Google searches from the command line).
5.  Headless/Headed Mode Switching (Automatically switches to headed mode when verification is needed).