Google 検索 MCP

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

特徴

• アンチボットバイパス: ブラウザのフィンガープリントスプーフィングと実際のユーザー行動シミュレーションを使用して検出を回避します

• 自動 CAPTCHA 処理: CAPTCHA に遭遇すると、ヘッダーモードに切り替えて、ユーザーが検証を完了できるようにします。

• 状態の永続性: ブラウザのセッション状態を保存して、繰り返し検証する必要性を軽減します。

• 適応性: 複数のセレクタの組み合わせを使用して、Google 検索ページの変更に適応します。

• MCP 統合: AI アシスタントとの統合を容易にするモデル コンテキスト プロトコルを実装します。

• 多言語サポート: さまざまな言語や地域での検索結果をサポートします

Related MCP server: Playread

カーソルの使用

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

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

npx -y @mcp-server/google-search-mcp@latest

カーソル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ファイルを追加します。

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-server/google-search-mcp@latest"
      ]
    }
  }
}

発達

yarn install

プロジェクトを構築する

yarn build

使用法

MCP サーバーとして実行

yarn start

MCP Inspectorと併用

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

# First build the project
yarn build

# Start the MCP Inspector and server
npx @modelcontextprotocol/inspector node dist/index.js

パラメータ

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

• 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ファイルに保存されます。このパスはパラメータで変更できます。

言語と地域の設定

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

// English (US) search results
"language": "en-US", "region": "com"

// Japanese search results
"language": "ja-JP", "region": "co.jp"

// Chinese (Simplified) search results
"language": "zh-CN", "region": "cn"

注記

• 初めて使用する場合、CAPTCHA認証に遭遇すると、システムは自動的にヘッドモードに切り替わり、認証を完了します。

• 検証後、システムは状態ファイルを保存し、その後の検索をスムーズにします。

• 過度に頻繁な検索リクエストは、Google のレート制限メカニズムをトリガーする可能性があります。

• このツールは学習と研究の目的のみに使用してください。Googleの利用規約を遵守してください。

ライセンス

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

免責事項

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