--- title: Webフェッチツール url: https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool description: 特定のURLからコンテンツを取得して読み込み、ライブのWebコンテンツでClaudeのコンテキストを拡張します。 featureMetadata: status: stable zdr: eligibility: eligible note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements). 取得したWebコンテンツがAPIレスポンスで返されます。Webフェッチの動的フィルタリングは、ZDRまたはHIPAAの適格対象ではありません。Webサイトの運営者は、独自のポリシーに従ってリクエストデータ（取得されたURLやリクエストのメタデータなど）を保持する場合があります。 supportedModels: - claude-fable-5-1 - claude-mythos-5-1 - claude-fable-5 - claude-mythos-5 - claude-mythos-preview - claude-opus-5-5 - claude-opus-5 - claude-sonnet-5-5 - claude-sonnet-5 - claude-haiku-5-5 - claude-haiku-4-5-20251001 - claude-opus-4-8 - claude-opus-4-7 - claude-opus-4-6 - claude-sonnet-4-6 - claude-opus-4-5-20251101 - claude-sonnet-4-5-20250929 supportedPlatforms: Claude API: stable Claude Platform on AWS: stable Claude Models on Google Cloud (Anthropic managed): stable Microsoft Foundry: availability: stable note: Azure上でホストされるデプロイメントは`web_fetch_20250910`のみをサポートします。動的フィルタリング、レスポンスへの包含、キャッシュのバイパスは使用できません。 --- **APIサポート**：使用方法は製品によって異なります。 * **Messages API**：リクエストの`tools`に`web_fetch`ツールを追加します。 * **Managed Agents**：エージェントのツールセットでデフォルトで有効です。`max_uses`、`citations`、`cache_control`は使用できません。 Webフェッチツールを使用すると、Claudeは指定されたWebページやPDFドキュメントから完全なコンテンツを取得できます。 最新のWebフェッチツールバージョン（`web_fetch_20260318`）は **「dynamic filtering」（動的フィルタリング）** をサポートしています。Claudeはコードを記述・実行して、取得したコンテンツがコンテキストウィンドウに到達する前にフィルタリングし、関連する情報のみを保持して残りを破棄できます。これにより、応答の品質を維持しながらトークン消費を削減できます。動的フィルタリングは、Claude 4.6以降のモデルおよび[Claude Mythos Preview](https://anthropic.com/glasswing)で利用できます。`web_fetch_20260318`では、エージェント型ワークフロー向けの[レスポンスへの包含](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#response-inclusion)の制御も追加されています。その他のバージョン（動的フィルタリングと[キャッシュバイパス](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#cache-bypass)向けの`web_fetch_20260309`、動的フィルタリングのみの`web_fetch_20260209`、基本的なフェッチ向けの`web_fetch_20250910`）も利用できます。 Webフェッチ（動的フィルタリングの有無を問わず）は、Claude API、[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)、[Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed)、および[Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)で利用できます。Microsoft Foundryでは、[Azureでホストされている](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry#additional-features-not-supported-when-hosted-on-azure)デプロイメントは基本的なWebフェッチツール（`web_fetch_20250910`、動的フィルタリングなし）のみをサポートします。Anthropicでホストされているデプロイメントはすべてのバージョンをサポートします。 [Claude Mythos Preview](https://anthropic.com/glasswing)では、WebフェッチはClaude APIおよびMicrosoft Foundryで利用できます。 モデルの応答の品質、API自体、またはドキュメントの品質に関するフィードバックは、[フィードバックフォーム](https://forms.gle/NhWcgmkcvPCMmPE86)からお寄せください。 ゼロデータ保持の対象可否と`allowed_callers`による回避策については、[サーバーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools#zdr-and-allowed-callers)を参照してください。 Claudeが機密データとともに信頼できない入力を処理する環境でWebフェッチツールを有効にすると、データ流出のリスクが生じます。このツールは、信頼できる環境でのみ、または機密性のないデータを扱う場合にのみ使用してください。 流出リスクを最小限に抑えるため、Claudeは自身の出力にのみ現れるURLをフェッチできません。Claudeがフェッチできるのは、会話内で以前に現れたURL、つまりユーザーメッセージ内のURL、クライアント側ツールの結果内のURL、および以前のWeb検索またはWebフェッチの結果に含まれるURLのみです（[URL検証](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#url-validation)を参照）。また、APIキーやパスワードなどの認証情報を含んでいると思われるURLは、その認証情報がシステムプロンプトまたはユーザーメッセージのテキスト内に現れていない限り、Claudeはフェッチできません。 ただし、このツールを使用する際には慎重に検討すべき残存リスクが依然として存在します。 データ流出が懸念される場合は、次の対策を検討してください。 * Webフェッチツールを完全に無効にする * [`max_uses`](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#max-uses)パラメータを使用して1ターン内のフェッチ数を制限する * `allowed_domains`パラメータを使用して既知の安全なドメインに制限する * `url_sources`パラメータを使用して、クライアント側ツールの結果がソースとして扱われないようにする（[URLソース](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#url-sources)を参照） モデルのサポートについては、[ツールリファレンス](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-reference)を参照してください。 ## Webフェッチの仕組み Webフェッチは[サーバーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools)です。APIがリクエスト中にコンテンツを取得し、その結果を会話に挿入します。ユーザー側で何かを実行したり`tool_result`を返したりする必要はありません。例外は、Claudeが同じ並列ツール呼び出しのグループ内でWebフェッチとクライアントツールのいずれかを呼び出す場合です。この場合、APIはそのフェッチが実行される前に`stop_reason: "tool_use"`を含むレスポンスを返し、クライアントの`tool_result`ブロックを送り返した時点でフェッチを実行します。[1つのターンでサーバーツールとクライアントツールを混在させる](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools#mixing-server-tools-and-client-tools-in-one-turn)を参照してください。 APIリクエストにWebフェッチツールを追加すると、次のように動作します。 1. Claudeは、プロンプトと利用可能なURLに基づいて、いつコンテンツをフェッチするかを判断します。 2. APIは、指定されたURLから完全なテキストコンテンツを取得します。 3. PDFの場合、APIはコンテンツをbase64エンコードされたデータとして返し、直接添付されたPDFドキュメントと同様に処理します。 4. Claudeは取得したコンテンツを分析し、必要に応じて引用を含む応答を提供します。 Webフェッチツールは現在、JavaScriptで動的にレンダリングされるWebサイトをサポートしていません。実際のブラウザが必要なページ（JavaScriptのレンダリング、クリック、フォームへの入力）については、[ブラウザ使用ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/browser-use-tool)の利用を検討してください。これは、アプリケーションがブラウザを操作し、ページのテキストやスクリーンショットをツール結果としてClaudeに返すクライアントツールです。 ### Claudeがフェッチするタイミング Claudeは、リクエストが特定のページやドキュメントを指している場合にフェッチします。 * 会話内（または以前のツール結果内）でURLが提供されている場合 * ユーザーがURLなしで特定のリソース（特定の記事、README、料金ページ、ドキュメントのセクションなど）を指定し、かつClaudeが最初にそれを見つけられるよう[Web検索ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool)も有効になっている場合（[検索とフェッチの組み合わせ](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#combined-search-and-fetch)を参照） 特定のページを参照しない一般的な知識に関する質問や自由回答形式の質問に対しては、Claudeはフェッチ**しません**。「この記事を要約してください: ``」はフェッチをトリガーします。「REST API設計のベストプラクティスは何ですか？」には直接回答します。 ### 動的フィルタリング Webページ全体やPDFをフェッチすると、特に大きなドキュメントから特定の情報のみが必要な場合、トークンがすぐに消費されてしまいます。`web_fetch_20260209`以降では、Claudeはコードを記述・実行して、取得したコンテンツをコンテキストに読み込む前にフィルタリングできます。 この動的フィルタリングは、特に次の用途に役立ちます。 * 長いドキュメントから特定のセクションを抽出する * Webページから構造化データを処理する * PDFから関連する情報をフィルタリングする * 大きなドキュメントを扱う際のトークンコストを削減する 動的フィルタリングは[コード実行ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)上で実行され、APIはリクエストに対してこれを自動的に有効にします。`tools`配列にコード実行ツールを追加する必要はありません。 動的フィルタリングを有効にするには、`web_fetch_20260209`またはそれ以降のバージョンを使用します。次の例では`web_fetch_20260318`を使用しています。 ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2026-10-21" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Fetch the content at https://example.com/research-paper and extract the key findings." } ], "tools": [{ "type": "web_fetch_20260318", "name": "web_fetch" }] }' ``` ```bash CLI ant messages create \ --model claude-opus-5-5 \ --max-tokens 4096 \ --message '{role: user, content: "Fetch the content at https://example.com/research-paper and extract the key findings."}' \ --tool '{type: web_fetch_20260318, name: web_fetch}' ``` ```python Python client = anthropic.Anthropic() response = client.messages.create( model="claude-opus-5-5", max_tokens=4096, messages=[ { "role": "user", "content": "Fetch the content at https://example.com/research-paper and extract the key findings.", } ], tools=[{"type": "web_fetch_20260318", "name": "web_fetch"}], ) print(response) ``` ```typescript TypeScript const client = new Anthropic(); const response = await client.messages.create({ model: "claude-opus-5-5", max_tokens: 4096, messages: [ { role: "user", content: "Fetch the content at https://example.com/research-paper and extract the key findings." } ], tools: [{ type: "web_fetch_20260318", name: "web_fetch" }] }); console.log(response); ``` ```csharp C# AnthropicClient client = new(); var parameters = new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = [new UserMessageParam { Content = "Fetch the content at https://example.com/research-paper and extract the key findings." }], Tools = [new ToolUnion(new WebFetchTool20260318())] }; var message = await client.Messages.Create(parameters); Console.WriteLine(message); ``` ```go Go client := anthropic.NewClient() response, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: []anthropic.MessageParam{ anthropic.NewUserMessage(anthropic.NewTextBlock("Fetch the content at https://example.com/research-paper and extract the key findings.")), }, Tools: []anthropic.ToolUnionParam{ {OfWebFetchTool20260318: &anthropic.WebFetchTool20260318Param{}}, }, }) if err != nil { log.Fatal(err) } fmt.Println(response.RawJSON()) ``` ```java Java import com.anthropic.models.messages.WebFetchTool20260318; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addUserMessage("Fetch the content at https://example.com/research-paper and extract the key findings.") .addTool(WebFetchTool20260318.builder().build()) .build(); Message response = client.messages().create(params); IO.println(response); } ``` ```php PHP $client = new Client(); $message = $client->messages->create( maxTokens: 4096, messages: [ ['role' => 'user', 'content' => 'Fetch the content at https://example.com/research-paper and extract the key findings.'] ], model: Model::CLAUDE_OPUS_5_5, tools: [[ 'type' => 'web_fetch_20260318', 'name' => 'web_fetch', ]], ); echo $message; ``` ```ruby Ruby client = Anthropic::Client.new message = client.messages.create( model: Anthropic::Model::CLAUDE_OPUS_5_5, max_tokens: 4096, messages: [ { role: "user", content: "Fetch the content at https://example.com/research-paper and extract the key findings." } ], tools: [{ type: "web_fetch_20260318", name: "web_fetch" }] ) puts message ``` ## Webフェッチの使用方法 組織の管理者は、Claude Consoleの[**機能**](https://platform.claude.com/settings/capabilities)ページで組織のWebフェッチをオフにできます。Webフェッチがオフの場合、このツールを含むMessages APIリクエストは、Webフェッチが有効になっていないことを示す400 `invalid_request_error`で失敗します。Webフェッチがオンの場合、管理者は同じページでWebフェッチの許可ドメインまたはブロックドメインを設定することもできます。これらのリストがリクエストにどのように適用されるかについては、[ドメインフィルタリング](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools#domain-filtering)を参照してください。 組織のWebフェッチ設定がClaude Managed Agentsのセッションにどのように適用されるかについては、[Web検索とWebフェッチのドメインを制限する](https://platform.claude.com/docs/ja/managed-agents/tools-web-restrictions)を参照してください。 APIリクエストでWebフェッチツールを指定します。 ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2026-10-21" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Please analyze the content at https://example.com/article" } ], "tools": [{ "type": "web_fetch_20250910", "name": "web_fetch", "max_uses": 5 }] }' ``` ```bash CLI ant messages create \ --model claude-opus-5-5 \ --max-tokens 4096 \ --message '{role: user, content: "Please analyze the content at https://example.com/article"}' \ --tool '{type: web_fetch_20250910, name: web_fetch, max_uses: 5}' ``` ```python Python client = anthropic.Anthropic() response = client.messages.create( model="claude-opus-5-5", max_tokens=4096, messages=[ { "role": "user", "content": "Please analyze the content at https://example.com/article", } ], tools=[{"type": "web_fetch_20250910", "name": "web_fetch", "max_uses": 5}], ) print(response) ``` ```typescript TypeScript const client = new Anthropic(); const response = await client.messages.create({ model: "claude-opus-5-5", max_tokens: 4096, messages: [ { role: "user", content: "Please analyze the content at https://example.com/article" } ], tools: [ { type: "web_fetch_20250910", name: "web_fetch", max_uses: 5 } ] }); console.log(response); ``` ```csharp C# AnthropicClient client = new(); var parameters = new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = [new UserMessageParam { Content = "Please analyze the content at https://example.com/article" }], Tools = [new ToolUnion(new WebFetchTool20250910() { MaxUses = 5 })] }; var message = await client.Messages.Create(parameters); Console.WriteLine(message); ``` ```go Go client := anthropic.NewClient() response, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: []anthropic.MessageParam{ anthropic.NewUserMessage(anthropic.NewTextBlock("Please analyze the content at https://example.com/article")), }, Tools: []anthropic.ToolUnionParam{ {OfWebFetchTool20250910: &anthropic.WebFetchTool20250910Param{ MaxUses: anthropic.Int(5), }}, }, }) if err != nil { log.Fatal(err) } fmt.Println(response.RawJSON()) ``` ```java Java import com.anthropic.models.messages.WebFetchTool20250910; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addUserMessage("Please analyze the content at https://example.com/article") .addTool(WebFetchTool20250910.builder() .maxUses(5L) .build()) .build(); Message response = client.messages().create(params); IO.println(response); } ``` ```php PHP $client = new Client(); $message = $client->messages->create( maxTokens: 4096, messages: [ ['role' => 'user', 'content' => 'Please analyze the content at https://example.com/article'] ], model: Model::CLAUDE_OPUS_5_5, tools: [[ 'type' => 'web_fetch_20250910', 'name' => 'web_fetch', 'max_uses' => 5, ]], ); echo $message; ``` ```ruby Ruby client = Anthropic::Client.new message = client.messages.create( model: Anthropic::Model::CLAUDE_OPUS_5_5, max_tokens: 4096, messages: [ { role: "user", content: "Please analyze the content at https://example.com/article" } ], tools: [{ type: "web_fetch_20250910", name: "web_fetch", max_uses: 5 }] ) puts message ``` ## ツール定義 Webフェッチツールは次のパラメータをサポートしています。 ```json JSON { "type": "web_fetch_20250910", "name": "web_fetch", // Optional: Limit the number of fetches "max_uses": 10, // Optional: Only fetch from these domains "allowed_domains": ["example.com", "docs.example.com"], // Optional: Never fetch from these domains (cannot be combined with allowed_domains) "blocked_domains": ["private.example.com"], // Optional: Don't fetch URLs that appear only in client-side tool results "url_sources": { "client_tool_results": { "type": "none" } }, // Optional: Enable citations for fetched content "citations": { "enabled": true }, // Optional: Maximum content length in tokens "max_content_tokens": 100000 } ``` それ以降のツールバージョンでは、さらに2つのオプションパラメータが追加されています。`use_cache`には`web_fetch_20260309`以降が必要であり（[キャッシュバイパス](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#cache-bypass)を参照）、`response_inclusion`には`web_fetch_20260318`以降が必要です（[レスポンスへの包含](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#response-inclusion)を参照）。 ### 最大使用回数 `max_uses`パラメータは、1つのターン内で実行されるWebフェッチの回数を制限します。失敗したフェッチも制限回数にカウントされます。Claudeが許可された回数を超えてWebフェッチを直接呼び出した場合、`web_fetch_tool_result`は`max_uses_exceeded`エラーコードを持つエラーになります。Claudeが許可された回数を超えてコード実行からWebフェッチを呼び出した場合、そのコード実行はエラーで終了します。デフォルトの制限はありません。 1つのターンは複数のリクエストにまたがる場合があります。リクエストが[`pause_turn`](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools#the-server-side-loop-and-pause-turn)の後に再開される場合、または最後のメッセージに`tool_result`ブロックのみが含まれる場合、そのリクエストはターンを継続します。そのターン内の以前のリクエストで行われたフェッチも制限回数にカウントされます。ただし、Claudeが[動的フィルタリング](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#dynamic-filtering)を通じてコード実行からそれらを実行した場合は除きます。 ### ドメインフィルタリング `allowed_domains`および`blocked_domains`によるドメインフィルタリングについては、[サーバーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools#domain-filtering)を参照してください。 [Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)では、エージェントのツールセットの`web_fetch`エントリでこれらのフィールドを設定します。[Web検索とWebフェッチのドメインを制限する](https://platform.claude.com/docs/ja/managed-agents/tools-web-restrictions)を参照してください。 ### コンテンツの制限 `max_content_tokens`パラメータは、コンテキストに含まれるコンテンツの量を制限します。取得したコンテンツがこの制限を超えた場合、ツールはコンテンツを切り詰めます。これにより、大きなドキュメントをフェッチする際のトークン使用量を制御できます。この制限は概算であり、実際に使用される入力トークン数は、わずかに変動する場合があります。この制限はテキストコンテンツに適用され、PDFなどのバイナリコンテンツには適用されません。 取得したPDFによってリクエストが[PDFのページ数またはサイズの制限](https://platform.claude.com/docs/ja/build-with-claude/pdf-support#check-pdf-requirements)を超える場合、`web_fetch_tool_result`は`content_too_large`エラーコードを持つエラーになります。会話内にすでに存在するPDFや画像もこれらの制限にカウントされるため、それらを削除するとフェッチが成功する場合があります。 Claude Managed Agentsでは、エージェントのツールセットの`web_fetch`エントリでも`max_content_tokens`を指定できます。[Webツールの設定](https://platform.claude.com/docs/ja/managed-agents/tools-web-restrictions#settings)を参照してください。 ### キャッシュバイパス `web_fetch_20260309`以降（`web_fetch_20260318`を含む）が必要です。 `use_cache`パラメータは、キャッシュされたコンテンツを返してもよいかどうかを制御します。キャッシュをバイパスして最新のコンテンツをフェッチするには、`"use_cache": false`を設定します。デフォルトは`true`です。キャッシュをバイパスするとレイテンシが増加するため、ユーザーが明示的に最新のコンテンツを要求した場合や、頻繁に変化するソースをフェッチする場合にのみキャッシュを無効にしてください。 ```json { "tools": [ { "type": "web_fetch_20260309", "name": "web_fetch", "use_cache": false } ] } ``` ### レスポンスへの包含 `web_fetch_20260318`以降が必要です。 `response_inclusion`パラメータは、フェッチ結果が同じレスポンス内で完了した[コード実行](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)呼び出しによって消費された場合に、フェッチ結果ブロックがAPIレスポンスにどのように表示されるかを制御します。`"response_inclusion": "excluded"`を設定すると、生のページコンテンツを必要としないエージェント型ワークフロー向けに、ネストされた`server_tool_use`ブロックと結果ブロックのペアがレスポンスから完全に除外されます。Claudeはこれらのブロックではなくコードの出力を読み取るため、トークン使用量には影響しません。デフォルトは`"full"`です。APIは、直接呼び出しの結果、または完了前に一時停止したコード実行呼び出しの結果を、次のリクエストで送り返せるよう常に完全な形で返します。 ```json { "tools": [ { "type": "web_fetch_20260318", "name": "web_fetch", "response_inclusion": "excluded" } ] } ``` ### 引用 引用が常に有効になっているWeb検索とは異なり、Webフェッチでは引用はオプションであり、デフォルトでは無効になっています。Claudeが取得したドキュメントの特定の箇所を引用できるようにするには、`"citations": {"enabled": true}`を設定します。 APIの出力をエンドユーザーに直接表示する場合は、元のソースへの引用を含めてください。APIの出力に変更を加える場合（エンドユーザーに表示する前に再処理したり、独自の素材と組み合わせたりする場合を含む）は、法務チームと相談の上、適切に引用を表示してください。 ## レスポンス レスポンス構造の例を次に示します。 ```json Output { "role": "assistant", "content": [ // 1. Claude's decision to fetch { "type": "text", "text": "I'll fetch the content from the article to analyze it." }, // 2. The fetch request { "type": "server_tool_use", "id": "srvtoolu_01234567890abcdef", "name": "web_fetch", "input": { "url": "https://example.com/article" } }, // 3. Fetch results { "type": "web_fetch_tool_result", "tool_use_id": "srvtoolu_01234567890abcdef", "content": { "type": "web_fetch_result", "url": "https://example.com/article", "content": { "type": "document", "source": { "type": "text", "media_type": "text/plain", "data": "Full text content of the article..." }, "title": "Article Title", "citations": { "enabled": true } }, "retrieved_at": "2025-08-25T10:30:00Z" } }, // 4. Claude's analysis with citations (if enabled) { "text": "Based on the article, ", "type": "text" }, { "text": "the main argument presented is that artificial intelligence will transform healthcare", "type": "text", "citations": [ { "type": "char_location", "document_index": 0, "document_title": "Article Title", "start_char_index": 1234, "end_char_index": 1456, "cited_text": "Artificial intelligence is poised to revolutionize healthcare delivery..." } ] } ], "id": "msg_a930390d3a", "usage": { "input_tokens": 25039, "output_tokens": 931, "server_tool_use": { "web_fetch_requests": 1 } }, "stop_reason": "end_turn" } ``` ### フェッチ結果 フェッチ結果には次のものが含まれます。 * `url`: フェッチされたURL * `content`: 取得したコンテンツを含むドキュメントブロック * `retrieved_at`: コンテンツが取得された時点のタイムスタンプ Webフェッチツールは、パフォーマンスを向上させ冗長なリクエストを減らすために結果をキャッシュします。返されるコンテンツは、必ずしもそのURLで利用可能な最新バージョンを反映しているとは限りません。キャッシュの動作は自動的に管理されており、さまざまなコンテンツタイプや使用パターンに合わせて最適化するために、時間とともに変更される場合があります。最新のコンテンツをフェッチするには、`"use_cache": false`を設定してください（[キャッシュバイパス](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#cache-bypass)を参照）。 PDFドキュメントの場合、コンテンツはbase64エンコードされたデータとして返されます。 ```json Output { "type": "web_fetch_tool_result", "tool_use_id": "srvtoolu_02", "content": { "type": "web_fetch_result", "url": "https://example.com/paper.pdf", "content": { "type": "document", "source": { "type": "base64", "media_type": "application/pdf", "data": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmo..." }, "citations": { "enabled": true } }, "retrieved_at": "2025-08-25T10:30:02Z" } } ``` ### エラー Webフェッチツールでエラーが発生した場合、Claude APIは200（成功）レスポンスを返し、エラーはレスポンス本文内で表現されます。Claudeはエラー結果を受け取り、ターンを続行します。例： ```json Output { "type": "web_fetch_tool_result", "tool_use_id": "srvtoolu_a93jad", "content": { "type": "web_fetch_tool_result_error", "error_code": "url_not_accessible" } } ``` 考えられるエラーコードは次のとおりです。 * `invalid_tool_input`: 不正な形式のURLやHTTP(S)以外のスキームなど、無効なツール入力 * `url_too_long`: URLが最大長（250文字）を超えている * `url_not_allowed`: ドメインフィルタリングルール（組織の設定を含む）、またはプライベートアドレス、`robots.txt`、提供されていない認証情報を含んでいると思われるURLなどのAnthropic側の制限によってURLがブロックされた * `url_not_in_prior_context`: URLが会話内で以前に現れていない、または`url_sources`が除外しているソースにのみ現れた（[URL検証](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#url-validation)を参照） * `url_not_accessible`: コンテンツのフェッチに失敗した（HTTPエラー） * `too_many_requests`: レート制限を超えた * `unsupported_content_type`: サポートされていないコンテンツタイプ（テキスト、HTML、PDFのみサポート） * `content_too_large`: 取得したPDFによってリクエストがPDFのページ数またはサイズの制限を超える（[コンテンツの制限](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool#content-limits)を参照） * `max_uses_exceeded`: Webフェッチツールの最大使用回数を超えた * `unavailable`: 内部エラーが発生した ## URL検証 セキュリティ上の理由から、Webフェッチツールは会話コンテキスト内で以前に現れたURLのみをフェッチできます。これには次のものが含まれます。 * ユーザーメッセージ内のURL * クライアント側ツールの結果内のURL * 以前のWeb検索またはWebフェッチの結果に含まれるURL このツールは、Claude自身の出力にのみ現れるURLや、システムプロンプトにのみ現れるURLをフェッチできません。システムプロンプト内のURLをフェッチ可能にするには、そのURLをユーザーメッセージにも含めてください。[コード実行](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)、[MCPコネクタ](https://platform.claude.com/docs/ja/agents-and-tools/mcp-connector)、[ツール検索](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool)などの他のサーバー側ツールの結果も、許可されたソースではありません。デフォルトでは、クライアント側ツールの結果は、Claudeが生成したテキストをそのまま返す場合（たとえば、入力を出力するコマンドや、入力を引用するエラーメッセージなど）でも、許可されたソースとして扱われます。 また、このツールは、APIキーやパスワードなどの認証情報を含んでいると思われるURLを、その認証情報がシステムプロンプトまたはユーザーメッセージのテキスト内に現れていない限り拒否します。ツール結果内にのみ現れる認証情報はカウントされません。結果は`url_not_allowed`エラーになります。このようなURLをフェッチするには、そのURLをユーザーメッセージに含めてください。 ### URLソース `web_fetch_20250910`、`web_fetch_20260209`、`web_fetch_20260309`、および`web_fetch_20260318`で動作します。 オプションの`url_sources`パラメータを使用すると、3つの許可されたソースのいずれかをオフにしたり、ツール結果を特定のツールに限定したりできます。このパラメータにはソースごとに1つのキーがあり、すべてのキーのデフォルトは`{"type": "all"}`です。 * `user_input`: ユーザーメッセージ内のURL。その`type`は`"all"`または`"none"`です。 * `client_tool_results`: クライアント側ツールの結果内のURL。その`type`は`"all"`、`"none"`、または次の例のようにツールを指定する`"only"`もしくは`"except"`フィルターです。 * `server_tool_results`: 以前のWeb検索またはWebフェッチの結果に含まれるURL。同じ値を取り、そのフィルターでは`web_search`または`web_fetch`を指定します。 たとえば、Claudeが記述したコードを実行するツールは、そのコードが出力するものを何でも返し、Claudeがコードに含めたURLも含まれます。そのツールの結果がソースとして扱われないようにするには、`"except"`フィルターでそのツールを指定します。 ```json { "tools": [ { "type": "web_fetch_20260318", "name": "web_fetch", "url_sources": { "client_tool_results": { "type": "except", "tools": [{ "type": "tool_reference", "name": "run_code" }] } } }, { "name": "run_code", "description": "Run Python code and return its output", "input_schema": { "type": "object", "properties": { "code": { "type": "string" } }, "required": ["code"] } } ] } ``` フィルターはツールを`tool_reference`オブジェクトとして列挙します。各名前は、リクエストの`tools`配列内のツールと一致する必要があります。`client_tool_results`の場合はクライアントツール、`server_tool_results`の場合はサーバーツールです。一致しない場合、リクエストはエラーで失敗します。`"except"`の下では、後から`tools`に追加したツールはソースとして扱われます。`"only"`の下では扱われません。 `run_code`以外のクライアント側ツールも、Claudeが記述したテキストを返すことがあります（たとえば、それを引用するエラーメッセージなど）。すべてのクライアント側ツールの結果を除外するには、`client_tool_results`を`{"type": "none"}`に設定します。 URLが`url_sources`が除外しているソースにのみ現れた場合、そのURLをフェッチすると`url_not_in_prior_context`エラーが返されます。 ## 検索とフェッチの組み合わせ Web検索ツールとWebフェッチツールの両方が有効になっていて、ユーザーがURLを提供せずに特定のページやドキュメントを指定した場合（たとえば、「anthropics/anthropic-sdk-pythonリポジトリのREADMEを読んでください」）、ClaudeはWeb検索を使用してそれを見つけ、その結果をフェッチします。次の例では、1つのリクエストで検索と分析を依頼しています。 ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2026-10-21" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Find recent articles about quantum computing and analyze the most relevant one in detail" } ], "tools": [ { "type": "web_search_20250305", "name": "web_search", "max_uses": 3 }, { "type": "web_fetch_20250910", "name": "web_fetch", "max_uses": 5, "citations": {"enabled": true} } ] }' ``` ```bash CLI ant messages create <<'YAML' model: claude-opus-5-5 max_tokens: 4096 messages: - role: user content: >- Find recent articles about quantum computing and analyze the most relevant one in detail tools: - type: web_search_20250305 name: web_search max_uses: 3 - type: web_fetch_20250910 name: web_fetch max_uses: 5 citations: enabled: true YAML ``` ```python Python client = anthropic.Anthropic() response = client.messages.create( model="claude-opus-5-5", max_tokens=4096, messages=[ { "role": "user", "content": "Find recent articles about quantum computing and analyze the most relevant one in detail", } ], tools=[ {"type": "web_search_20250305", "name": "web_search", "max_uses": 3}, { "type": "web_fetch_20250910", "name": "web_fetch", "max_uses": 5, "citations": {"enabled": True}, }, ], ) print(response) ``` ```typescript TypeScript const client = new Anthropic(); const response = await client.messages.create({ model: "claude-opus-5-5", max_tokens: 4096, messages: [ { role: "user", content: "Find recent articles about quantum computing and analyze the most relevant one in detail" } ], tools: [ { type: "web_search_20250305", name: "web_search", max_uses: 3 }, { type: "web_fetch_20250910", name: "web_fetch", max_uses: 5, citations: { enabled: true } } ] }); console.log(response); ``` ```csharp C# AnthropicClient client = new(); var parameters = new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = [new UserMessageParam { Content = "Find recent articles about quantum computing and analyze the most relevant one in detail" }], Tools = [ new ToolUnion(new WebSearchTool20250305() { MaxUses = 3 }), new ToolUnion(new WebFetchTool20250910() { MaxUses = 5, Citations = new() { Enabled = true } }) ] }; var message = await client.Messages.Create(parameters); Console.WriteLine(message); ``` ```go Go client := anthropic.NewClient() response, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: []anthropic.MessageParam{ anthropic.NewUserMessage(anthropic.NewTextBlock("Find recent articles about quantum computing and analyze the most relevant one in detail")), }, Tools: []anthropic.ToolUnionParam{ {OfWebSearchTool20250305: &anthropic.WebSearchTool20250305Param{ MaxUses: anthropic.Int(3), }}, {OfWebFetchTool20250910: &anthropic.WebFetchTool20250910Param{ MaxUses: anthropic.Int(5), Citations: anthropic.CitationsConfigParam{Enabled: anthropic.Bool(true)}, }}, }, }) if err != nil { log.Fatal(err) } fmt.Println(response.RawJSON()) ``` ```java Java import com.anthropic.models.messages.CitationsConfigParam; // ... import com.anthropic.models.messages.WebFetchTool20250910; import com.anthropic.models.messages.WebSearchTool20250305; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addUserMessage("Find recent articles about quantum computing and analyze the most relevant one in detail") .addTool(WebSearchTool20250305.builder() .maxUses(3L) .build()) .addTool(WebFetchTool20250910.builder() .maxUses(5L) .citations(CitationsConfigParam.builder() .enabled(true) .build()) .build()) .build(); Message response = client.messages().create(params); IO.println(response); } ``` ```php PHP $client = new Client(); $message = $client->messages->create( maxTokens: 4096, messages: [ ['role' => 'user', 'content' => 'Find recent articles about quantum computing and analyze the most relevant one in detail'] ], model: Model::CLAUDE_OPUS_5_5, tools: [ [ 'type' => 'web_search_20250305', 'name' => 'web_search', 'max_uses' => 3, ], [ 'type' => 'web_fetch_20250910', 'name' => 'web_fetch', 'max_uses' => 5, 'citations' => ['enabled' => true], ], ], ); echo $message; ``` ```ruby Ruby client = Anthropic::Client.new message = client.messages.create( model: Anthropic::Model::CLAUDE_OPUS_5_5, max_tokens: 4096, messages: [ { role: "user", content: "Find recent articles about quantum computing and analyze the most relevant one in detail" } ], tools: [ { type: "web_search_20250305", name: "web_search", max_uses: 3 }, { type: "web_fetch_20250910", name: "web_fetch", max_uses: 5, citations: { enabled: true } } ] ) puts message ``` このワークフローでは、Claudeは次のことを行います。 1. Web検索を使用して関連する記事を見つけます。 2. 最も有望な結果を選択します。 3. Webフェッチを使用して完全なコンテンツを取得します。 4. 引用付きの詳細な分析を提供します。 ## プロンプトキャッシング ターンをまたいでツール定義をキャッシュするには、[プロンプトキャッシングを使用したツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-use-with-prompt-caching)を参照してください。 ## ストリーミング ストリーミングを有効にすると、フェッチイベントはストリームの一部となり、コンテンツの取得中は一時停止します。 ```sse Output event: message_start data: {"type": "message_start", "message": {"id": "msg_abc123", "type": "message"}} event: content_block_start data: {"type": "content_block_start", "index": 0, "content_block": {"type": "text", "text": ""}} // Claude's decision to fetch event: content_block_start data: {"type": "content_block_start", "index": 1, "content_block": {"type": "server_tool_use", "id": "srvtoolu_xyz789", "name": "web_fetch"}} // Fetch URL streamed event: content_block_delta data: {"type": "content_block_delta", "index": 1, "delta": {"type": "input_json_delta", "partial_json": "{\"url\":\"https://example.com/article\"}"}} // Pause while fetch runs // Fetch results streamed event: content_block_start data: {"type": "content_block_start", "index": 2, "content_block": {"type": "web_fetch_tool_result", "tool_use_id": "srvtoolu_xyz789", "content": {"type": "web_fetch_result", "url": "https://example.com/article", "content": {"type": "document", "source": {"type": "text", "media_type": "text/plain", "data": "Article content..."}}}}} // Claude's response continues... ``` ## バッチリクエスト Webフェッチツールは[Message Batches API](https://platform.claude.com/docs/ja/build-with-claude/batch-processing)に含めることができます。Message Batches APIを介したWebフェッチツールの呼び出しは、通常のMessages APIリクエストでの呼び出しと同じ料金です。 ## 使用量と料金 Web fetch（ウェブフェッチ）の使用には、標準のトークンコスト以外に**追加料金はかかりません**： ```json { "usage": { "input_tokens": 25039, "output_tokens": 931, "cache_read_input_tokens": 0, "cache_creation_input_tokens": 0, "server_tool_use": { "web_fetch_requests": 1 } } } ``` Webフェッチツールは、Claude APIで**追加コストなし**で利用できます。会話コンテキストの一部となる取得済みコンテンツに対して、標準のトークンコストのみをお支払いいただきます。 過剰なトークンを消費する大きなコンテンツを誤って取得してしまうことを防ぐため、`max_content_tokens`パラメータを使用して、ユースケースと予算の考慮事項に基づいた適切な制限を設定してください。 一般的なコンテンツにおけるトークン使用量の例： * 平均的なウェブページ（10 kB）：約2,500トークン * 大規模なドキュメントページ（100 kB）：約25,000トークン * 研究論文のPDF（500 kB）：約125,000トークン ## 次のステップ サンドボックス化されたコンテナでPythonおよびBashコードを実行し、データの分析、ファイルの生成、ソリューションの反復改善を行います。 Anthropicが実行するツールを扱います：`server_tool_use`ブロック、`pause_turn`による継続、ドメインフィルタリング。 Anthropicが提供するツールのディレクトリと、オプションのツール定義プロパティのリファレンスです。 ## 利用可能状況 Webフェッチツールはすべてのモデルで利用可能であり、ゼロデータ保持の対象です。 ### APIサポート #### [Messages API](https://platform.claude.com/docs/ja/build-with-claude/working-with-messages) * 利用可能状況：利用可能 * 使用方法：リクエストの`tools`に`web_fetch`ツールを追加します。`max_uses`、ドメインリスト、`citations`、`max_content_tokens`などの設定はそのツールに指定します。 | ステータス | クラウドプラットフォーム | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 利用可能 | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry) | | 利用可能1 | [Microsoft Foundry (hosted on Azure)](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry) | 1. Azure上でホストされるデプロイメントは`web_fetch_20250910`のみをサポートします。動的フィルタリング、レスポンスへの包含、キャッシュのバイパスは使用できません。 #### [Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview) * 利用可能状況：利用可能 * 使用方法：エージェントのツールセットの一部で、ツールセットを追加するとデフォルトで有効になります。ドメインリスト（パスなし）と`max_content_tokens`はツールセットの`web_fetch`エントリに指定します。`max_uses`、`citations`、`cache_control`は使用できません。 | ステータス | クラウドプラットフォーム | | ----- | ------------------------------------------------------------------------------------------------------------------ | | 利用可能 | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws) | ### データの取り扱い [データの取り扱いの概要](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention#feature-eligibility) | 項目 | ゼロデータ保持 | HIPAA | | ----- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----- | | ステータス | 対象（[対象モデル](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)を除く） | 対象外 | | 詳細 | 取得したWebコンテンツがAPIレスポンスで返されます。Webフェッチの動的フィルタリングは、ZDRまたはHIPAAの適格対象ではありません。Webサイトの運営者は、独自のポリシーに従ってリクエストデータ（取得されたURLやリクエストのメタデータなど）を保持する場合があります。 | — | 対象エンドポイント： * `/v1/messages` `web_fetch`ツールを使用する場合