---
title: ウェブ検索ツール
url: https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool
description: 引用元付きの最新のウェブコンテンツ、オプションの動的フィルタリング、ドメイン制御へのアクセスをClaudeに提供します。
---
「zero data retention」（ゼロデータ保持）、すなわちZDRがこの機能にどのように適用されるかについては、[APIとデータ保持](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention)を参照してください。
ウェブ検索ツールは、Claudeにリアルタイムのウェブコンテンツへの直接アクセスを提供し、知識のカットオフを超えた最新情報で質問に回答できるようにします。レスポンスには、検索結果から得られたソースの引用が含まれます。
`web_search_20260209`以降のバージョンでは、Claudeは検索結果が「context window」（コンテキストウィンドウ）に到達する前にそれらをフィルタリングするコードを記述して実行でき（**動的フィルタリング**）、関連する情報のみを保持します。動的フィルタリングは、Claude 4.6以降のモデルおよび[Claude Mythos Preview](https://anthropic.com/glasswing)で利用できます。
ウェブ検索ツールには3つのバージョンがあります。
* `web_search_20250305`：基本的なウェブ検索
* `web_search_20260209`：[動的フィルタリング](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool#dynamic-filtering)を追加
* `web_search_20260318`：エージェントワークフロー向けの[レスポンスへの包含](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool#response-inclusion)制御を追加
このページの例では、基本検索には`web_search_20250305`を、動的フィルタリングには`web_search_20260318`を使用しています。
[Claude Mythos Preview](https://anthropic.com/glasswing)では、ウェブ検索はClaude API、Google Cloud、およびMicrosoft Foundryでサポートされています。Amazon Bedrockまたは[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)上のMythos Previewではウェブ検索は利用できません。
ウェブ検索のZero Data Retention適格性および関連する`allowed_callers`設定については、[サーバーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools#zdr-and-allowed-callers)を参照してください。
モデルのサポートについては、[ツールリファレンス](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-reference)を参照してください。
リクエストを送信する前に、モデルがウェブ検索を受け付けるかどうかを確認するには、Models APIからそのモデルの`capabilities.server_tools.web_search.supported`の値を読み取ります。このフィールドについては[Models APIの使用](https://platform.claude.com/docs/ja/models/overview#using-the-models-api)で説明しています。
## ウェブ検索の仕組み
APIリクエストにウェブ検索ツールを追加すると、次のように動作します。
1. Claudeはプロンプトに基づいて検索するタイミングを判断します。
2. APIが検索を実行し、結果をClaudeに提供します。このプロセスは1つのリクエスト全体で複数回繰り返されることがあります。
3. ターンの最後に、Claudeは引用元付きの最終レスポンスを提供します。
### Claudeが検索するタイミング
Claudeは、リクエストが最新の情報、変化する情報、またはトレーニングデータ外の情報に依存する場合に検索します。
* 最近の出来事、ニュース、発表
* 現在の価格、レート、スコア、統計
* 変化している可能性のある特定の組織、人物、製品に関する情報
* 検索や調査を明示的に求めるリクエスト
Claudeは、リクエストが安定した知識に基づく場合、検索せずに直接回答します。
* 確立された事実、数学、科学の基礎、コーディングの概念
* クリエイティブライティングやブレインストーミング
* 会話内ですでに提供されたコンテンツの分析
* 会話のやり取りや挨拶
トリガーは「system prompt」（システムプロンプト）を通じて調整可能です。Claudeがより積極的に検索するよう促すことも、直接回答を優先するよう促すこともできます。厳密な制約が必要な場合は、`max_uses`を使用してリクエストごとの検索回数に上限を設けてください。
### 動的フィルタリング
基本的なウェブ検索では、すべての検索結果がClaudeのコンテキストウィンドウに読み込まれますが、そのコンテンツの多くはリクエストと無関係な場合があります。`web_search_20260209`以降では、Claudeは代わりに結果を最初にフィルタリングするコードを記述して実行するため、関連するコンテンツのみがコンテキストウィンドウに到達します。これにより、検索を多用するリクエストでのトークン使用量が削減されます。
動的フィルタリングは[コード実行](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)の内部からウェブ検索を実行します。`web_search_20260209`以降では、ツールの`allowed_callers`フィールドのデフォルトは`["code_execution_20260120"]`であり、動的フィルタリングが実行されると、APIはリクエストに必要なコード実行を自動的にプロビジョニングします。コード実行ツールを自分で`tools`に追加する必要はありません。この方法で行われるコード実行呼び出しには、標準のトークンコスト以外の追加料金は発生しません。
動的フィルタリングなしでウェブ検索を直接呼び出すには、`allowed_callers: ["direct"]`を設定します。プログラムによるツール呼び出しをサポートしていないモデルでは、この設定が必要です。設定しない場合、APIはこれを設定するよう指示する400エラーを返します。
ウェブ検索ツール（動的フィルタリングあり・なしの両方）は、Claude API、[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)、および[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_search_20250305`、動的フィルタリングなし）のみをサポートします。Anthropicでホストされているデプロイメントはすべてのバージョンをサポートします。Google Cloudでは、基本的なウェブ検索ツール（動的フィルタリングなし）のみが利用できます。Amazon Bedrockではウェブ検索は利用できません。
以下の例では`web_search_20260318`を使用しています。
```bash cURL
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 4096,
"messages": [
{
"role": "user",
"content": "Search for the current prices of AAPL and GOOGL, then calculate which has a better P/E ratio."
}
],
"tools": [{
"type": "web_search_20260318",
"name": "web_search"
}]
}'
```
```bash CLI
ant messages create <<'YAML'
model: claude-opus-5-5
max_tokens: 4096
messages:
- role: user
content: >-
Search for the current prices of AAPL and GOOGL, then calculate
which has a better P/E ratio.
tools:
- type: web_search_20260318
name: web_search
YAML
```
```python Python
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=4096,
messages=[
{
"role": "user",
"content": "Search for the current prices of AAPL and GOOGL, then calculate which has a better P/E ratio.",
}
],
tools=[{"type": "web_search_20260318", "name": "web_search"}],
)
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:
"Search for the current prices of AAPL and GOOGL, then calculate which has a better P/E ratio."
}
],
tools: [{ type: "web_search_20260318", name: "web_search" }]
});
console.log(response);
```
```csharp C#
AnthropicClient client = new();
var parameters = new MessageCreateParams
{
Model = Model.ClaudeOpus5_5,
MaxTokens = 4096,
Messages = [new() { Role = Role.User, Content = "Search for the current prices of AAPL and GOOGL, then calculate which has a better P/E ratio." }],
Tools = [new ToolUnion(new WebSearchTool20260318())]
};
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("Search for the current prices of AAPL and GOOGL, then calculate which has a better P/E ratio.")),
},
Tools: []anthropic.ToolUnionParam{
{OfWebSearchTool20260318: &anthropic.WebSearchTool20260318Param{}},
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(response)
```
```java Java
import com.anthropic.models.messages.WebSearchTool20260318;
void main() {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
MessageCreateParams params = MessageCreateParams.builder()
.model(Model.CLAUDE_OPUS_5_5)
.maxTokens(4096L)
.addUserMessage("Search for the current prices of AAPL and GOOGL, then calculate which has a better P/E ratio.")
.addTool(WebSearchTool20260318.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' => 'Search for the current prices of AAPL and GOOGL, then calculate which has a better P/E ratio.'],
],
model: 'claude-opus-5-5',
tools: [
[
'type' => 'web_search_20260318',
'name' => 'web_search',
],
],
);
echo $message;
```
```ruby Ruby
client = Anthropic::Client.new
message = client.messages.create(
model: "claude-opus-5-5",
max_tokens: 4096,
messages: [
{ role: "user", content: "Search for the current prices of AAPL and GOOGL, then calculate which has a better P/E ratio." }
],
tools: [{
type: "web_search_20260318",
name: "web_search"
}]
)
puts message
```
## ウェブ検索の使い方
管理者が[Claude Console](https://platform.claude.com/settings/capabilities)で無効にしていない限り、ウェブ検索は組織で有効になっています。管理者はClaude Consoleで、検索対象のドメインを制限することもできます。ウェブ検索が無効になっている場合、このツールを含むリクエストは、検索結果内の[エラーコード](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool#errors)ではなく、ウェブ検索が有効になっていないことを示す400 `invalid_request_error`で失敗します。
Claude Consoleにおけるこれらの組織レベルの設定は、Messages APIリクエストにのみ適用されます。[Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)のセッションでは、代わりにエージェントツールセット上のツールごとの`allowed_domains`および`blocked_domains`リストを使用します。[Web検索とWebフェッチのドメインを制限する](https://platform.claude.com/docs/ja/managed-agents/tools-web-restrictions)を参照してください。`limited`ネットワーキングを使用するクラウド環境のセッションでは、環境の`allowed_hosts`も`web_search`と`web_fetch`に適用されます。[ネットワーキング](https://platform.claude.com/docs/ja/managed-agents/environments#networking)を参照してください。ツールごとのリストは、`allowed_hosts`が許可するホストの範囲内で、これらのツールをさらに制限します。
APIリクエストでウェブ検索ツールを指定します。
```bash cURL
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "What is the weather in NYC?"
}
],
"tools": [{
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5
}]
}'
```
```bash CLI
ant messages create \
--model claude-opus-5-5 \
--max-tokens 1024 \
--message '{role: user, content: What is the weather in NYC?}' \
--tool '{type: web_search_20250305, name: web_search, max_uses: 5}'
```
```python Python
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "What's the weather in NYC?"}],
tools=[{"type": "web_search_20250305", "name": "web_search", "max_uses": 5}],
)
print(response)
```
```typescript TypeScript
const client = new Anthropic();
const response = await client.messages.create({
model: "claude-opus-5-5",
max_tokens: 1024,
messages: [
{
role: "user",
content: "What's the weather in NYC?"
}
],
tools: [
{
type: "web_search_20250305",
name: "web_search",
max_uses: 5
}
]
});
console.log(response);
```
```csharp C#
AnthropicClient client = new();
var parameters = new MessageCreateParams
{
Model = Model.ClaudeOpus5_5,
MaxTokens = 1024,
Messages = [new() { Role = Role.User, Content = "What's the weather in NYC?" }],
Tools = [new ToolUnion(new WebSearchTool20250305() { 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: 1024,
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("What's the weather in NYC?")),
},
Tools: []anthropic.ToolUnionParam{
{OfWebSearchTool20250305: &anthropic.WebSearchTool20250305Param{
MaxUses: anthropic.Int(5),
}},
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(response)
```
```java Java
import com.anthropic.models.messages.WebSearchTool20250305;
void main() {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
MessageCreateParams params = MessageCreateParams.builder()
.model(Model.CLAUDE_OPUS_5_5)
.maxTokens(1024L)
.addUserMessage("What's the weather in NYC?")
.addTool(WebSearchTool20250305.builder()
.maxUses(5L)
.build())
.build();
Message response = client.messages().create(params);
IO.println(response);
}
```
```php PHP
$client = new Client();
$message = $client->messages->create(
maxTokens: 1024,
messages: [
['role' => 'user', 'content' => "What's the weather in NYC?"],
],
model: 'claude-opus-5-5',
tools: [
[
'type' => 'web_search_20250305',
'name' => 'web_search',
'max_uses' => 5,
],
],
);
echo $message;
```
```ruby Ruby
client = Anthropic::Client.new
message = client.messages.create(
model: "claude-opus-5-5",
max_tokens: 1024,
messages: [
{ role: "user", content: "What's the weather in NYC?" }
],
tools: [{
type: "web_search_20250305",
name: "web_search",
max_uses: 5
}]
)
puts message
```
## ツール定義
ウェブ検索ツールは以下のパラメータをサポートしています。
```json JSON
{
"type": "web_search_20250305",
"name": "web_search",
// Optional: Limit the number of searches per request
"max_uses": 5,
// Optional: Only include results from these domains.
// Use allowed_domains or blocked_domains, not both.
"allowed_domains": ["example.com", "trusteddomain.org"],
// Optional: Never include results from these domains
"blocked_domains": ["untrustedsource.com"],
// Optional: Localize search results
"user_location": {
"type": "approximate",
"city": "San Francisco",
"region": "California",
"country": "US",
"timezone": "America/Los_Angeles"
}
}
```
すべてのウェブ検索ツールバージョンは`allowed_callers`を受け付けます。これは、Claudeがウェブ検索を直接呼び出すか、[動的フィルタリング](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool#dynamic-filtering)を通じてコード実行から呼び出すかを制御します。`web_search_20260209`以降では、デフォルトは`["direct"]`ではなく`["code_execution_20260120"]`です。設定方法については[サーバーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools#zdr-and-allowed-callers)を参照してください。`web_search_20260318`以降は[`response_inclusion`](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool#response-inclusion)も受け付けます。
### 最大使用回数
`max_uses`パラメータは、実行される検索の回数を制限します。Claudeが許可された回数を超えて検索を試みた場合、`web_search_tool_result`は`max_uses_exceeded`エラーコードを持つエラーになります。
単純な事実確認のクエリでは通常1〜3回の検索を使用します。比較や複数エンティティの調査では10回以上使用することがあります。値の選び方のガイダンスについては、[サーバーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools)を参照してください。
### ドメインフィルタリング
`allowed_domains`または`blocked_domains`のいずれか一方を指定し、両方は指定しないでください。リクエストに両方が含まれている場合、APIは400エラーを返します。エントリはスキームなしの、オプションのパス付きのベアドメインです（例：`example.com`または`example.com/blog`）。
ドメインフィルタリングの完全なルールについては、サーバーツールガイドの[ドメインフィルタリング](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_search`エントリにこれらのフィールドを設定します。[Web検索とWebフェッチのドメインを制限する](https://platform.claude.com/docs/ja/managed-agents/tools-web-restrictions)を参照してください。
### ローカライゼーション
`user_location`パラメータを使用すると、ユーザーの所在地に基づいて検索結果をローカライズできます。`city`、`region`、`country`、`timezone`のうち少なくとも1つを指定してください。
* `type`：所在地のタイプ（`approximate`である必要があります）
* `city`：都市名
* `region`：地域または州
* `country`：2文字の[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)国コード。APIはサポートされていない国コードを400エラーで拒否します。
* `timezone`：[IANAタイムゾーンID](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)。
Claude Managed Agentsでは、エージェントツールセットの`web_search`エントリが同じフィールドを持つ`user_location`オブジェクトを受け付けます。エージェントを作成または更新するとき、あるいはこの設定を指定するセッションを作成または更新するときに、サポートされていない`country`コードがあると、APIは400エラーで拒否します。[Webツールの設定](https://platform.claude.com/docs/ja/managed-agents/tools-web-restrictions#settings)を参照してください。
### レスポンスへの包含
`web_search_20260318`以降が必要です。
`response_inclusion`パラメータは、同じターン内で完了した[コード実行](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)呼び出しによって結果が消費された場合に、検索結果ブロックがAPIレスポンスにどのように表示されるかを制御します。`"response_inclusion": "excluded"`を設定すると、それらのネストされた`server_tool_use`と結果ブロックのペアがレスポンスから完全に削除され、生の検索コンテンツをクライアントにエコーバックする必要のないエージェントワークフローの出力トークンコストが削減されます。デフォルトは`"full"`です。直接呼び出しからの結果、または完了前に一時停止したコード実行呼び出しからの結果は、次のターンで送り返せるように常に完全な形で返されます。
```json JSON
{
"tools": [
{
"type": "web_search_20260318",
"name": "web_search",
"response_inclusion": "excluded"
}
]
}
```
## レスポンス
レスポンス構造の例を以下に示します。
```json Output
{
"role": "assistant",
"content": [
// 1. Claude's decision to search
{
"type": "text",
"text": "I'll search for when Claude Shannon was born."
},
// 2. The search query used
{
"type": "server_tool_use",
"id": "srvtoolu_01WYG3ziw53XMcoyKL4XcZmE",
"name": "web_search",
"input": {
"query": "claude shannon birth date"
}
},
// 3. Search results
{
"type": "web_search_tool_result",
"tool_use_id": "srvtoolu_01WYG3ziw53XMcoyKL4XcZmE",
"content": [
{
"type": "web_search_result",
"url": "https://en.wikipedia.org/wiki/Claude_Shannon",
"title": "Claude Shannon - Wikipedia",
"encrypted_content": "EqgfCioIARgBIiQ3YTAwMjY1Mi1mZjM5LTQ1NGUtODgxNC1kNjNjNTk1ZWI3Y...",
"page_age": "April 30, 2025"
}
]
},
{
"text": "Based on the search results, ",
"type": "text"
},
// 4. Claude's response with citations
{
"text": "Claude Shannon was born on April 30, 1916, in Petoskey, Michigan",
"type": "text",
"citations": [
{
"type": "web_search_result_location",
"url": "https://en.wikipedia.org/wiki/Claude_Shannon",
"title": "Claude Shannon - Wikipedia",
"encrypted_index": "Eo8BCioIAhgBIiQyYjQ0OWJmZi1lNm..",
"cited_text": "Claude Elwood Shannon (April 30, 1916 – February 24, 2001) was an American mathematician, electrical engineer, computer scientist, cryptographer and i..."
}
]
}
],
"id": "msg_a930390d3a",
"usage": {
"input_tokens": 6039,
"output_tokens": 931,
"server_tool_use": {
"web_search_requests": 1
}
},
"stop_reason": "end_turn"
}
```
この例は直接検索を示しています。検索が[動的フィルタリング](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool#dynamic-filtering)を通じて実行される場合、レスポンスには[コード実行ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)の結果ブロックも含まれ、ネストされた各`server_tool_use`と`web_search_tool_result`のペアには、それを呼び出したコード実行呼び出しを識別する`caller`フィールドが付きます。
### 検索結果
検索結果には以下が含まれます。
* `url`：ソースページのURL
* `title`：ソースページのタイトル
* `page_age`：サイトが最後に更新された時期
* `encrypted_content`：マルチターン会話で送り返す必要がある暗号化されたコンテンツ
検索結果を含む会話を続けるには、各結果の`encrypted_content`を含め、アシスタントのコンテンツブロックを受け取ったとおりに正確に送り返してください。APIは後続のターンでそのコンテンツを復号し、Claudeのコンテキスト内に検索結果を復元します。`encrypted_content`が欠落しているか変更されている場合、リクエストは400バリデーションエラーで失敗します。
### 引用
ウェブ検索では引用は常に有効であり、各`web_search_result_location`には以下が含まれます。
* `url`：引用元のURL
* `title`：引用元のタイトル
* `encrypted_index`：マルチターン会話で送り返す必要がある参照
* `cited_text`：引用されたコンテンツの最大150文字
ウェブ検索の引用フィールド`cited_text`、`title`、`url`は、入力または出力トークン使用量にカウントされません。
API出力をエンドユーザーに直接表示する場合は、元のソースへの引用を含める必要があります。エンドユーザーに表示する前に再処理したり独自の素材と組み合わせたりするなど、API出力に変更を加える場合は、法務チームとの協議に基づいて適切に引用を表示してください。
### エラー
ウェブ検索ツールがエラー（「rate limit」（レート制限）への到達など）に遭遇した場合でも、Claude APIは200（成功）レスポンスを返します。エラーはレスポンス本文内で以下の構造を使用して表現されます。
```json Output
{
"type": "web_search_tool_result",
"tool_use_id": "srvtoolu_a93jad",
"content": {
"type": "web_search_tool_result_error",
"error_code": "max_uses_exceeded"
}
}
```
エラー時には、`content`は結果ブロックのリストではなく単一のエラーオブジェクトになります。検索が成功したものの一致する結果がなかった場合は、エラーではなく空の`content`リストが返されます。
発生しうるエラーコードは以下のとおりです。
* `too_many_requests`：レート制限を超過
* `invalid_tool_input`：無効な検索クエリパラメータ
* `max_uses_exceeded`：ウェブ検索ツールの最大使用回数を超過
* `query_too_long`：クエリが最大長を超過
* `request_too_large`：検索リクエストが大きすぎる（通常は長いドメインフィルタリストが原因）
* `unavailable`：内部エラーが発生
### `pause_turn`停止理由
APIは長時間実行される検索ターンを一時停止し、`stop_reason: "pause_turn"`を返すことがあります。続行するには、一時停止したアシスタントメッセージを変更せずに新しいリクエストで送り返してください。
Claudeが同じ並列ツール呼び出しグループ内でウェブ検索とクライアントツールの1つを呼び出した場合、APIは代わりに`stop_reason: "tool_use"`を返し、検索はまだ実行しません。続行するには、クライアントツールの結果を返してください。APIは次のリクエストで検索を実行します。[1つのターンでサーバーツールとクライアントツールを混在させる](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools#mixing-server-tools-and-client-tools-in-one-turn)を参照してください。
サーバーサイドループと`pause_turn`の処理については、サーバーツールガイドの[サーバーサイドループとpause\_turn](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools#the-server-side-loop-and-pause-turn)を参照してください。
## プロンプトキャッシング
ターンをまたいでツール定義をキャッシュするには、[プロンプトキャッシングを使用したツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-use-with-prompt-caching)を参照してください。
## ストリーミング
「streaming」（ストリーミング）を有効にすると、ストリームの一部として検索イベントを受け取ります。検索の実行中は一時停止が発生します。
```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 search
event: content_block_start
data: {"type": "content_block_start", "index": 1, "content_block": {"type": "server_tool_use", "id": "srvtoolu_xyz789", "name": "web_search"}}
// Search query streamed
event: content_block_delta
data: {"type": "content_block_delta", "index": 1, "delta": {"type": "input_json_delta", "partial_json": "{\"query\":\"latest quantum computing breakthroughs 2025\"}"}}
// Pause while search executes
// Search results streamed
event: content_block_start
data: {"type": "content_block_start", "index": 2, "content_block": {"type": "web_search_tool_result", "tool_use_id": "srvtoolu_xyz789", "content": [{"type": "web_search_result", "title": "Quantum Computing Breakthroughs in 2025", "url": "https://example.com"}]}}
// Claude's response with citations (omitted in this example)
```
## バッチリクエスト
[Messages Batches API](https://platform.claude.com/docs/ja/build-with-claude/batch-processing)にウェブ検索ツールを含めることができます。Messages Batches APIを通じたウェブ検索ツール呼び出しは、通常のMessages APIリクエストと同じ料金です。
共有キャパシティを保護するため、Batches APIは組織ごとにウェブ検索リクエストをスロットリングします。そのため、多くの検索を含む大規模なバッチは完了までに時間がかかる場合があります。組織のウェブ検索のレート制限は、Claude Consoleの[レート制限](https://platform.claude.com/usage/limits)ページで確認できます。より高い制限をリクエストするには、そのページから営業担当にお問い合わせください。
## 使用量と料金
ウェブ検索の使用は、トークン使用量に加えて課金されます。
```json
{
"usage": {
"input_tokens": 105,
"output_tokens": 6039,
"cache_read_input_tokens": 7123,
"cache_creation_input_tokens": 7345,
"server_tool_use": {
"web_search_requests": 1
}
}
}
```
ウェブ検索はClaude APIで**1,000回の検索あたり$10**で利用でき、検索によって生成されたコンテンツには標準のトークンコストが加算されます。会話全体を通じて取得されたウェブ検索結果は、単一のターン内で実行される検索の反復においても、その後の会話ターンにおいても、入力トークンとしてカウントされます。
各ウェブ検索は、返される結果の数に関係なく1回の使用としてカウントされます。ウェブ検索中にエラーが発生した場合、そのウェブ検索は課金されません。
## 次のステップ
特定のURLからコンテンツを取得して読み取り、ライブのウェブコンテンツでClaudeのコンテキストを拡張します。
Anthropicが実行するツールの扱い方：server\_tool\_useブロック、pause\_turnの継続、ドメインフィルタリング。
Anthropic提供ツールの一覧と、オプションのツール定義プロパティのリファレンス。