Web fetch ツール

サーバーツールとして動作し、API がリクエストの処理中に内容を取得して結果を会話に挿入します。呼び出し側でツールを実行したり tool_result を返したりする必要はありません。特定のページや文書の内容を踏まえて Claude に回答させる場面に関わる機能です。

• Claude は、特定のページを指していない一般知識の質問や自由回答形式の質問では取得を行いません。
• web search と web fetch の両方を有効にしていて、ユーザーが URL を示さずに特定のページや文書を名指しした場合、Claude は web search でそのページを探してから取得します。
• JavaScript で動的に描画される Web サイトには、現時点では対応していません。
• 取得結果はキャッシュされるため、返される内容が URL の最新版を反映していない場合があります。
• ツールでエラーが起きた場合、API はエラーをレスポンス本文に含めた 200 (成功) レスポンスを返し、Claude はエラー結果を受け取ってそのターンを続けます。
• ストリーミングを有効にすると、取得のイベントはストリームの一部として流れ、内容の取得中は一時停止が入ります。
• Message Batches API のリクエストにも web fetch ツールを含められます。

• max_uses:1 ターン内の取得回数の上限です。失敗した取得も回数に含まれます。
• max_content_tokens:コンテキストに含める内容の量の上限です。取得した内容がこれを超えると切り詰められます。上限はテキストの内容に適用され、PDF などのバイナリの内容には適用されません。
• blocked_domains:取得しないドメインを指定する任意の項目です。allowed_domains とは組み合わせられません。
• use_cache:"use_cache": false にすると、キャッシュを使わずに新しい内容を取得します。既定値は true で、web_fetch_20260309 以降のバージョンが必要です。
• citations:引用は任意で、既定では無効です。"citations": {"enabled": true} にすると、Claude が取得した文書の特定の箇所を引用できます。
• response_inclusion:"response_inclusion": "excluded" にすると、完了したコード実行の呼び出しが消費した入れ子の server_tool_use と結果ブロックの組を、レスポンスから除外します。生のページ内容を必要としないエージェント型ワークフロー向けの設定です。
• dynamic filtering:ツールの type に web_fetch_20260209 以降のバージョンを使うと有効になります。code execution tool 上で動き、API がリクエストに対して自動で有効にするため、code execution tool を tools 配列に追加する必要はありません。

セキュリティ上の理由から、web fetch ツールは会話のコンテキストに既に現れた URL だけを取得できます。

• Claude 自身の出力だけ、またはシステムプロンプトだけに現れる URL は取得できません。システムプロンプトにある URL を取得対象にするには、ユーザーメッセージにもその URL を含めます。
• API キーやパスワードなどの認証情報を含むように見える URL は、その認証情報がシステムプロンプトかユーザーメッセージの本文に現れていない限り、取得を拒否します。
• 任意の url_sources で、許可される 3 種類の URL の出どころのいずれかをオフにしたり、ツール結果を特定のツールに限ったりできます。クライアント側のツール結果をすべて除外するには、client_tool_results を {"type": "none"} に設定します。

• 組織の管理者は Claude Console の Capabilities (機能) ページで、組織の web fetch をオフにできます。オフのとき、web fetch ツールを含む Messages API リクエストは、web fetch が有効でないことを示す 400 invalid_request_error で失敗します。
• web fetch がオンのときは、同じページで web fetch の許可ドメインまたはブロックドメインを設定できます。
• Claude Managed Agents では、web_fetch ツールは Capabilities ページで設定した組織の web fetch ドメイン制限に従います。
• Claude Managed Agents でネットワークが制限されたクラウド環境では、その環境の allowed_hosts が web_fetch ツールにも適用されます。allowed_hosts に一致しないホストの URL への呼び出しは、エージェントに url_not_allowed エラー結果を返します。
• Claude Managed Agents では、web_fetch ツールはセッション内に既に現れた URL だけを取得します。条件を満たさない URL への呼び出しは、エージェントに url_not_in_prior_context エラー結果を返します。
• 対象プランや提供地域は、公式のリリースノートには記載がありません。

組織の管理者が Claude Console の Capabilities (機能) ページで web fetch をオフにしている場合、web fetch ツールを含む Messages API リクエストは 400 エラーで失敗します。

1. Messages API のリクエストで、tools に web_fetch ツールを追加します。