G-Search MCP
複数のキーワードを同時に並行検索できる、Google 検索用の強力な MCP サーバーです。
このプロジェクトはgoogle-searchから変更されています。
利点
- 並列検索: Googleで複数のキーワードを同時に検索し、検索効率を向上します。
- ブラウザの最適化: 効率的な並列検索のために、単一のブラウザインスタンスで複数のタブを開きます。
- 自動検証処理: CAPTCHA をインテリジェントに検出し、必要に応じてユーザー検証用の可視ブラウザ モードを有効にします。
- ユーザー行動シミュレーション: 実際のユーザーの閲覧パターンをシミュレートして、検索エンジンによる検出の可能性を低減します。
- 構造化データ: 構造化された検索結果をJSON形式で返し、簡単に処理および分析できます。
- 設定可能なパラメータ: 検索結果の制限、タイムアウト設定、ロケール設定など、さまざまなパラメータ設定をサポートします。
クイックスタート
npx で直接実行します:
初回セットアップ - ターミナルで次のコマンドを実行して、必要なブラウザをインストールします。
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 : ブラウザの状態を保存しないかどうか。デフォルトは falselocale : 検索結果のロケール設定。デフォルトは en-USdebug : デバッグモードを有効にするかどうか（ブラウザウィンドウを表示）、コマンドラインの --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が設定されます。
インストール
前提条件
ソースからインストール
- リポジトリをクローンします。
git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp
- 依存関係をインストールします:
- Playwright ブラウザをインストールします:
- サーバーを構築します。
発達
自動リビルド（開発モード）
デバッグにMCP Inspectorを使用する
関連プロジェクト
- fetcher-mcp : Playwrightヘッドレスブラウザを使用してWebページコンテンツを取得するための強力なMCPサーバー。インテリジェントなコンテンツ抽出、並列処理、リソース最適化などの機能を備えており、Webコンテンツのスクレイピングに最適なツールです。
ライセンス
MITライセンスに基づいてライセンスされています