G-Search MCP

MIT License
569
40
  • Apple

Integrations

  • Enables parallel searching with multiple keywords simultaneously on Google, returning structured search results with configurable parameters for result limits, timeout settings, and locale preferences.

G-Search MCP

複数のキーワードを同時に並行検索できる、Google 検索用の強力な MCP サーバーです。

このプロジェクトはgoogle-searchから変更されています。

利点

  • 並列検索: Googleで複数のキーワードを同時に検索し、検索効率を向上します。
  • ブラウザの最適化: 効率的な並列検索のために、単一のブラウザインスタンスで複数のタブを開きます。
  • 自動検証処理: CAPTCHA をインテリジェントに検出し、必要に応じてユーザー検証用の可視ブラウザ モードを有効にします。
  • ユーザー行動シミュレーション: 実際のユーザーの閲覧パターンをシミュレートして、検索エンジンによる検出の可能性を低減します。
  • 構造化データ: 構造化された検索結果をJSON形式で返し、簡単に処理および分析できます。
  • 設定可能なパラメータ: 検索結果の制限、タイムアウト設定、ロケール設定など、さまざまなパラメータ設定をサポートします。

クイックスタート

npx で直接実行します:

npx -y g-search-mcp

初回セットアップ - ターミナルで次のコマンドを実行して、必要なブラウザをインストールします。

npx playwright install chromium

デバッグモード

--debugオプションを使用してデバッグ モードで実行します (ブラウザー ウィンドウを表示します)。

npx -y g-search-mcp --debug

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
      • locale : 検索結果のロケール設定。デフォルトは en-US
      • debug : デバッグモードを有効にするかどうか(ブラウザウィンドウを表示)、コマンドラインの --debug フラグを上書きします

使用例

Use the search tool to search for "machine learning" and "artificial intelligence" on Google

応答例:

{ "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." }, ... ] } ] }

使用上のヒント

特殊なウェブサイトシナリオの取り扱い

検索パラメータの調整

  • 検索結果数: さらに検索結果を表示するには:
    Please return the top 20 search results for each keyword
    これによりlimit: 20パラメータが設定されます。
  • タイムアウト期間を増やす: 読み込みが遅い場合:
    Please set the page loading timeout to 120 seconds
    これにより、 timeoutパラメータが 120000 ミリ秒に調整されます。

ロケール設定の調整

  • 検索地域の変更: 別のロケール設定を指定します:
    Please use Chinese locale (zh-CN) for searching
    これによりlocale: "zh-CN"パラメータが設定されます。

デバッグとトラブルシューティング

デバッグモードを有効にする

  • 動的デバッグのアクティブ化: 特定の検索操作中にブラウザ ウィンドウを表示するには:
    Please enable debug mode for this search operation
    これにより、サーバーが--debugフラグなしで起動された場合でもdebug: trueが設定されます。

インストール

前提条件

  • Node.js 18以上
  • NPM または Yarn

ソースからインストール

  1. リポジトリをクローンします。
git clone https://github.com/jae-jae/g-search-mcp.git cd g-search-mcp
  1. 依存関係をインストールします:
npm install
  1. Playwright ブラウザをインストールします:
npm run install-browser
  1. サーバーを構築します。
npm run build

発達

自動リビルド(開発モード)

npm run watch

デバッグにMCP Inspectorを使用する

npm run inspector

関連プロジェクト

  • fetcher-mcp : Playwrightヘッドレスブラウザを使用してWebページコンテンツを取得するための強力なMCPサーバー。インテリジェントなコンテンツ抽出、並列処理、リソース最適化などの機能を備えており、Webコンテンツのスクレイピングに最適なツールです。

ライセンス

MITライセンスに基づいてライセンスされています

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

複数のキーワードを同時に使用して Google 検索を並行して実行できる強力な MCP サーバーで、CAPTCHA を処理しながら構造化された結果を提供し、ユーザーの閲覧パターンをシミュレートします。

  1. Advantages
    1. Quick Start
      1. Debug Mode
    2. Configure MCP
      1. Features
        1. Usage Tips
          1. Handling Special Website Scenarios
          2. Debugging and Troubleshooting
        2. Installation
          1. Prerequisites
          2. Install from Source
        3. Development
          1. Auto Rebuild (Development Mode)
          2. Using MCP Inspector for Debugging
        4. Related Projects
          1. License
            ID: 07rhdtzqgv