> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arouter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 웹 검색 도구

> 모델에 실시간 웹 검색 기능을 제공합니다. ARouter가 검색을 실행하고 인용이 포함된 구조화된 결과를 주입합니다——클라이언트 측 코드가 필요하지 않습니다.

`web_search` Server Tool을 사용하면 모델이 추론 중에 웹을 검색할 수 있습니다. 모델이 검색이 필요한 시점을 결정하고, ARouter가 검색을 수행하며, 결과가 자동으로 모델의 컨텍스트에 주입됩니다.

<Note>
  이것은 더 이상 사용되지 않는 `web` 플러그인과 `:online` 모델 접미사의 권장 대체 방법입니다.
</Note>

## 빠른 시작

```json theme={null}
{
  "model": "openai/gpt-5.4",
  "messages": [{"role": "user", "content": "What happened in AI research this week?"}],
  "tools": [{"type": "arouter", "arouter": {"id": "web_search"}}]
}
```

## 구성

| 매개변수                | 유형         | 기본값 | 설명                                                         |
| ------------------- | ---------- | --- | ---------------------------------------------------------- |
| `id`                | `string`   | —   | `"web_search"` 이어야 합니다                                     |
| `max_results`       | `integer`  | `5` | 반환할 최대 검색 결과 수                                             |
| `engine`            | `string`   | 자동  | 검색 엔진: `"native"`, `"exa"`, `"parallel"`, 또는 `"firecrawl"` |
| `include_domains`   | `string[]` | —   | 결과를 이 도메인으로 제한 (와일드카드 지원)                                  |
| `exclude_domains`   | `string[]` | —   | 이 도메인의 결과 제외 (와일드카드 지원)                                    |
| `max_total_results` | `integer`  | —   | 하나의 요청에서 여러 검색의 총 결과 수 제한                                  |

## 엔진 선택

| 엔진            | 설명                                  | 최적 용도      |
| ------------- | ----------------------------------- | ---------- |
| (미설정)         | 제공자가 지원하면 native 사용, 아니면 Exa        | 일반 용도      |
| `"native"`    | 제공자의 내장 검색 (OpenAI, Anthropic, xAI) | 최고의 인용 품질  |
| `"exa"`       | Exa의 신경망+키워드 하이브리드 검색               | 연구, 틈새 주제  |
| `"parallel"`  | Parallel의 검색 API                    | 빠른 광범위한 쿼리 |
| `"firecrawl"` | Firecrawl 심층 크롤 (BYOK)              | 전체 페이지 콘텐츠 |

## 인용 파싱

```json theme={null}
{
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "According to recent research...",
      "annotations": [{
        "type": "url_citation",
        "url_citation": {
          "url": "https://arxiv.org/abs/2501.12345",
          "title": "Scaling Laws for LLMs",
          "content": "We study the relationship between...",
          "start_index": 32, "end_index": 96
        }
      }]
    }
  }]
}
```

## 가격

| 엔진                              | 비용                          |
| ------------------------------- | --------------------------- |
| Exa                             | 1,000 결과당 \$4.00            |
| Parallel                        | 1,000 결과당 \$4.00            |
| Native (OpenAI, Anthropic, xAI) | 제공자 요금으로 패스스루               |
| Firecrawl                       | BYOK——귀하의 Firecrawl API key |

## Web 플러그인에서 마이그레이션

**이전 (더 이상 사용되지 않음):**

```json theme={null}
{"model": "openai/gpt-5.4:online", "messages": [...]}
```

**이후 (권장):**

```json theme={null}
{"model": "openai/gpt-5.4", "tools": [{"type": "arouter", "arouter": {"id": "web_search"}}], "messages": [...]}
```