web_fetch는 URL에서 읽기 쉬운 텍스트를 추출하는 도구입니다.
브라우저 없이 빠르게 웹 콘텐츠를 가져옵니다.
기본 사용
web_fetch(url="https://example.com/article")
추출 모드
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를 사용하세요.