google-search
Google Search Tool is a Node.js application that facilitates Google searches by bypassing anti-scraping protections. It can operate as a command-line tool or an MCP server and is designed for integration with AI systems like Claude. The entire project is open-source, providing users with a customizable and free alternative to traditional search engine result APIs.
Google Search Tool
A Playwright-based Node.js tool for executing Google searches, bypassing search engine anti-scraping measures. It serves as both a command-line tool and a Model Context Protocol (MCP) server for AI assistants like Claude.
Key Features
- Local SERP API alternative
- Advanced anti-bot detection bypass techniques
- Raw HTML retrieval and page screenshot functionality
- MCP server integration for real-time search capabilities
- Open source and free to use
Technical Features
- Developed with TypeScript and uses Playwright for browser automation
- Supports headless and headed modes
- Offers robust error handling and saves/restores browser state
Installation and Usage
Follow installation instructions using npm, yarn, or pnpm to compile and link the project, then utilize as a command-line tool with several configurable options.
MCP Server
Provides MCP server functionality, enabling integration with AI assistants to perform searches.
Project Structure
Details the layout of the project files, including the main logic, search implementation, and MCP server.