Web Researcher MCP

web-researcher-mcp

あなたの AI リサーチアシスタントです。検索し、アクセス可能なページを読み、情報源を確認します。

SEC の提出書類、裁判記録、特許、臨床試験、全文論文など、ウェブや一次資料を検索できます。
LinkedIn や X のように、ご自身のログインが必要なページを含め、ページ全体を読み取ります。
すべての引用を確認し、チャットをまたいでリサーチを保持し、すべてをお使いのマシンで実行できます。
すぐに始めるのに API キーは不要です。

⭐ AI がでっち上げることにうんざりしていて、web-researcher-mcp が役に立ったら、ぜひスターを付けてください ⭐ — より多くのチームにこのプロジェクトを知ってもらう助けになります。

_{問題を描いたアニメーションと、実際のツール出力です。43 秒の動画を見る。}

Python ユーザー — uvx（コンパイル不要、あらゆる OS に対応）：

# One-time: install uv (skip if you already have it)
curl -LsSf https://astral.sh/uv/install.sh | sh        # macOS/Linux  (Windows: winget install astral-sh.uv)

claude mcp add --scope user web-researcher -- uvx web-researcher-mcp

uv がプラットフォームに適したビルド済みバイナリを取得して実行するため、Go もコンパイルも手動での PATH 設定も不要です。任意の MCP クライアントから uvx web-researcher-mcp を指定してください。uv tool install web-researcher-mcp または pip install web-researcher-mcp でも利用できます。

macOS（Homebrew）：

brew install zoharbabin/tap/web-researcher-mcp
claude mcp add --scope user web-researcher -- web-researcher-mcp

macOS / Linux（パッケージマネージャー不要）：

curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex"

開発ツールは不要です。どの方法でも同じ署名済みバイナリが提供され（PyPI のホイールにはバンドルされており、その他の方法ではダウンロードしてチェックサムを検証します）、PATH に追加されます。curl／PowerShell のインストーラーは、claude CLI が存在する場合、Claude Code への登録も自動で行います。Homebrew はバイナリをインストールするため、接続するには上記の claude mcp add の行を実行してください。

ワンクリックでインストール：

Cursor／VS Code／LM Studio のボタンを使うと、設定不要の uvx セットアップがインストールされます（エディターで追加前に確認を求められます。 uv が必要です。上記を参照してください）。API キーなしで DuckDuckGo ウェブ検索を実行できるため、すぐに試すのに最適です。image_search／news_search や、より高機能なプロバイダーにはキーが必要です（2分で設定できます。設定を参照）。**Claude Desktop：**お使いのプラットフォーム用の .mcpb バンドルをダウンロードしてダブルクリックする（Settings → Extensions）か、上記の uvx の行を使用してください。

別の MCP クライアントを使用する場合や、API キーを渡したい場合は、アプリごとの設定についてAI アシスタントへの接続を、検索プロバイダーの選択について設定を参照してください。

AI はウェブや一次情報源を検索し、ページを読み込み（ログインが必要なページを含む）、引用を確認して、複数ステップの調査を実行できるようになります。信頼できる情報源を選んでください。

Python SDK

from web_researcher_mcp import WebResearcherClient

async with WebResearcherClient() as client:
    response = await client.web_search("CRISPR off-target effects 2024", num_results=5)
    for r in response.results:
        verified = await client.verify_citation(r.url)
        print(r.title, "—", "✓" if verified.exists else "?")

詳しいドキュメント：docs/PYTHON_CLIENT.md

同期ラッパー（async を使用しないスクリプトやノートブック向け）：

with WebResearcherClient.sync() as client:
    response = client.web_search("climate change 2024")
    print(response.results[0].title)

できること

なぜこれがあるのか？

AIの回答は出典があるように見えて、実際にはそうでないことがよくあります。

• 裁判所： Charlotinデータベースには、AIが生成した幻覚を含むコンテンツが関係する裁判所の判決が2,200件以上掲載されています。2027-01-01から、California SB 574により、弁護士は裁判所に提出する書類の引用すべてを自分で確認する必要があります。
• 検索： 2026年のWashUによる監査では、Google AI Overviewsにおける検証可能な主張の約9件に1件が、引用先のページで裏付けられていないことが判明しました（著者らはこれを上限値としています）。CJRのTow Centerは8つのAI検索エンジンをテストし、いずれもニュースの引用が不適切であることを明らかにしました。
• あなたの仕事： 引用、公開、提出、またはクライアントへの提示が伴うなら、「おそらく本当」では不十分です。

この問題への対応： AIが、あなたの選んだ情報源から実際のページや記録を読み取り、その後、引用を確認します。すべての主張を、あなたが開けるリンクまでたどれます。

Claude、Claude Desktop、Cursor、VS Code、Codex、Gemini CLI、およびMCPに対応するあらゆるAIアシスタントで動作します。

どのような人に使われていますか

• 学術研究者 — 「でっち上げの引用ではなく、実在する DOI を使った文献レビューが必要です」
• ビジネスアナリスト — 「納品物に、クライアントが実際にクリックして確認できる出典が必要です」
• 弁護士 — 「存在しない判例を引用したら、50,000 ドルの罰金を科されます」
• ジャーナリスト — 「Perplexity の要約ではなく、政府記録や裁判所への提出書類を照合する必要があります」
• 医学研究者 — 「健康ブログに基づく臨床判断は、誰かを傷つけるおそれがあります」
• 大学院生 — 「AI がでっち上げた引用を追跡するのに、3 時間もかかりました」
• 市場調査・営業調査担当者 — 「最も役立つ情報は、サインインしないと開けないページにあります」
• エンタープライズチーム — 「競合調査を第三者のサーバー経由で行うことはできません」
• エージェントを構築する開発者 — 「クエリごとの課金やベンダーロックインなしで、検索とページの読み取りをしたいです」

比較

各ベンダーの公開ドキュメントに基づきます。2026年10月時点。古い情報があれば、issue を作成してください。

使い分け

• 組み込みの AI 検索 — 出典を引用する必要がない、気軽な調べもの
• 検索 API — ランキングされたリンクだけが必要な場合。このツールと組み合わせれば（どの API もプロバイダーとして接続できます）、ページの読み取りや引用の確認もできます
• 論文ツール — 学術論文データベースを1つ閲覧する場合
• web-researcher-mcp — 研究に自分の評判がかかっている場合全般：クライアント向け業務、裁判所への提出書類、出版物、助成金の申請、医療上の判断、ジャーナリズム

AI でできること

オプトインツール。 これらの機能は、有効にするまでオフのままです。個人データを扱う機能には、記録された同意も必要です。

正規版の、CI で検証済みのツール一覧と完全なスキーマについては、docs/TOOLS.md を参照してください。

すぐに使える調査テンプレート

このサーバーには、AI アシスタントがワンクリックで呼び出せる、ガイド付きのプロンプトテンプレートも用意されています。実績のある複数ステップのプロセスに沿って進めるため、指示を一つひとつ指定する必要はありません。

ほとんどの AI アプリでは、プロンプトや「/」コマンドを選ぶ場所に表示されます。サーバーは、ライブのステータスリソース（stats://tools、stats://sessions、stats://rate-limits、stats://providers）、レンズカタログ（lenses://catalog）、診断情報（diagnostics://errors/recent、diagnostics://health、diagnostics://panel/spend）、大容量ペイロード用のアーティファクトストア（research://artifact/{id}）を公開しているため、あなたや AI は使用状況、制限、稼働中のプロバイダーを確認できます。全一覧については、docs/DEPLOYMENT.md を参照してください。

クイックスタート

オプション 1：Homebrew（macOS / Linux — 推奨）

brew install zoharbabin/tap/web-researcher-mcp
claude mcp add --scope user web-researcher -- web-researcher-mcp

Homebrew が信頼性の確保、更新、PATH の設定を自動で処理するため、署名に関する警告は表示されません。

オプション 2：ワンコマンドでインストール（すべての OS 対応 — 開発ツール不要）

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex"

バイナリをダウンロードし、署名済みリリースの SHA-256 チェックサムと照合して検証したうえで、PATH に配置し、インストール済みの場合は Claude Code に登録します。インストール先を変更するには、次のようにします。

INSTALL_DIR=/opt/tools curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

# Using any AUR helper (yay, paru, etc.)
yay -S web-researcher-mcp

# Run without installing
nix run github:zoharbabin/web-researcher-mcp

# Add to your flake inputs
nix profile install github:zoharbabin/web-researcher-mcp

{
  "mcpServers": {
    "web-researcher": {
      "command": "uvx",
      "args": ["web-researcher-mcp"]
    }
  }
}

winget install zoharbabin.web-researcher-mcp

scoop bucket add zoharbabin https://github.com/zoharbabin/scoop-bucket
scoop install web-researcher-mcp

choco install web-researcher-mcp

brew install --cask zoharbabin/tap/web-researcher-mcp

go install github.com/zoharbabin/web-researcher-mcp/cmd/web-researcher-mcp@latest
claude mcp add --scope user web-researcher -- web-researcher-mcp

# STDIO mode needs -i so the container's stdin stays attached for MCP JSON-RPC
docker run -i --rm \
           -e SEARCH_PROVIDER=brave \
           -e BRAVE_API_KEY=YOUR_KEY \
           docker.io/zoharbabin/web-researcher-mcp:latest

git clone https://github.com/zoharbabin/web-researcher-mcp.git
cd web-researcher-mcp
go build -o web-researcher-mcp ./cmd/web-researcher-mcp

AI アシスタントに接続する

インストールスクリプトにより、Claude Code には自動的に登録されます。それ以外のアプリでは、AI の設定ファイルに追加してください。

{
  "mcpServers": {
    "web-researcher": {
      "command": "web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "brave",
        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY"
      }
    }
  }
}

まだキーをお持ちでない場合は、env を省略してください。DuckDuckGo は設定不要で使えます。

その他のクライアント：

Configuration テーブルに記載されているプロバイダーに置き換えるには、SEARCH_PROVIDER とそのプロバイダーのキーを設定してください。これで完了です。AI アシスタントがすべての調査ツールを利用できるようになります。

設定

API キーは不要です。 DuckDuckGo は組み込みの、設定不要なフォールバックです。インストールすればすぐ使えます。検索結果の品質を高め、画像検索やニュース検索を利用するには、以下のプロバイダーからいずれか1つを追加してください。いずれも任意で、相互に切り替え可能です。すでに利用しているもの、または好みのものを選んでください。サーバーはすべてのプロバイダーを同等に扱います。

検索プロバイダー

SEARCH_PROVIDER=<name> を設定し、該当プロバイダーのキーを指定してください。すべてのプロバイダーは検索レンズに対応しており、任意のプロバイダーを組み合わせて自動フェイルオーバーを利用できます（検索プロバイダーを参照）。

Google PSE は終了予定です。 Google は Custom Search JSON API の新規顧客の受付を終了し、2027-01-01 にサービスを終了します（Google）。既存のキーはその日まで使用できます。新しく設定する場合は、Brave、Serper、SearXNG、または別のプロバイダーを使用してください。

各プロバイダーには、それぞれ無料枠、登録手順、対応機能（画像、ニュース、鮮度）があります。詳しい比較（インデックスの分類、機能マトリックス、用途別の選び方）は docs/PROVIDERS.md を、キーの設定手順は docs/API_SETUP.md を参照してください。複数のプロバイダーを設定すると、サーバーが自動的にフェイルオーバーします。詳しくは検索プロバイダーを参照してください。

SEARCH_PROVIDER が未設定の場合、キーが設定されていればサーバーは Google を使用し、設定されていなければ設定不要の DuckDuckGo プロバイダーにフォールバックします。そのため、キーの有無にかかわらず、すぐに利用できます。

学術検索（任意 — 登録不要）

学術検索プロバイダー（OpenAlex、CrossRef）では、連絡先メールアドレスを指定すると、ポライトプール経由でより高速にアクセスできます。登録は不要で、メールアドレスだけで利用できます。設定方法は docs/API_SETUP.md、変数の一覧は docs/DEPLOYMENT.md を参照してください。

これらを設定すると、academic_search は DOI、著者、引用数、オープンアクセスの PDF リンクを含む実際の論文を返します。設定しなくても利用できますが、フォールバックとしてウェブ検索を使用します。

特許検索（任意）

特許プロバイダー（EPO、USPTO、The Lens）で構造化された特許データを取得するには、API キーが必要です。設定手順は docs/API_SETUP.md、変数の一覧は docs/DEPLOYMENT.md を参照してください。

これらを設定すると、patent_search は分類コード、日付、発明者を含む構造化された特許データを返します。設定しない場合は、ウェブ検索にフォールバックします。

内部の仕組み

検索プロバイダー

リサーチに使用する検索エンジンを選択できます。どのプロバイダーもレンズに対応しています。

複数のプロバイダー（推奨）

複数の検索エンジンを設定しておけば、いずれかに問題が発生してもリサーチを続けられます。

export SEARCH_ROUTING=brave,serper,duckduckgo

Brave が停止している場合は、自動的に Serper を試します。Serper がレート制限されている場合は、DuckDuckGo に切り替えます。リサーチをそのまま続けられます。

プロバイダーの詳細な比較（インデックスの分類、機能、無料枠）については docs/PROVIDERS.md を、詳細なルーティングオプション（トピックごとのルーティング、特許に特化したプロバイダーなど）については docs/DEPLOYMENT.md を参照してください。

単一のプロバイダー

検索 API キーが 1 つしかない場合でも問題ありません。設定するだけで利用できます。

export SEARCH_ROUTING=brave,serper
export BRAVE_API_KEY=BSAxxxxxxxxxx
export SERPER_API_KEY=...

export SEARCH_PROVIDER=brave
export BRAVE_API_KEY=BSAxxxxxxxxxx

export SEARCH_PROVIDER=searxng
export SEARXNG_URL=http://localhost:8080

export SEARCH_PROVIDER=exa
export EXA_API_KEY=...

export SEARCH_PROVIDER=brave
export BRAVE_API_KEY=BSA...

検索レンズ

検索レンズを使うと、AI が検索できるウェブサイトを制御できます。ウェブ全体を検索してブログやスパム、AI 生成の低品質なコンテンツを取得する代わりに、レンズを使えば、そのトピックで信頼できる情報源だけに検索結果を絞り込めます。

組み込みレンズ

信頼できるドメインをリストするだけで、どの分野にも対応した独自のレンズを作成できます。

仕組み

あなた（または AI）がレンズを使うと、結果はそのレンズに含まれるサイトからのみ取得されます。たとえば、medical レンズを使うと、AI は PubMed、WHO、NIH などの臨床情報源を検索し、健康ブログやサプリメント広告は検索しません。

AI に依頼すると、レンズは自動的に使われます。たとえば、「clinical レンズを使って、SGLT2 阻害薬に関する最近の知見を検索してください。」 のように依頼できます。

{
  "name": "my-industry",
  "description": "Only searches sources I trust for my field",
  "domains": [
    "trusted-source.com",
    "industry-journal.org",
    "official-database.gov"
  ],
  "cx": ""
}

export CUSTOM_LENSES_PATH=/path/to/my-lenses

プライバシーとセキュリティ

調査クエリは、お使いのマシンから選択した検索プロバイダーに直接送信されます。当社のサーバーを経由することはありません（当社はサーバーを運用していません）。ツールはすべてお使いのコンピューター上で実行されます。

個人データを保存する機能（ログイン情報の保存、メモリ、分析、ワークスペース）は、デフォルトでオフになっています。それぞれの機能を有効にするには、オプトイン、同意の記録、暗号化されたストレージが必要です。

各 AI アプリのセットアップ

Claude Code

MCP 設定（~/.claude.json）に追加します。使用するプロバイダーの SEARCH_PROVIDER と対応するキーを設定してください（設定の表を参照）。以下の例では Brave を使用しています。

{
  "mcpServers": {
    "web-researcher": {
      "command": "/path/to/web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "brave",
        "BRAVE_API_KEY": "BSA..."
      }
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "web-researcher": {
      "command": "/path/to/web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "brave",
        "BRAVE_API_KEY": "BSA..."
      }
    }
  }
}

Cursor

プロジェクトのルートにある .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "web-researcher": {
      "command": "/path/to/web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "brave",
        "BRAVE_API_KEY": "BSA..."
      }
    }
  }
}

HTTP モード（チーム／共有サーバー）

チームで 1 つの共有インスタンスに接続する場合は、次のように設定します。

PORT=3000 \
OAUTH_ISSUER_URL=https://auth.example.com \
OAUTH_AUDIENCE=https://api.example.com \
./web-researcher-mcp

任意の AI アプリを http://localhost:3000/mcp/ に接続します。

services:
  web-researcher:
    image: zoharbabin/web-researcher-mcp
    ports:
      - "3000:3000"
    environment:
      PORT: "3000"
      SEARCH_PROVIDER: brave
      BRAVE_API_KEY: ${BRAVE_API_KEY}

注： ツールの動作はすべての接続モード（STDIO と HTTP）で同一です。違いは認証（HTTP では OAuth が必要）とレート制限（HTTP ではテナントごとの制限が適用され、STDIO では上流 API のクォータのみが適用されます）だけです。詳細は docs/DEPLOYMENT.md を参照してください。

パフォーマンス

検索結果は 1 秒未満で返されます。以前に取得した結果はキャッシュされるため、再検索は瞬時に完了します。ウェブ上の記事の 95％以上を完全に抽出でき、ボットをブロックしようとするサイトにも対応しています。JavaScript を多用するサイトでは、バックグラウンドで実際のブラウザーを使用します（自動で動作し、設定は不要です）。

開発

go build -o web-researcher-mcp ./cmd/web-researcher-mcp   # Build
go test -race ./...                                        # Test (with race detector)
make verify                                                # Full CI gate (see Makefile for steps)

lint、gosec、govulncheck の各ツールは go.mod のツールディレクティブでバージョンが固定されているため、make verify を実行すると CI と同じバージョンで実行されます（グローバルへのインストールは不要です）。ブランチ保護では、Lint、Test、Security、E2E の各チェックへの合格が必須です。

開発ワークフロー、コードスタイルガイド、PR の手順については、CONTRIBUTING.md を参照してください。

トラブルシューティング

rm -f /path/to/web-researcher-mcp
cp /path/to/new-build /path/to/web-researcher-mcp
codesign --force -s - /path/to/web-researcher-mcp   # ad-hoc re-sign

コントリビューション

コントリビューションを歓迎します。コードスタイルのガイドライン、開発ワークフロー、プルリクエストの提出方法については、CONTRIBUTING.mdをご覧ください。

ドキュメント

ライセンス

MIT

Zohar Babin が Go と Model Context Protocol を使用して開発