g-search-mcp
A powerful MCP server for Google search that enables parallel searching with multiple keywords simultaneously.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/jae-jae--g-search-mcp)HTML
<a href="/listings/jae-jae--g-search-mcp"><img src="/api/listings/jae-jae--g-search-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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
Debug Mode
Use the `--debug` option to run in debug mode (showing browser window):
npx -y g-search-mcp --debug
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 203 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- <img src="https://github.com/jae-jae/g-search-mcp/raw/main/icon.svg" width="120" height="120" alt="g-search-mcp Logo" />
- </div>
- # G-Search MCP
- A powerful MCP server for Google search that enables parallel searching with multiple keywords simultaneously.
- > This project is modified from [google-search](https://github.com/web-agent-master/google-search).
- > 🌟 **Recommended**: [OllaMan](https://ollaman.com/) - Powerful Ollama AI Model Manager.
- ## Advantages
- - **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.
- ## Quick Start
- Run directly with npx:
- ```bash
- npx -y g-search-mcp
- ```
- First time setup - install the required browser by running the following command in your terminal:
- ```bash
- npx playwright install chromium
- ```
- ### Debug Mode
- Use the `--debug` option to run in debug mode (showing browser window):
- ```bash
- npx -y g-search-mcp --debug
- ```
- ## Configure MCP
- Configure this MCP server in Claude Desktop:
- MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%/Claude/claude_desktop_config.json`
- ```json
- {
- "mcpServers": {
- "g-search": {
- "command": "npx",
- "args": ["-y", "g-search-mcp"]
- }
- }
- }
- ```
- ## Features
- - `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
- **Example usage**:
- ```
- Use the search tool to search for "machine learning" and "artificial intelligence" on Google
- ```
- **Example response**:
- ```json
- {
- "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."
- },
- ...
- ]
- }
- ]
- }
- ```
- ## Usage Tips
- ### Handling Special Website Scenarios
- #### Adjusting Search Parameters
- - **Search Result Quantity**: For more search results:
- ```
- Please return the top 20 search results for each keyword
- ```
- This will set the `limit: 20` parameter.
- - **Increase Timeout Duration**: For slow loading situations:
- ```
- Please set the page loading timeout to 120 seconds
- ```
- This will adjust the `timeout` parameter to 120000 milliseconds.
- #### Locale Settings Adjustment
- - **Change Search Region**: Specify a different locale setting:
- ```
- Please use Chinese locale (zh-CN) for searching
- ```
- This will set the `locale: "zh-CN"` parameter.
- ### Debugging and Troubleshooting
- #### Enable Debug Mode
- - **Dynamic Debug Activation**: To display the browser window during a specific search operation:
- ```
- Please enable debug mode for this search operation
- ```
- This sets `debug: true` even if the server was started without the `--debug` flag.
- ## Installation
- ### Prerequisites
- - Node.js 18 or higher
- - NPM or Yarn
- ### Install from Source
- 1. Clone the repository:
- ```bash
- git clone https://github.com/jae-jae/g-search-mcp.git
- cd g-search-mcp
- ```
- 2. Install dependencies:
- ```bash
- npm install
- ```
- 3. Install Playwright browser:
- ```bash
- npm run install-browser
- ```
- 4. Build the server:
- ```bash
- npm run build
- ```
- ## Development
- ### Auto Rebuild (Development Mode)
- ```bash
- npm run watch
- ```
- ### Using MCP Inspector for Debugging
- ```bash
- npm run inspector
- ```
- ## Related Projects
- - [fetcher-mcp](https://github.com/jae-jae/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.
- ## License
- Licensed under the [MIT License](https://choosealicense.com/licenses/mit/)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.