重要な注意: 使用する前に、組織が設定コンソールでWeb Searchツールを有効にしている必要があります。この設定は次の場所にあります: https://platform.claude.com/settings/capabilities(新しいタブで開きます)
Claudeには、ユーザーの質問に答えるために最新または専門的な情報をインターネットで検索できる組み込みのウェブ検索ツールが含まれています。実装を提供する必要がある他のツールとは異なり、Claudeは検索プロセス全体を自動的に処理します。つまり、有効にするための単純なスキーマを提供するだけで済みます。

ウェブ検索ツールの設定
ウェブ検索ツールを使用するには、次の必須フィールドを持つスキーマオブジェクトを作成します。
web_search_schema = {
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5
}max_uses フィールドは、Claudeが実行できる検索回数を制限します。Claudeは初期結果に基づいてフォローアップ検索を行う場合があるため、これにより過剰なAPI呼び出しを防ぎます。1回の検索で複数の結果が返されますが、Claudeは追加の検索が必要だと判断することがあります。
レスポンスの仕組み
Claudeがウェブ検索ツールを使用すると、レスポンスにはいくつかの種類のブロックが含まれます。
- テキストブロック - Claudeが何をしているかの説明
- ServerToolUseBlock - Claudeが使用した正確な検索クエリを示す
- WebSearchToolResultBlock - 検索結果を含む
- WebSearchResultBlock - タイトルとURLを持つ個々の検索結果
- 引用ブロック - Claudeの発言を裏付けるテキスト

レスポンス構造により、Claudeが実際に何を検索し、どのソースを見つけたかを正確に確認できます。引用には、Claudeが回答を裏付けるために使用した具体的なテキストと、ソースURLが含まれます。
検索ドメインの制限
allowed_domains フィールドを使用して、検索を特定のドメインに限定できます。これは、信頼できる権威あるソースが必要な場合に特に便利です。
web_search_schema = {
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5,
"allowed_domains": ["nih.gov"]
}たとえば、医療や運動に関するアドバイスを尋ねる場合、PubMed (nih.gov) などのドメインに制限することで、ランダムなブログコンテンツではなく、エビデンスに基づいた情報を得ることができます。

検索結果のレンダリング
レスポンス内の異なるブロックタイプは、特定のUIレンダリング向けに設計されています。
- テキストブロックは通常のコンテンツとしてレンダリングする
- ウェブ検索結果は上部にソースのリストとして表示する
- 引用は、ソースのドメイン、ページタイトル、URL、引用テキストを含めて、テキストにインラインで表示する

この構造は、ユーザーがClaudeがどのようにして答えにたどり着いたかを理解するのに役立ち、使用されているソースについての透明性を提供します。引用形式により、どの具体的な情報がどのソースから得られたかが明確になり、AIの回答への信頼を築きます。
実用的な使い方
ウェブ検索ツールは、次の用途に最適です。
- 最新の出来事や最近の動向
- Claudeの訓練データに含まれていない専門情報
- ファクトチェックや権威あるソースの発見
- 最新情報を必要とするリサーチ タスク
API呼び出しを行う際に、tools配列にこのスキーマを含めるだけで、Claudeはウェブ検索がユーザーの質問に答えるのに役立つかどうかを自動的に判断します。