Claude APIのWeb検索ツール（web search tool）を使うと、モデルが回答の生成中に必要と判断したタイミングで自動的にWeb検索を行い、最新の情報にもとづいて引用つきで回答できます。学習データのカットオフ以降の出来事や、リアルタイム性が求められる質問に強くなります。本ページはAnthropic公式ドキュメントの非公式な日本語訳・要約です。
Web検索ツールとは
Web検索ツールは、Anthropicがサーバー側で実行する「組み込みツール（server tool）」のひとつです。開発者が自前で検索APIを用意する必要はなく、リクエストのtoolsにWeb検索ツールを追加しておくだけで、Claudeが「今は検索したほうがよい」と判断したときに検索クエリを組み立て、Anthropic側が検索を実行して結果をモデルに渡します。
通常のツール使用（function calling）ではツールの実行を開発者のコード側で行いますが、Web検索は実行までAnthropicが担うため、1回のAPIリクエストの中で検索から回答生成までが完結します。Claudeは必要に応じて複数回検索を行い、集めた情報を統合して回答します。
有効化と基本的な使い方
Messages APIのtools配列にWeb検索ツールを追加します。ツールタイプと名前を指定し、max_usesで1リクエストあたりの検索回数の上限を設定できます。
{
"model": "claude-sonnet-...",
"max_tokens": 1024,
"tools": [
{
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5
}
],
"messages": [
{ "role": "user", "content": "今週の主要な出来事を教えて" }
]
}検索してほしくない場合や特定サイトに限定したい場合は、allowed_domains（許可ドメイン）やblocked_domains（除外ドメイン）で対象を絞り込めます。ユーザーの地域に応じた結果が必要なときはuser_locationを指定できます。実際に利用できるモデルやパラメータの詳細は公式ドキュメントで確認してください。
検索結果と引用の扱い
Web検索を使った回答では、レスポンスに検索結果（web_search_tool_result）と、回答本文に対応する引用（citations）が含まれます。引用にはタイトルやURLなどの出典情報が付くため、Claudeがどの情報源にもとづいて答えたのかを確認できます。
そのため、UI側で「出典リンク付きの回答」を表示するのが基本的な使い方になります。引用を利用者に提示することで、回答の根拠をたどれるようにし、誤情報の混入を検知しやすくなります。
料金と制限
Web検索ツールには、通常の入力・出力トークン料金に加えて、検索の実行回数に応じた料金がかかります（公式には1,000回の検索あたりの単価が定められています）。max_usesで検索回数の上限を設けることで、コストの上振れを抑えられます。
利用できるモデルや、地域・データの扱いに関する制約は変わる可能性があります。最新の料金と対応モデル、制限事項は必ずAnthropic公式ドキュメントで確認してください。
ベストプラクティス
- 検索が不要な質問まで毎回検索させないよう、システムプロンプトで「最新情報が必要なときだけ検索する」といった方針を明示する。
max_usesで回数上限を設定し、コストと応答時間を管理する。- 情報の信頼性が重要な用途では、
allowed_domainsで信頼できるドメインに限定する。 - 回答に付与される引用（出典）を必ずユーザーに提示し、根拠をたどれるようにする。
Web検索は、次に紹介する引用（Citations）機能や、複数リクエストをまとめて処理するMessage Batches、トークン数の事前確認と組み合わせると、実運用でのコストと品質の両立がしやすくなります。