ウェブ検索MCPサーバー

高度なボット検出回避機能を備えた Google 検索機能と Web コンテンツの表示を提供する MCP サーバー。

特徴

高度なフィルタリング機能を備えた Google カスタム検索
マークダウン変換によるWebコンテンツ表示
レート制限とキャッシュ
ブラウザインスタンスプーリング
rebrowser-puppeteer を使用したボット検出回避

Related MCP server: SEO AI Assistant

前提条件

Bun ランタイム v1.0 以上
Google API 認証情報（API キーと検索エンジン ID）

インストール

# Install dependencies bun install # Build the TypeScript files bun run build

構成

クッキーの設定

認証されたサイトにアクセスするには、次のことが必要です。

Get cookies.txt LOCALLY Chrome拡張機能をインストールする
認証したいサイトにアクセスしてログインします
拡張機能を使用してCookieをJSON形式でエクスポートします
エクスポートしたCookieファイルを安全な場所に保存します
BROWSER_COOKIES_PATH環境変数をCookieファイルの絶対パスに設定します。

MCP サーバーの構成

MCP 設定ファイルにサーバー構成を追加します。

Cline の場合: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
Claude Desktopの場合:
- MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "web-search": { "command": "bun", "args": [ "run", "/ABSOLUTE/PATH/TO/web_search_mcp/dist/index.js" ], "env": { "GOOGLE_API_KEY": "your_api_key", "GOOGLE_SEARCH_ENGINE_ID": "your_search_engine_id", "MAX_CONCURRENT_BROWSERS": "3", "BROWSER_TIMEOUT": "30000", "RATE_LIMIT_WINDOW": "60000", "RATE_LIMIT_MAX_REQUESTS": "60", "SEARCH_CACHE_TTL": "3600", "VIEW_URL_CACHE_TTL": "7200", "MAX_CACHE_ITEMS": "1000", "BROWSER_POOL_MIN": "1", "BROWSER_POOL_MAX": "5", "BROWSER_POOL_IDLE_TIMEOUT": "30000", "REBROWSER_PATCHES_RUNTIME_FIX_MODE": "addBinding", "REBROWSER_PATCHES_SOURCE_URL": "jquery.min.js", "REBROWSER_PATCHES_UTILITY_WORLD_NAME": "util", "REBROWSER_PATCHES_DEBUG": "0", "BROWSER_COOKIES_PATH": "C:\\path\\to\\cookies.json", "LOG_LEVEL": "info", "NO_COLOR": "0", "BUN_FORCE_COLOR": "1", "FORCE_COLOR": "1" } } } }

/ABSOLUTE/PATH/TO/web_search_mcpをサーバーディレクトリへの絶対パスに置き換えます。

ログ構成

次の環境変数はログ動作を制御します。

LOG_LEVEL : ログレベル（エラー、警告、情報、デバッグ）を設定します。デフォルト: 情報
NO_COLOR : 「1」に設定するとカラー出力が無効になります
BUN_FORCE_COLOR : Bun ランタイムでカラー出力を制御します (無効にするには「0」に設定します)
FORCE_COLOR : 色付き出力をグローバルに制御します（無効にするには「0」に設定します）

ボット検出回避

このサーバーはボット検出を回避するために rebrowser-puppeteer を使用しています:

ランタイム.リーク防止を有効にする:
- Runtime.Enable 検出を回避するために addBinding テクニックを使用します
- Webワーカーとiframeで動作します
- メインワールドコンテキストへのアクセスを維持
ソース URL マスキング:
- Puppeteer のソース URL を正規のスクリプトのように変更します
- 自動化ツールの検出を回避するのに役立ちます
ユーティリティワールド名:
- 汎用ユーティリティワールド名を使用する
- ワールド名のパターンによる検出を防止
ブラウザ起動構成:
- 自動化フラグを無効にする
- 最適化されたChrome引数を使用する
- ビューポートとウィンドウの設定を構成します

Claude Desktopでの使用

Claude Desktopがインストールされ、最新バージョンにアップデートされていることを確認してください。
Claude Desktop 構成ファイルを開きます。
- MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
上記の構成セクションに示すように、サーバー構成を追加します。
Claudeデスクトップを再起動します
ハンマーアイコンを探してくださいツールが利用可能であることを確認する

利用可能なツール

1. 検索ツール

{ name: "search", params: { query: string; trustedDomains?: string[]; excludedDomains?: string[]; resultCount?: number; safeSearch?: boolean; dateRestrict?: string; } }

2. URL表示ツール

{ name: "view_url", params: { url: string; includeImages?: boolean; includeVideos?: boolean; preserveLinks?: boolean; formatCode?: boolean; } }

トラブルシューティング

クロードデスクトップ統合の問題

ログを確認します:
# MacOS/Linux tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log
よくある問題:
- サーバーが表示されない: 設定ファイルの構文とパスを確認してください
- ツールの呼び出しが失敗しました: サーバーログを確認し、Claude Desktop を再起動してください
- パスの問題: 絶対パスを使用していることを確認してください

より詳細なトラブルシューティングについては、 MCP デバッグガイドを参照してください。

発達

# Run in development mode with watch bun --watch run dev # Run tests bun run test # Run linter bun run lint

重要な注意事項

ボット検出:
- ボット検出回避機能は、最も一般的な検出方法を防ぐのに役立ちます
- ただし、適切なプロキシやユーザーエージェントなどの追加対策が必要になる場合があります。
- 一部のウェブサイトでは、他の手段で自動化を検出する場合があります。
パフォーマンス：
- ブラウザインスタンスはプールされ、再利用されます
- アイドル状態のブラウザは自動的にクリーンアップされます
- リソース制限により過負荷を防止

ライセンス

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Google Search MCP Server