> ## Documentation Index
> Fetch the complete documentation index at: https://oc-guide.openclaw-korea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 웹 페치

> URL에서 콘텐츠 추출하기

`web_fetch`는 URL에서 **읽기 쉬운 텍스트를 추출**하는 도구입니다.
브라우저 없이 빠르게 웹 콘텐츠를 가져옵니다.

## 기본 사용

```
web_fetch(url="https://example.com/article")
```

마크다운 또는 텍스트 형태로 콘텐츠를 반환합니다.

## 추출 모드

<Tabs>
  <Tab title="markdown (기본)">
    ```
    web_fetch(
      url="https://blog.example.com/post",
      extractMode="markdown"
    )
    ```

    헤딩, 링크, 리스트 등 구조를 유지합니다.
  </Tab>

  <Tab title="text">
    ```
    web_fetch(
      url="https://blog.example.com/post",
      extractMode="text"
    )
    ```

    순수 텍스트만 추출합니다. 토큰 절약에 유리합니다.
  </Tab>
</Tabs>

## 크기 제한

```
web_fetch(
  url="https://long-article.com",
  maxChars=5000  # 최대 5000자까지만
)
```

<Tip>
  긴 문서는 `maxChars`로 제한하세요.
  전체 내용이 필요하면 나눠서 요청하거나, AI에게 핵심만 추출하라고 지시하세요.
</Tip>

## 활용 사례

<CardGroup cols={2}>
  <Card title="📰 기사 요약" icon="newspaper">
    URL을 주면 기사 내용을 추출하고 요약
  </Card>

  <Card title="📋 문서 분석" icon="file-lines">
    API 문서, README 등을 읽고 분석
  </Card>

  <Card title="🔍 검색 결과 상세" icon="magnifying-glass">
    web\_search 후 관련 URL 상세 조회
  </Card>

  <Card title="📊 데이터 수집" icon="table">
    테이블, 리스트 등 구조화된 데이터 추출
  </Card>
</CardGroup>

## 실전 패턴

### 검색 → 상세 조회

```
사용자: "이 기술에 대해 자세히 알려줘"
→ AI:
  1. web_search(query="해당 기술")
  2. 상위 3개 URL에 web_fetch
  3. 내용 종합해서 설명
```

### 링크 요약

```
사용자: "https://article.com/long-post 요약해줘"
→ AI:
  1. web_fetch(url="https://article.com/long-post", maxChars=10000)
  2. 핵심 내용 3줄 요약
```

### 가격 비교

```
사용자: "이 제품 가격 찾아줘"
→ AI:
  1. web_search(query="제품명 가격")
  2. 여러 쇼핑몰 URL에 web_fetch
  3. 가격 비교표 작성
```

## 제한사항

<Warning>
  * JavaScript로 렌더링되는 SPA 사이트는 내용이 빈 상태로 추출될 수 있습니다
  * 로그인이 필요한 페이지는 접근 불가합니다
  * 일부 사이트는 봇 접근을 차단합니다
  * 위 경우에는 `browser` 도구를 사용하세요
</Warning>

## web\_fetch vs browser

| 상황              | 추천 도구                    |
| --------------- | ------------------------ |
| 정적 HTML 페이지     | `web_fetch` ✅            |
| 블로그, 뉴스 기사      | `web_fetch` ✅            |
| SPA (React/Vue) | `browser` ✅              |
| 로그인 필요          | `browser` (Chrome 릴레이) ✅ |
| API 문서          | `web_fetch` ✅            |
| 인터랙션 필요         | `browser` ✅              |

<Info>
  `web_fetch`는 빠르고 비용이 적습니다.
  항상 `web_fetch`를 먼저 시도하고, 실패하면 `browser`를 사용하세요.
</Info>