G Search MCP

🚀 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格式返回結構化的搜索結果，便於後續處理和分析。
• 可配置參數：支持多種參數配置，例如搜索結果限制、超時設置、地區設置等。

📦 安裝指南

1. 克隆倉庫：

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

2. 安裝依賴項：

npm install

3. 安裝Playwright瀏覽器：

npm run install-browser

4. 構建服務器：

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"表示美國）

使用技巧

• 處理特殊網站場景：通過自定義腳本實現對特定網頁內容的提取和處理。
• 調試與故障排除：
  • 檢查瀏覽器驅動是否正確安裝並保持最新。
  • 確保網絡連接穩定，避免因超時導致搜索失敗。
  • 定期清理緩存以提高搜索效率。

開發相關

自動重建（開發模式）

npm run watch

使用MCP Inspector進行調試

npm run inspector

🔗 相關項目

• fetcher-mcp：一個強大的MCP服務器，用於使用Playwright無頭瀏覽器抓取網頁內容。特點包括智能內容提取、並行處理、資源優化等，是網絡爬蟲的理想選擇。

📄 許可證

本項目 licensed under the MIT License