Claude Codeのネットワーク検索2つの方法を理解する:内蔵WebSearchと6つの主要MCP検索プラグイン比較ガイド

作者注:Claude Codeに標準搭載されているWebSearchとWebFetchのインターネット検索ツールの仕組みと制限を詳細に解説し、Brave Search、Tavily、Exaなど6つの主要なMCP検索プラグインを比較します。追加の検索MCPをインストールする必要があるかどうかを判断するためのガイドです。

Claude Codeのインターネット検索機能は多くの開発者が関心を持つトピックです。Claude CodeにはWebSearchとWebFetchという2つのインターネットツールが標準で搭載されていますが、それでもBrave Search MCPやTavily MCPなどの検索プラグインをインストールする必要があるのでしょうか?本記事では技術的な仕組みの観点から、これら2つの方法の動作原理と適切な使用シナリオを詳しく解説し、あなたのワークフローに最適な選択をサポートします。

本記事の価値: この記事を読むことで、Claude Codeのインターネット検索機能(標準ツールとMCPプラグイン)のそれぞれの能力範囲と、どのような状況でどちらのソリューションを使用すべきかを明確に理解できるようになります。

claude-code-web-search-websearch-mcp-guide-ja 图示


Claude Code ネットワーク検索の核心ポイント

ポイント 説明 価値
2つのネットワークツールを内蔵 WebSearch(検索)+ WebFetch(ページ取得) 設定不要で即利用可能
MCP検索プラグインはオプション Brave Search、Tavily、Exa など6種類以上 より高品質、機能豊富
ほとんどのシナリオで内蔵機能で十分 日常的な検索、ドキュメント確認、情報検証 追加インストール不要
特定シナリオではMCPを推奨 一括クロール、技術文書の深い検索、プライバシー要件 必要に応じて選択

Claude Code ネットワーク検索の核心結論

結論から言うと: ほとんどの開発者にとって、Claude Code に内蔵されている WebSearch + WebFetch の組み合わせで日常的なネットワーク検索ニーズは十分満たせます。追加の検索MCPは不要です。ただし、検索品質、検索結果の制御、または一括ウェブページクロールに高い要件がある場合は、検索MCP(Brave Search MCP推奨)をインストールすることで大幅な向上が期待できます。

これは、ブラウザに内蔵されている検索ボックスがほとんどの人には十分ですが、より良い体験を得るために専用の検索プラグインをインストールする人がいるのと同じです——鍵はあなたの具体的な使用シナリオにあります。


Claude Code 内蔵ネットワーク検索ツールの詳細解説

Claude Code には、互いに連携する2つのネットワークツールが内蔵されています:WebSearch は検索を担当し、WebFetch はページ内容の取得を担当します。

WebSearch ツール:検索エンジン

WebSearch は Claude Code の検索エントリーポイントで、検索キーワードを受け取り、関連するウェブページのタイトルとリンクを返します。

パラメータ 説明
query 検索キーワード(必須、2文字以上)
allowed_domains 指定ドメインの結果のみ返す(オプション)
blocked_domains 指定ドメインの結果を除外(オプション)

WebSearch の動作原理:

  1. Claude Code があなたの検索リクエストを受け取る
  2. セカンダリ会話(secondary conversation)を生成し、Anthropic サーバーサイドの web_search ツールを呼び出す
  3. このサーバーサイド検索エンジンは Claude.ai ウェブ版の検索機能と同じバックエンドを使用
  4. 返される結果にはタイトルとURLのみ含まれ、ページ本文の内容は含まれない

claude-code-web-search-websearch-mcp-guide-ja 图示

WebFetch ツール:ページ内容取得

WebFetch は既知の URL と具体的な質問を受け取り、そのページの内容を取得して質問に対する要約回答を返します。

パラメータ 説明
url ターゲットウェブページのURL(必須、≤2000文字)
prompt ページ内容に関する具体的な質問(必須)

WebFetch の内部処理フロー:

  1. URL検証: 長さチェック、HTTPからHTTPSへの自動アップグレード、認証情報の除去
  2. ドメインセキュリティチェック: domain_info エンドポイントを呼び出してブラックリストを確認、robots.txtを考慮
  3. ページ取得: Axiosを使用してローカルで取得、同一ドメイン内のリダイレクトは自動追跡、クロスドメインリダイレクトは個別処理が必要
  4. 内容変換: HTMLをTurndownライブラリでMarkdownに変換、100KBを超える場合は自動的に切り捨て
  5. AI要約: Claude Haiku 3.5によって処理され、あなたの質問に対する要約回答を返す

重要な設計詳細:

  • 15分キャッシュ: 同じURLへの15分以内の再アクセスはキャッシュを使用
  • 約10MBサイズ制限: 取得時の最大ページサイズ
  • 生の内容は返さない: WebFetchは要約回答のみを返し、生のHTMLやMarkdownは返さない

🎯 設計目的: Anthropicは意図的に生の内容を返さないように設計しています。理由は3つあります:(1)完全なページは通常10-100KBで、直接メインモデルにプッシュするのはコストが高く、コードコンテキストを圧迫する;(2)プロンプトインジェクション攻撃の対象を制限する;(3)著作権コンプライアンス——引用は125文字以内に制限。

Claude Code ネットワーク検索内蔵ツールの制限

制限 説明 影響度
2段階操作 まずWebSearchで検索、次にWebFetchで内容取得 ⭐⭐ 中程度
生の内容がない WebFetchは要約のみを返し、生のHTML/Markdownは返さない ⭐⭐⭐ 高い
検索結果が限定的 WebSearchが返す結果数は限られており、タイトルとURLのみ含む ⭐⭐ 中程度
クロスドメインリダイレクト クロスドメインリダイレクトは自動追跡せず、追加リクエストが必要 ⭐ 低い
プラットフォーム制限 WebSearchはAWS Bedrock/Google Vertexでは利用不可 ⭐⭐ 特定シナリオ
一括操作がない 一括検索や一括ページクロールをサポートしない ⭐⭐ 中程度

Claude Code インターネット検索 MCP プラグイン比較

Claude Code の組み込みツールでニーズを満たせない場合、以下の6つの主要な MCP 検索プラグインが利用可能です:

MCP プラグイン コア特徴 無料枠 最適なシナリオ
Brave Search MCP Anthropic 公式推奨、独立インデックス、プライバシー優先 2,000 回/月 汎用検索、プライバシー重視
Tavily MCP AI 最適化結果、コアコンテンツ自動抽出 1,000 回/月 技術文書、開発関連クエリ
Exa MCP セマンティック検索、コード検索能力が高い 無料オープンソース コード検索、学術研究
Perplexity Ask MCP LLM 駆動、総合回答+引用付き $1/M tokens 複雑な問題の総合回答
Open-WebSearch MCP オープンソース多エンジン(Bing/DuckDuckGo等) 完全無料 予算制限あり、基本検索
Firecrawl MCP ウェブスクレイピング+AI処理、8種類のツール 無料層あり バッチスクレイピング、データ抽出

claude-code-web-search-websearch-mcp-guide-ja 图示

Brave Search MCP インターネット検索の詳細

Brave Search MCP は Anthropic 公式推奨の検索 MCP で、最も広く使用されている検索プラグインです。Anthropic 公式の modelcontextprotocol/servers リポジトリに含まれています。

コアアドバンテージ:

  • Brave 独立検索インデックスを使用(Google/Bing 転売ではない)、検索結果が多様
  • プライバシー優先、ユーザー検索行動を追跡しない
  • 無料層で月2,000回クエリ、個人開発者には十分
  • コミュニティフィードバックでは Claude Code 組み込み WebSearch よりも検索品質が優れている

Tavily MCP インターネット検索の詳細

Tavily は AI Agent 向けに設計された検索エンジンで、その MCP プラグインは特に技術文書と開発関連クエリに優れています。

コアアドバンテージ:

  • 検索結果が AI 最適化され、コアコンテンツを直接抽出
  • コンテンツ抽出(extract)、サイトマップ(map)、クロール(crawl)機能をサポート
  • 技術文書クエリの精度が汎用検索エンジンよりも高い
  • 月1,000回の無料クエリ

Claude Code ネットワーク検索ソリューション比較:標準機能 vs MCP

標準ツールとMCPプラグインの選択基準

判断基準 標準WebSearch/WebFetchを選ぶ場合 MCP検索プラグインを選ぶ場合
検索頻度 時々検索、情報の確認程度 頻繁に検索、深い調査が必要
結果の質 基本的な用途には十分 より高品質/多くの結果が必要
生コンテンツ 元のHTML/Markdownは不要 完全なページ内容の取得が必要
検索エンジン 検索エンジンにこだわらない 特定のエンジンが必要(Brave/Google)
一括操作 一括検索は不要 一括検索やクロールが必要
プライバシー要件 特別な要件なし プライバシー保護が必要
設定の手間 追加設定をしたくない 5分程度の設定は問題ない

典型的なシナリオ別の選択:

  • 日常開発でのAPIドキュメント検索 → 標準ツールで十分
  • 特定のエラー情報の解決策確認 → 標準ツールで十分
  • 技術記事執筆のための深い調査 → Tavily MCPを推奨
  • プライバシー保護が必要な検索 → Brave Search MCPを推奨
  • 競合サイト情報の一括収集 → Firecrawl MCPを推奨
  • コード検索や学術研究 → Exa MCPを推奨
  • リンクではなく総合的な回答が必要 → Perplexity MCPを推奨

💡 実用的なアドバイス: Claude Codeは複数のMCP検索プラグインを同時に設定でき、クエリ内容に基づいて最適なツールを自動選択します。検索品質にこだわる場合は、少なくとも1つのBrave Search MCPを補完としてインストールすることをお勧めします。APIYI apiyi.comを通じてClaudeモデルを呼び出し、カスタム検索ロジックと組み合わせることで、より柔軟なネットワーク検索ソリューションを実現することも可能です。


Claude Code ネットワーク検索 MCP インストール設定

Brave Search MCP インストール(推奨)

第1ステップ: APIキーの取得

Brave Search APIページにアクセス: brave.com/search/api 、無料アカウントを登録してAPIキーを取得(無料2,000回/月)。

第2ステップ: MCPサーバーの追加

# Claude Codeターミナルで実行
claude mcp add brave-search \
  npx -y @anthropic/mcp-brave-search \
  --api-key YOUR_BRAVE_API_KEY

Tavily MCP インストール方法を表示
# Tavily APIキーの取得: tavily.com
# Tavily MCPサーバーの追加
claude mcp add tavily-search \
  npx -y tavily-mcp@latest \
  --api-key YOUR_TAVILY_API_KEY

Tavilyの無料プランでは月1,000回のクエリを提供し、技術ドキュメント検索シナリオに適しています。

Exa MCP インストール方法を表示
# Exa APIキーの取得: exa.ai
# Exa MCPサーバーの追加
claude mcp add exa-search \
  npx -y exa-mcp-server \
  --api-key YOUR_EXA_API_KEY

Exaはセマンティック検索とコード検索に優れており、研究型クエリに適しています。

MCP 設定管理

# インストール済みMCPサーバーの確認
claude mcp list

# 特定のMCPサーバーの削除
claude mcp remove brave-search

# プロジェクトレベル設定(チーム共有)
claude mcp add --scope project brave-search \
  npx -y @anthropic/mcp-brave-search

# ユーザーレベル設定(個人のみ、~/.claude.jsonに保存)
claude mcp add --scope local brave-search \
  npx -y @anthropic/mcp-brave-search \
  --api-key YOUR_KEY

セキュリティアドバイス: APIキーを含むMCP設定は、--scope localを使用して個人設定に保存し、APIキーがプロジェクトリポジトリに漏洩するのを防ぐことをお勧めします。チーム共有設定では--scope projectを使用し、APIキーは環境変数を通じて注入します。

Claude Code インターネット検索実践例

組み込み WebSearch の使用

Claude Code でインターネット情報が必要な質問をすると、自動的に WebSearch が呼び出されます:

# Claude Code で直接質問
> React 19 の最新の Server Components の変更点を調べてください

# Claude Code が自動的に WebSearch を呼び出して検索
# その後 WebFetch を呼び出して関連ページの要約内容を取得
# 最後に情報を統合して質問に回答

MCP 検索プラグインの使用

Brave Search MCP をインストールすると、Claude Code は利用可能なツールから自動的に選択して使用します:

# Brave Search MCP インストール後
> 最新の Node.js セキュリティアドバイザリを検索してください

# Claude Code は Brave Search MCP を使用する可能性があります
# より豊富な検索結果を返します
# より多くのコンテキスト情報を含みます

API を通じたカスタムインターネット検索の実装

自分のプロジェクトで同様のインターネット検索機能を実装する必要がある場合は、Claude API と検索ツールを組み合わせて実現できます:

import openai
import requests

def search_and_analyze(query: str) -> str:
    """検索エンジンと Claude を組み合わせたインターネット検索分析の実装"""
    # ステップ1: 検索APIを使用して結果を取得
    # Brave Search API、Tavily API などを使用可能
    search_results = requests.get(
        "https://api.search.brave.com/res/v1/web/search",
        headers={"X-Subscription-Token": "YOUR_BRAVE_KEY"},
        params={"q": query, "count": 5}
    ).json()

    # ステップ2: 検索結果を Claude に分析させる
    client = openai.OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://vip.apiyi.com/v1"
    )

    context = "\n".join([
        f"- {r['title']}: {r['url']}"
        for r in search_results.get("web", {}).get("results", [])
    ])

    response = client.chat.completions.create(
        model="claude-sonnet-4-6",
        messages=[
            {"role": "system", "content": "以下の検索結果に基づいて、ユーザーの質問に回答してください。"},
            {"role": "user", "content": f"検索結果:\n{context}\n\n質問: {query}"}
        ]
    )
    return response.choices[0].message.content

推奨: APIYI apiyi.com を通じて Claude API を呼び出し、Brave Search API などの検索サービスと組み合わせることで、より柔軟なインターネット検索ソリューションを構築できます。プラットフォームは無料テスト枠と OpenAI 互換インターフェースを提供しており、迅速なソリューション検証に適しています。


Claude Code インターネット検索高度なテクニック

テクニック 1: domain フィルターを使用した検索最適化

Claude Code の WebSearch はドメインフィルターをサポートしており、検索範囲を正確に制御できます:

# 公式ドキュメントのみを検索
> docs.python.org で asyncio の使用方法を検索してください

# Claude Code は allowed_domains パラメータを使用します
# 結果を docs.python.org からのみに制限します

テクニック 2: 複数 MCP 検索エンジンの連携

Claude Code は複数の検索 MCP の同時設定をサポートしており、クエリタイプに基づいて自動的に選択します:

  • 一般的な質問 → Brave Search または組み込み WebSearch を自動選択
  • 技術ドキュメント → Tavily を自動選択(インストール済みの場合)
  • コード例 → Exa を自動選択(インストール済みの場合)

テクニック 3: WebFetch による既知 URL の直接読み取り

対象ページの URL が既にわかっている場合は、検索ステップをスキップして、Claude Code に直接 WebFetch を使用させることができます:

# 指定されたURLの内容を直接読み取る
> https://docs.anthropic.com/claude/docs を読んで、最新のAPI変更点を教えてください

🎯 技術的アドバイス: CI/CD プロセスでインターネット検索機能を頻繁に使用する必要がある場合は、APIYI apiyi.com プラットフォームを通じて Claude API を呼び出し、Brave や Tavily の検索 API と組み合わせて、自動化された情報取得パイプラインを構築することをお勧めします。プラットフォームは OpenAI 互換インターフェースをサポートしており、既存のツールチェーンとの統合が容易です。

よくある質問

Q1: Claude Code の WebSearch と Claude.ai ウェブ版の検索は同じですか?

はい、両者は同じバックエンドの検索エンジンを使用しています。Claude Code の WebSearch ツールは Anthropic サーバーサイドの web_search ツールを呼び出しており、これは Claude.ai ウェブ版の検索機能と同じ検索バックエンドを共有しています。主な違いは、Claude Code の WebSearch はタイトルと URL のみを返すのに対し、Claude.ai ウェブ版は検索結果の要約を直接表示することです。

Q2: 検索 MCP をインストールした後、Claude Code はどのツールを優先して検索に使用しますか?

Claude Code は、クエリの内容とコンテキストに基づいて、最も適切な検索ツールを自動的に選択します。Brave Search MCP と組み込みの WebSearch の両方をインストールしている場合、Claude Code はクエリの種類に応じて柔軟に選択する可能性があります。また、プロンプトで使用するツールを明示的に指定することもできます。実際の使用では、コミュニティからのフィードバックによると、Claude Code は MCP 検索ツールをインストールした後、より豊富な結果を提供する MCP ツールを優先して使用する傾向があります。API を通じてカスタム検索ソリューションを構築する必要がある場合は、APIYI apiyi.com が統一された Claude モデル呼び出しインターフェースを提供しています。

Q3: 無料ユーザーと有料ユーザーのインターネット検索には違いがありますか?

Claude Code の組み込みインターネットツール(WebSearch/WebFetch)は、すべての Claude Code ユーザーが利用可能で、無料・有料の区別はありません。ただし、使用頻度は Claude Code の利用制限(Pro/Max プランで異なる)の影響を受けます。MCP 検索プラグインの利用枠は、各検索サービスの無料層の制限(例:Brave 2,000 回/月、Tavily 1,000 回/月)に依存し、Claude のサブスクリプションプランとは関係ありません。


まとめ

Claude Code のインターネット検索に関する 3 つの核心ポイント:

  1. 組み込みツールで十分: Claude Code に組み込まれた WebSearch + WebFetch の組み合わせは、インターネット検索ニーズの 80% を満たします。WebSearch は検索してリンクを返し、WebFetch はページの要約を取得する役割を担い、両者が連携して完全な検索フローを形成します。
  2. MCP 検索はさらなる向上: Brave Search MCP(公式推奨、無料 2,000 回/月)と Tavily MCP(技術文書に強い)は、最もインストールする価値のある 2 つの検索プラグインであり、検索品質と結果の豊富さにおいて顕著な向上をもたらします。
  3. 必要に応じて選択: 日常的な開発でのドキュメント検索 → 組み込みツール;深い調査と一括取得 → MCP をインストール;自動化プロセスに検索を統合する必要がある場合 → APIYI apiyi.com を通じて Claude API と検索サービス API を組み合わせて呼び出します。

Claude Code のインターネット検索の設計哲学は「メインエージェントを軽量に保つ」ことです。組み込みツールは、セキュリティ、著作権コンプライアンス、パフォーマンスの間で良好なバランスを取っています。実際のニーズに基づいて追加の検索 MCP をインストールするかどうかを選択し、過剰な構成を避けましょう。

📚 参考文献

  1. Claude Code Web Tools 詳細解析: WebSearch と WebFetch の内部実装原理

    • リンク: mikhail.io/2025/10/claude-code-web-tools/
    • 説明: Claude Code のネットワーク接続ツールの技術実装をリバースエンジニアリングで分析
  2. Web Search Tool 公式ドキュメント: Claude API 検索ツールの説明

    • リンク: platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool
    • 説明: Anthropic 公式の WebSearch ツール API ドキュメント
  3. Web Fetch Tool 公式ドキュメント: Claude API ページ取得ツールの説明

    • リンク: platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool
    • 説明: Anthropic 公式の WebFetch ツール API ドキュメント
  4. MCP 検索プラグイン統合ガイド: 複数の MCP 検索サービス比較とインストールチュートリアル

    • リンク: intuitionlabs.ai/articles/mcp-servers-claude-code-internet-search
    • 説明: 8種類の MCP 検索プラグインの詳細比較と使用アドバイス
  5. Brave Search MCP: Anthropic 公式推奨の検索 MCP

    • リンク: brave.com/search/api/guides/use-with-claude-desktop-with-mcp/
    • 説明: Brave Search MCP のインストールと使用ガイド

著者: APIYI 技術チーム
技術交流: コメント欄であなたの Claude Code ネットワーク検索設定経験を共有してください。その他の AI 開発資料は APIYI docs.apiyi.com ドキュメントセンターでご覧いただけます

類似投稿