はじめに
G-Search-MCPは、開発者のjae-jae氏によってGitHubでホストされているオープンソースのGoogle検索ツールです。 グーグルサーチ 変更されました。MCP (Model Context Protocol)サーバーを介して動作し、Google検索で複数のキーワードを同時にサポートすることが中核機能です。検索結果はJSON形式で返され、ユーザが簡単に処理・分析できる。このツールは、Playwrightブラウザを使用して、実際のユーザーの操作をシミュレートし、効果的にGoogleによってブロックされるリスクを軽減することができます。開発者、研究者、データアナリストなど、大量の情報を素早く取得する必要のあるユーザーに適している。また、このプロジェクトでは、検索結果の数や言語選択などのパラメータを柔軟に設定することができる。
機能一覧
- 複数キーワード並列検索複数キーワードの同時検索に対応し、作業効率を向上。
- ブラウザの最適化1つのブラウザインスタンスで複数のタブを開くことでリソースを節約できます。
- CAPTCHA自動検出CAPTCHAが検出されたら可視モードに切り替え、ユーザーが確認するのを待つ。
- ユーザー行動シミュレーション検索エンジンによる制限を避けるために、実際のユーザーの操作を模倣する。
- JSONデータ出力検索結果は、プログラムが使いやすいように構造化された形式で返されます。
- パラメタリゼーション結果数、タイムアウト、言語地域などのオプションが設定できる。
ヘルプの使用
G-Search-MCPは、使用するためにインストールと設定が必要な技術ツールです。インストールの手順と操作方法について、以下に詳しく説明します。
設置プロセス
- 環境要件の検査
- Node.js 18以降、NPMまたはYarnがインストールされている必要があります。
- あなたのコンピューターにコードをダウンロードするためのGitがあることを確認してください。
- 最新のブラウザ(Chromiumなど)を用意すれば、ツールは自動的にインストールされる。
- プロジェクトコードのダウンロード
- ターミナルを開き、コマンドを実行する:
git clone https://github.com/jae-jae/g-search-mcp.git
- プロジェクト・カタログにアクセスする:
cd g-search-mcp
- ターミナルを開き、コマンドを実行する:
- 依存関係のインストール
- 必要なパッケージをインストールするコマンドを入力する:
npm install
- 必要なパッケージをインストールするコマンドを入力する:
- Playwrightブラウザのインストール
- 以下のコマンドを実行して、Chromiumブラウザをインストールする:
npx playwright install chromium
- このステップでは、ツールがブラウザ・インスタンスを適切に実行することを確認する。
- 以下のコマンドを実行して、Chromiumブラウザをインストールする:
- サーバー構築
- プロジェクトをビルドするコマンドを入力する:
npm run build
- プロジェクトをビルドするコマンドを入力する:
- クイックスタート
- コマンドを使って直接実行する:
npx -y g-search-mcp
- サーバーは起動後すぐに使用できる。
- コマンドを使って直接実行する:
MCPサーバーの設定(オプション)
に入りたいのであれば クロード デスクトップにあるこのツールを使って、以下の設定を行うことができます。 エムシーピー サーバー
- 設定ファイルのパス
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- ウィンドウズ
%APPDATA%/Claude/claude_desktop_config.json
- MacOS:
- 設定内容
- JSONファイルを編集し、以下を追加する:
{ "mcpServers": { "g-search": { "command": "npx", "args": ["-y", "g-search-mcp"] } } }
- JSONファイルを編集し、以下を追加する:
使用方法
基本操作
- 単一キーワード検索
- コマンドを実行する:
npx -y g-search-mcp --keywords "人工智能"
- ブラウザはタブを開いて結果を表示し、端末はJSONデータを返す。
- コマンドを実行する:
- 複数キーワード検索
- 複数のキーワードをカンマ区切りで入力します:
npx -y g-search-mcp --keywords "人工智能,机器学习"
- ブラウザはキーワードごとに複数のタブを開く。
- 複数のキーワードをカンマ区切りで入力します:
注目の機能操作
- 結果数の調整
- 利用する
--limit
パラメーターnpx -y g-search-mcp --keywords "人工智能" --limit 20
- 最初の20件を返します。デフォルトは10件です。
- 利用する
- タイムアウト時間の設定
- 利用する
--timeout
パラメーターnpx -y g-search-mcp --keywords "人工智能" --timeout 120000
- タイムアウトを120秒に設定する。デフォルトは60秒。
- 利用する
- 言語地域の変更
- 利用する
--locale
パラメーターnpx -y g-search-mcp --keywords "人工智能" --locale "zh-CN"
- 結果は優先的に中国語で表示される。
- 利用する
- デバッグモードを有効にする
- 増加
--debug
パラメーターnpx -y g-search-mcp --keywords "人工智能" --debug
- ブラウザのウィンドウに表示されるため、操作が見やすい。
- 増加
- CAPTCHAの取り扱い
- CAPTCHAに遭遇した場合、ツールは一時停止し、ブラウザウィンドウを表示します。
- ユーザーが手動で検証を完了した後も、ツールは実行され続ける。
- JSON出力の表示
- 検索が完了すると、端末には以下のような結果が表示される:
{ "searches": [ { "query": "人工智能", "results": [ { "title": "人工智能简介", "link": "https://example.com", "snippet": "人工智能是..." } ] } ] }
- 結果はファイルに保存できる:
npx -y g-search-mcp --keywords "人工智能" > result.json
- 検索が完了すると、端末には以下のような結果が表示される:
開発モード(オプション)
- 自動リビルド走る
npm run watch
コードは自動的に修正され、更新される。 - デバッグツール走る
npm run inspector
動作状況を確認するには、MCP Inspectorを使用します。
ほら
- ネットワーク接続Googleサービスへのインターネット接続が必要です。
- 資源占有率複数のキーワードで検索すると、より多くのメモリを消費する可能性があります。
- 能力の問題ターミナルがコマンドを実行するのに十分な権限を持っていることを確認してください。
操作例
ブロックチェーン」と「スマートコントラクト」を検索しているとしよう:
- コマンドを入力する:
npx -y g-search-mcp --keywords "区块链,智能合约" --limit 15 --locale "zh-CN"
- ブラウザは2つのタブを開き、中国語の検索結果を表示する。
- 端末は、各結果のタイトル、リンク、概要を含むJSONデータを返す。
このツールは、情報を大量に収集する技術的なユーザーにとって直感的で強力です。
アプリケーションシナリオ
- 技術研究
開発者は、「フロントエンドフレームワーク」や「バックエンドテクノロジー」といったキーワードで検索し、情報を素早く比較することができる。 - データ分析
アナリストは、JSON出力を使用して、「市場動向」や「ユーザーニーズ」などのキーワード結果を分析できる。 - 教育支援
学生は、「物理学」や「化学反応」を検索して、学習リソースに素早くアクセスできる。
品質保証
- 起動時にPlaywrightが見つからない場合はどうすればよいですか?
うごきだすnpx playwright install chromium
ブラウザをインストールする。 - 検索結果が不完全だったら?
ネットワークをチェックする。--timeout
時間、たとえば120000ミリ秒。 - 検索結果を保存する方法は?
コマンドの後に> 文件名.json
例えばnpx -y g-search-mcp --keywords "人工智能" > result.json
.