Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jae-jae--g-search-mcp/badge.svg)](/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

i

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)

  1. <div align="center">
  2. <img src="https://github.com/jae-jae/g-search-mcp/raw/main/icon.svg" width="120" height="120" alt="g-search-mcp Logo" />
  3. </div>
  4. # G-Search MCP
  5. A powerful MCP server for Google search that enables parallel searching with multiple keywords simultaneously.
  6. > This project is modified from [google-search](https://github.com/web-agent-master/google-search).
  7. > 🌟 **Recommended**: [OllaMan](https://ollaman.com/) - Powerful Ollama AI Model Manager.
  8. ## Advantages
  9. - **Parallel Searching**: Supports searching with multiple keywords on Google simultaneously, improving search efficiency
  10. - **Browser Optimization**: Opens multiple tabs in a single browser instance for efficient parallel searching
  11. - **Automatic Verification Handling**: Intelligently detects CAPTCHA and enables visible browser mode for user verification when needed
  12. - **User Behavior Simulation**: Simulates real user browsing patterns to reduce the possibility of detection by search engines
  13. - **Structured Data**: Returns structured search results in JSON format for easy processing and analysis
  14. - **Configurable Parameters**: Supports various parameter configurations such as search result limits, timeout settings, locale settings, etc.
  15. ## Quick Start
  16. Run directly with npx:
  17. ```bash
  18. npx -y g-search-mcp
  19. ```
  20. First time setup - install the required browser by running the following command in your terminal:
  21. ```bash
  22. npx playwright install chromium
  23. ```
  24. ### Debug Mode
  25. Use the `--debug` option to run in debug mode (showing browser window):
  26. ```bash
  27. npx -y g-search-mcp --debug
  28. ```
  29. ## Configure MCP
  30. Configure this MCP server in Claude Desktop:
  31. MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  32. Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  33. ```json
  34. {
  35. "mcpServers": {
  36. "g-search": {
  37. "command": "npx",
  38. "args": ["-y", "g-search-mcp"]
  39. }
  40. }
  41. }
  42. ```
  43. ## Features
  44. - `search` - Execute Google searches with multiple keywords and return results
  45. - Uses Playwright browser to perform searches
  46. - Supports the following parameters:
  47. - `queries`: Array of search queries to execute (required parameter)
  48. - `limit`: Maximum number of results to return per query, default is 10
  49. - `timeout`: Page loading timeout in milliseconds, default is 60000 (60 seconds)
  50. - `noSaveState`: Whether to avoid saving browser state, default is false
  51. - `locale`: Locale setting for search results, default is en-US
  52. - `debug`: Whether to enable debug mode (showing browser window), overrides the --debug flag in command line
  53. **Example usage**:
  54. ```
  55. Use the search tool to search for "machine learning" and "artificial intelligence" on Google
  56. ```
  57. **Example response**:
  58. ```json
  59. {
  60. "searches": [
  61. {
  62. "query": "machine learning",
  63. "results": [
  64. {
  65. "title": "What is Machine Learning? | IBM",
  66. "link": "https://www.ibm.com/topics/machine-learning",
  67. "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."
  68. },
  69. ...
  70. ]
  71. },
  72. {
  73. "query": "artificial intelligence",
  74. "results": [
  75. {
  76. "title": "What is Artificial Intelligence (AI)? | IBM",
  77. "link": "https://www.ibm.com/topics/artificial-intelligence",
  78. "snippet": "Artificial intelligence leverages computers and machines to mimic the problem-solving and decision-making capabilities of the human mind."
  79. },
  80. ...
  81. ]
  82. }
  83. ]
  84. }
  85. ```
  86. ## Usage Tips
  87. ### Handling Special Website Scenarios
  88. #### Adjusting Search Parameters
  89. - **Search Result Quantity**: For more search results:
  90. ```
  91. Please return the top 20 search results for each keyword
  92. ```
  93. This will set the `limit: 20` parameter.
  94. - **Increase Timeout Duration**: For slow loading situations:
  95. ```
  96. Please set the page loading timeout to 120 seconds
  97. ```
  98. This will adjust the `timeout` parameter to 120000 milliseconds.
  99. #### Locale Settings Adjustment
  100. - **Change Search Region**: Specify a different locale setting:
  101. ```
  102. Please use Chinese locale (zh-CN) for searching
  103. ```
  104. This will set the `locale: "zh-CN"` parameter.
  105. ### Debugging and Troubleshooting
  106. #### Enable Debug Mode
  107. - **Dynamic Debug Activation**: To display the browser window during a specific search operation:
  108. ```
  109. Please enable debug mode for this search operation
  110. ```
  111. This sets `debug: true` even if the server was started without the `--debug` flag.
  112. ## Installation
  113. ### Prerequisites
  114. - Node.js 18 or higher
  115. - NPM or Yarn
  116. ### Install from Source
  117. 1. Clone the repository:
  118. ```bash
  119. git clone https://github.com/jae-jae/g-search-mcp.git
  120. cd g-search-mcp
  121. ```
  122. 2. Install dependencies:
  123. ```bash
  124. npm install
  125. ```
  126. 3. Install Playwright browser:
  127. ```bash
  128. npm run install-browser
  129. ```
  130. 4. Build the server:
  131. ```bash
  132. npm run build
  133. ```
  134. ## Development
  135. ### Auto Rebuild (Development Mode)
  136. ```bash
  137. npm run watch
  138. ```
  139. ### Using MCP Inspector for Debugging
  140. ```bash
  141. npm run inspector
  142. ```
  143. ## Related Projects
  144. - [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.
  145. ## License
  146. Licensed under the [MIT License](https://choosealicense.com/licenses/mit/)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.