Google 検索 MCP

Google検索用のモデルコンテキストプロトコルサーバー。Playwrightベースのモデルコンテキストプロトコル（MCP）ツールは、検索エンジンのボット対策メカニズムを回避し、Google検索を実行して結果を抽出することで、ClaudeやCursorなどのAIアシスタントにリアルタイム検索機能を提供します。

特徴

• アンチボットバイパス: ブラウザのフィンガープリントスプーフィングと実際のユーザー行動シミュレーションを使用して検出を回避します
• 自動 CAPTCHA 処理: CAPTCHA に遭遇すると、ヘッダーモードに切り替えて、ユーザーが検証を完了できるようにします。
• 状態の永続性: ブラウザのセッション状態を保存して、繰り返し検証する必要性を軽減します。
• 適応性: 複数のセレクタの組み合わせを使用して、Google 検索ページの変更に適応します。
• MCP 統合: AI アシスタントとの統合を容易にするモデル コンテキスト プロトコルを実装します。
• 多言語サポート: さまざまな言語や地域での検索結果をサポートします

カーソルの使用

インストール - グローバル

npx を使用して MCP サーバーを実行します。

カーソルIDEで

1. Cursor Settings > MCPへ移動します。
2. + Add New MCP Serverクリック
3. フォームに記入してください:
   • 名前: google-search (または任意の名前)
   • タイプ: command
   • コマンド: npx -y @mcp-server/google-search-mcp@latest

インストール - プロジェクト固有

プロジェクトに.cursor/mcp.jsonファイルを追加します。

発達

プロジェクトを構築する

使用法

MCP サーバーとして実行

MCP Inspectorと併用

サーバーをデバッグするには、 MCP Inspectorを使用できます。

パラメータ

検索ツールは次のパラメータを受け入れます。

• query （必須）: 検索クエリ文字列
• limit (オプション): 返される検索結果の数。デフォルトは 10 です。
• timeout （オプション）：検索操作のタイムアウト（ミリ秒単位）、デフォルトは60000
• language (オプション): 検索結果の言語 (例: zh-CN、en-US、デフォルト: zh-CN)
• region (オプション): 検索結果の地域 (例: cn、com、co.jp、デフォルトは cn)

仕組み

1. このツールはPlaywrightを使ってChromiumブラウザを制御し、Google検索を実行する。
2. ブラウザのフィンガープリントの偽装と実際のユーザー行動のシミュレーションによりボット検出を回避します。
3. CAPTCHA認証に遭遇すると、自動的にユーザー完了のための見出しモードに切り替わります。
4. 検索結果を抽出し、構造化された形式で返します
5. ブラウザの状態を保存し、その後の検索で再利用します。

詳細設定

ブラウザ状態ファイル

デフォルトでは、ブラウザの状態はユーザーのホームディレクトリにある.google-search-browser-state.jsonファイルに保存されます。このパスはパラメータで変更できます。

言語と地域の設定

パラメータを使用して、検索結果の言語と地域を指定できます。

注記

• 初めて使用する場合、CAPTCHA認証に遭遇すると、システムは自動的にヘッドモードに切り替わり、認証を完了します。
• 検証後、システムは状態ファイルを保存し、その後の検索をスムーズにします。
• 過度に頻繁な検索リクエストは、Google のレート制限メカニズムをトリガーする可能性があります。
• このツールは学習と研究の目的のみに使用してください。Googleの利用規約を遵守してください。

ライセンス

マサチューセッツ工科大学

免責事項

このツールは学習および研究目的のみにご使用ください。このツールを使用してGoogleまたはその他の検索エンジンにアクセスする場合は、関連する利用規約および法的規制を遵守してください。このツールの使用に起因するいかなる問題についても、作者は一切責任を負いません。