ウェブ検索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