Claude 가이드 #15: Web Fetch — 링크 하나 던지면 Claude가 직접 읽어옵니다

이 글은 Claude API 공식 문서의 Web Fetch tool 페이지를 정리한 글입니다. 원문: https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool 마지막 확인: 2026-05-25

1. 한 줄 요약
#

길고 복잡한 자료를 통째로 붙여넣지 마세요. 주소(URL)만 던지면 Claude가 그 페이지에 직접 들어가 읽고 정리해줍니다.

2. 무엇이고 왜 좋을까
#

도서관에서 책을 직접 가져다주는 사서와 같습니다. 내가 “그 책 어디 있죠?” 하고 위치만 알려주면, 사서가 책장으로 가서 책을 꺼내 펴서 읽고 요약까지 해주는 식입니다.

지금까지 Claude에게 긴 글을 부탁할 때는, 그 글을 직접 복사해서 채팅창에 붙여넣어야 했습니다. 100쪽짜리 PDF를 복사하려면 어디서부터 어디까지 끌어야 할지 헷갈리고, 표나 그림은 빠지기 일쑤죠. Web Fetch(웹 페치, “웹에서 가져오기”) 는 이 과정을 한 줄로 줄여줍니다. URL(Uniform Resource Locator, 웹 주소)만 주면 Claude가 그 페이지의 본문과 PDF까지 직접 열어 읽습니다.

대략적인 감으로, 평균 웹페이지 한 쪽은 약 2,500 토큰 정도를 차지합니다. PDF 한 편은 12만 5천 토큰까지 갈 수도 있는데(연구 논문 기준), Web Fetch는 이 모든 걸 Claude가 알아서 가져옵니다. 사용료는 따로 없고, 가져온 글에 대한 일반 토큰 비용만 냅니다.

3. 이런 상황에서 써요
#

상황 1: 강의 자료 PDF가 학교 홈페이지에 올라와 있어요
#

대학생이 다음 주 시험 준비를 합니다. 교수님이 강의 자료를 학교 사이트에 PDF로 올려놓으셨고요. 파일을 다운로드해서 다시 첨부하는 과정이 번거롭게 느껴집니다. 그때 그냥 학교 사이트의 PDF 주소를 Claude에게 알려주면 됩니다. “이 주소의 자료에서 3장 핵심만 정리해줘"라고 부탁하면, Claude가 직접 들어가 본문을 읽고 정리해줍니다. PDF의 표나 인용도 같이 잡아주니, 다운로드부터 복사까지의 단계가 사라집니다.

상황 2: 회사 정책 페이지가 자주 바뀌어요
#

총무팀에서 일하는 직장인이 동료들에게 받는 가장 흔한 질문은 “올해 연차 규정 어떻게 바뀌었어요?” 같은 것들입니다. 사내 위키나 인사 페이지에 정책이 올라와 있는데, 매번 페이지를 열어 해당 부분을 찾아 복사해서 답해주기는 번거롭죠. Claude에게 그 정책 페이지 주소를 주고 “이 페이지에서 연차 관련 부분만 알려줘"라고 물으면, Claude가 그 자리에서 페이지를 읽고 답해줍니다. 정책이 업데이트되면 다시 같은 주소를 물어보기만 하면 됩니다.

상황 3: 긴 블로그 글이나 뉴스레터를 빠르게 훑고 싶어요
#

주말 아침에 평소 좋아하던 블로그에 긴 글 한 편이 올라왔습니다. 한 20분쯤 걸려 보이는데, 핵심만 먼저 알고 그다음에 천천히 읽고 싶다면? 글의 URL을 Claude에게 주고 “이 글의 결론과 가장 중요한 세 가지만 알려줘"라고 부탁하면 됩니다. Claude가 본문을 읽어 요약해주고, 인용까지 켜놓으면 어느 문장에서 그런 결론을 낸 건지도 짚어줍니다. 책 한 권을 통째로 분석하는 데까지는 못 미치지만, 긴 글 한 편은 30초면 큰 그림이 잡힙니다.

4. 가볍게 시작하기
#

💻 개발 경험이 있으신가요? 아래 코드는 Python(파이썬) 기준 가장 짧은 예시입니다. 비개발자라면 “아, 이런 식으로 부탁하는구나” 정도로 보고 넘어가셔도 좋습니다. 핵심은 Claude에게 “URL을 직접 열어볼 수 있는 도구"를 손에 쥐여주는 것뿐입니다.

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "https://example.com/article 이 글의 핵심 세 가지만 알려주세요."
        }
    ],
    # 이 부분이 Web Fetch 도구를 켜는 한 줄입니다
    tools=[{
        "type": "web_fetch_20250910",
        "name": "web_fetch",
        "max_uses": 3
    }]
)

print(response)

코드에서 진짜 새로 더해진 부분은 맨 아래 tools 줄뿐입니다. 이 한 줄을 켜놓으면 Claude가 메시지 속 URL을 발견할 때 “아, 이 페이지에 들어가서 직접 읽고 와도 되겠다"라고 판단합니다. max_uses는 한 번의 대화에서 최대 몇 페이지까지 열어볼지 정하는 안전장치입니다(예: 3이면 세 번까지). 보안상 Claude가 마음대로 URL을 만들어내진 못하고, 내가 메시지에 직접 적은 주소만 열어봅니다.

5. 흔한 오해와 함정
#

⚠️ 함정 1: “주소만 알려주면 어디든 다 읽어오겠죠?”
#

아쉽게도 그렇지 않습니다. Web Fetch는 JavaScript로 동적으로 그려지는 페이지(예: 로그인 후 보이는 화면, 무한 스크롤로 글이 채워지는 SNS)는 잘 못 읽습니다. 글이 본문 HTML(웹페이지의 뼈대) 안에 그대로 박혀 있는 사이트(블로그, 뉴스, 위키, PDF 등)에 가장 잘 어울립니다. 시도했는데 빈 내용만 돌아온다면, 그 페이지가 동적 페이지일 가능성이 큽니다.

⚠️ 함정 2: “큰 PDF를 통째로 읽으면 비용이 폭발하지 않을까?”
#

맞습니다. 500KB(킬로바이트)짜리 논문 PDF는 약 12만 5천 토큰을 잡아먹습니다. 그럴 땐 도구 설정에 max_content_tokens(최대 가져올 글자 수)를 정해두세요. 예: "max_content_tokens": 50000이라고 적으면 그 이상은 잘립니다. PDF 전체가 아니라 앞부분 일부만 요약해도 충분한 경우엔 비용을 크게 아낄 수 있습니다.

⚠️ 함정 3: “Claude가 답해줬는데, 어느 문장에서 가져온 건지 모르겠어요”
#

기본 설정에서는 인용이 꺼져 있습니다. 답이 어느 페이지 어느 문장에서 왔는지 표시해주길 원하면 도구 설정에 "citations": {"enabled": true}를 켜주세요. 그러면 “이 부분은 원문 1234~1456 글자 사이에서 가져온 거예요"라고 Claude가 표시해줍니다. 자료 정확성이 중요한 학교 과제나 업무 보고에서 특히 유용합니다.

6. 한 단계 더 (관심 있는 분만)
#

🎯 여기까지 오신 분 환영합니다. 이 섹션은 “검색"과 “읽기"를 동시에 쓰는 더 강력한 방법을 소개합니다. 본문만 읽으셔도 충분합니다.

Web Fetch는 사실 친구 한 명을 두고 있어요. 자매 도구인 Web Search(웹 검색) 입니다. 둘을 같이 켜두면 Claude가 이렇게 일합니다: “먼저 검색해서 관련 글 몇 개를 찾고, 그중 가장 좋아 보이는 것 하나를 골라 본문까지 읽고 정리한다.” 직접 URL을 모를 때 특히 편합니다.

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "최근 한국의 전기차 보조금 정책 뉴스 중 가장 자세한 글을 골라 핵심을 정리해주세요."
        }
    ],
    tools=[
        # 도구 1: 먼저 웹에서 관련 글을 찾는다
        {"type": "web_search_20250305", "name": "web_search", "max_uses": 3},
        # 도구 2: 찾은 글 중 좋아 보이는 것의 본문을 직접 읽는다
        {
            "type": "web_fetch_20250910",
            "name": "web_fetch",
            "max_uses": 2,
            "citations": {"enabled": True}
        }
    ]
)

도구 두 개를 한 번에 쥐여주면, Claude가 “검색 → 선별 → 본문 읽기 → 정리"를 알아서 이어 합니다. 마치 도서관에 가서 “이 주제 자료 좀 찾아주세요"라고 부탁한 뒤, 사서가 책 몇 권을 골라와 가장 좋은 한 권을 펼쳐 읽어주는 모습입니다. 인용까지 켜뒀으니 어디서 가져온 내용인지도 같이 알려줍니다.

참고로 가격은 이렇습니다. Web Fetch 자체에는 추가 요금이 없고, 가져온 본문을 Claude가 읽은 만큼만 일반 토큰 비용이 듭니다.

가져오는 자료	대략적인 크기	입력 토큰
평균 웹페이지	10KB	약 2,500 토큰
큰 문서 페이지	100KB	약 25,000 토큰
논문 PDF	500KB	약 125,000 토큰

7. 한 마디
#

처음엔 “Claude가 진짜 그 페이지에 들어가서 읽는다고?” 싶을 수 있는데, 막상 한 번 써보면 “그동안 왜 복사·붙여넣기로 고생했지” 싶어집니다. 무료로 켤 수 있고, 코드도 한 줄만 더하면 끝이라서 부담이 거의 없습니다.

혹시 답이 비어 나오거나 이상하다면, 함정 1~3 중 하나일 가능성이 큽니다. 동적으로 그려지는 페이지인지, PDF가 너무 큰지, 인용이 꺼져 있는지를 차례로 살펴보세요. 그리고 회사 내부망이나 로그인이 필요한 페이지는 Claude가 직접 접근할 수 없다는 점도 기억해두시면 좋습니다.

다음 글에서는 Claude 가이드 #16 — Code Execution Tool(코드 실행 도구) 을 다룹니다. Claude가 직접 짧은 코드를 돌려보면서 계산하고 데이터를 정리하는 기능인데, 오늘 본 Web Fetch와 합치면 “웹에서 가져온 표를 그 자리에서 분석"하는 일도 가능해집니다. 천천히 한 발씩 따라와 주세요. 어렵게 보여도, 결국엔 한 줄짜리 도구들의 조합일 뿐이니까요.

Claude API 공식 문서를 한국어로 풀어쓴 시리즈입니다. 원문 정확성이 가장 우선, 의역과 친근함은 그 위에서.