웹 페치

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

기본 사용

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

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

추출 모드

markdown (기본)
text

web_fetch(
  url="https://blog.example.com/post",
  extractMode="markdown"
)

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

web_fetch(
  url="https://blog.example.com/post",
  extractMode="text"
)

순수 텍스트만 추출합니다. 토큰 절약에 유리합니다.

크기 제한

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

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

활용 사례

📰 기사 요약

URL을 주면 기사 내용을 추출하고 요약

📋 문서 분석

API 문서, README 등을 읽고 분석

🔍 검색 결과 상세

web_search 후 관련 URL 상세 조회

📊 데이터 수집

테이블, 리스트 등 구조화된 데이터 추출

실전 패턴

검색 → 상세 조회

사용자: "이 기술에 대해 자세히 알려줘"
→ 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. 가격 비교표 작성

제한사항

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

web_fetch vs browser

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

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

Part 7: 노드 & 디바이스

Part 8: 메시징 통합

Part 9: 브라우저 & 웹

기본 사용

추출 모드

크기 제한

활용 사례

📰 기사 요약

📋 문서 분석

🔍 검색 결과 상세

📊 데이터 수집

실전 패턴

검색 → 상세 조회

링크 요약

가격 비교

제한사항

web_fetch vs browser

​기본 사용

​추출 모드

​크기 제한

​활용 사례

📰 기사 요약

📋 문서 분석

🔍 검색 결과 상세

📊 데이터 수집

​실전 패턴

​검색 → 상세 조회

​링크 요약

​가격 비교

​제한사항

​web_fetch vs browser

기본 사용

추출 모드

크기 제한

활용 사례

실전 패턴

검색 → 상세 조회

링크 요약

가격 비교

제한사항

web_fetch vs browser