G Search MCP

G-Search MCP是一個基於Playwright的Google並行搜索服務，支持多關鍵詞同時搜索和結構化結果返回。

搜索工具開發者工具 #並行搜索 #結構化數據 #驗證碼處理 #瀏覽器自動化 .TypeScript

評分 : 3分

下載量 : 123

更新時間 : 2025-04-29

什麼是G-Search MCP?

G-Search MCP 是一款基於Playwright框架構建的MCP服務器，允許用戶通過多個關鍵詞在Google上進行並行搜索。它支持智能處理驗證碼、模擬真實用戶行為，並返回結構化的搜索結果。

如何使用G-Search MCP?

安裝後，您可以直接運行命令來執行搜索任務。只需輸入關鍵詞列表，服務器會自動完成搜索並返回結果。

適用場景

適合需要快速獲取大量搜索結果的研究人員、營銷人員以及開發者。

主要功能

並行搜索支持同時對多個關鍵詞進行搜索，大幅提升效率。

瀏覽器優化在同一瀏覽器實例中打開多個標籤頁，實現高效搜索。

自動驗證處理智能檢測CAPTCHA，必要時啟用可見模式讓用戶手動驗證。

結構化JSON輸出以結構化JSON格式返回搜索結果，便於後續分析和處理。

高度可配置支持多種參數配置，如結果數量限制、超時時間、語言環境等。

優勢與侷限性

優勢

支持並行搜索，提高效率

內置瀏覽器優化，減少資源佔用

智能處理驗證碼，降低操作複雜度

返回結構化數據，易於解析

支持靈活配置，滿足多樣化需求

侷限性

需要較高的硬件配置（內存、CPU）

頻繁請求可能觸發搜索引擎反爬蟲機制

不適用於完全自動化流程

如何使用

安裝依賴

確保已安裝Node.js 18及以上版本，然後運行以下命令安裝所需依賴： ```bash npm install ```

啟動服務器

安裝完成後，使用以下命令啟動服務器： ```bash npx -y g-search-mcp ```

執行搜索

輸入關鍵詞列表，例如： ```bash g-search-mcp --queries='["機器學習", "人工智能"]' ```

使用案例

案例1：基礎搜索執行對“機器學習”和“人工智能”的基礎搜索。

案例2：高級配置調整搜索參數以獲得更精確的結果。

常見問題

如何啟用調試模式？

如果遇到驗證碼怎麼辦？

是否可以更改搜索結果的數量？

🚀 G-Search MCP

G-Search MCP是一個強大的MCP服務器，專為Google搜索打造，支持使用多個關鍵詞同時進行並行搜索，極大提升了搜索效率。

該項目基於google-search進行修改。

🚀 快速開始

直接運行

直接使用npx運行：

npx -y g-search-mcp

首次安裝時，請先在終端中執行以下命令以安裝所需的瀏覽器：

npx playwright install chromium

調試模式

使用--debug選項以調試模式運行（顯示瀏覽器窗口）：

npx -y g-search-mcp --debug

✨ 主要特性

並行搜索：支持同時使用多個關鍵詞在Google上搜索，提高搜索效率。
瀏覽器優化：在一個瀏覽器實例中打開多個標籤頁以實現高效並行搜索。
自動驗證處理：智能檢測CAPTCHA，並在需要時啟用可見瀏覽器模式以便用戶進行驗證。
用戶行為模擬：模擬真實用戶的瀏覽習慣，降低被搜索引擎檢測的風險。
結構化數據返回：以JSON格式返回結構化的搜索結果，便於後續處理和分析。
可配置參數：支持多種參數配置，例如搜索結果限制、超時設置、地區設置等。

📦 安裝指南

克隆倉庫：

git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp

安裝依賴項：

npm install

安裝Playwright瀏覽器：

npm run install-browser

構建服務器：

npm run build

💻 使用示例

基礎用法

執行並行搜索：

g-search-mcp search --queries keyword1,keyword2 --limit 5

高級用法

獲取即時匯率數據：

g-search-mcp fetcher --url https://www.google.com/finance/markets/currencies/EURUSD=X --xpath //*[@class=' financial-data-bucket__value']

返回結果

搜索結果將以JSON格式返回，示例如下：

{
  "results": [
    {
      "title": "關鍵詞1的相關內容",
      "url": "https://example.com/keyword1",
      "snippet": "關鍵詞1的簡要描述..."
    },
    {
      "title": "關鍵詞2的相關內容",
      "url": "https://example.com/keyword2",
      "snippet": "關鍵詞2的簡要描述..."
    }
  ]
}

📚 詳細文檔

配置MCP

在Claude Desktop中配置此MCP服務器： MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "g-search": {
      "command": "npx",
      "args": ["-y", "g-search-mcp"]
    }
  }
}

功能特性說明

search - 執行Google搜索，支持多個關鍵詞並返回結果
- 使用Playwright瀏覽器進行搜索操作
- 支持以下參數：
  - queries：要執行的搜索查詢數組（必填參數）
  - limit：每個查詢的最大返回結果數，默認為10
  - timeout：頁面加載超時時間（以毫秒為單位），默認60000（60秒）
  - noSaveState：是否避免保存瀏覽器狀態，默認為false
  - proxy：代理設置，支持HTTP、HTTPS和SOCKS協議
  - region：指定搜索區域（如"us"表示美國）