G Search MCP

🚀 G-Search MCP

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

このプロジェクトはgoogle-searchをベースに修正されています。

✨ 主な機能

• 並列検索：複数のキーワードを同時にGoogleで検索し、検索効率を向上させます。
• ブラウザ最適化：1つのブラウザインスタンスで複数のタブを開き、効率的な並列検索を実現します。
• 自動検証処理：CAPTCHAを自動検出し、必要に応じて可視ブラウザモードを有効にしてユーザーに検証を行わせます。
• ユーザー行動の模倣：実際のユーザーの閲覧習慣を模倣し、検索エンジンに検出されるリスクを低減します。
• 構造化データの返却：検索結果をJSON形式で返却し、後続の処理と分析を容易にします。
• パラメータの設定可能：検索結果の制限、タイムアウト設定、地域設定など、様々なパラメータを設定できます。

🚀 クイックスタート

npxを使って直接実行するには：

npx -y g-search-mcp

初回インストール時には、必要なブラウザをインストールするために、ターミナルで以下のコマンドを実行してください：

npx playwright install chromium

デバッグモード

--debugオプションを使用してデバッグモードで実行する（ブラウザウィンドウを表示する）：

npx -y g-search-mcp --debug

📦 インストール

インストール手順

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

📚 ドキュメント

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"は米国を表す）

使用例

基本的な使用法

並列検索を実行する：

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の簡単な説明..."
    }
  ]
}

使用テクニック

• 特殊ウェブサイトのシナリオの処理：カスタムスクリプトを使用して特定のウェブページの内容を抽出および処理します。
• デバッグとトラブルシューティング：
  • ブラウザドライバが正しくインストールされ、最新の状態であることを確認します。
  • ネットワーク接続が安定していることを確認し、タイムアウトによる検索失敗を避けます。
  • 定期的にキャッシュをクリアして検索効率を向上させます。

開発

自動再構築（開発モード）

npm run watch

MCP Inspectorを使用したデバッグ

npm run inspector

関連プロジェクト

• fetcher-mcp：Playwrightヘッドレスブラウザを使用してウェブページの内容を取得する強力なMCPサーバーです。特徴には、スマートな内容抽出、並列処理、リソース最適化などがあり、ウェブクローラーに最適です。

📄 ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。