Claude 블로그 되짚어보기 #24 — API 웹 검색, 에이전트의 기본 도구로 자리잡다 (2025)

panicdev·2026년 4월 22일

원문 정보

  • 제목: Introducing web search on the Anthropic API
  • 링크: claude.com/blog/web-search-api
  • 발행: 2025년 5월 7일 (2025년 9월 10일 web_fetch 도구 추가 업데이트)
  • 카테고리: Product announcements

글의 요지

Anthropic API에 웹 검색 도구가 추가됐다. Claude.ai에서 3월에 사용자용으로 공개된 웹 검색이 이제 개발자가 직접 빌드하는 앱·에이전트에서도 사용 가능하다.

동작 방식

Messages API 요청에 web search tool을 enable하면 된다.

  1. Claude가 요청을 받고, 최신 정보가 필요한지 reasoning으로 판단
  2. 필요하면 타깃 검색 쿼리를 스스로 생성
  3. 결과를 수집하고 핵심 정보 분석
  4. 인용(citation) 포함한 종합 답변 반환

Claude는 또한 여러 번의 검색을 연쇄적으로 수행할 수 있다. 앞 검색 결과에 따라 다음 쿼리를 정제하면서 경량 리서치를 수행. max_uses 파라미터로 검색 횟수 제한 가능.

가격

  • $10 / 1,000 검색 (= $0.01 / 검색) + 표준 토큰 비용
  • Brave Search API보다 약간 비싸지만 (Brave는 $3/$5/$9), reasoning + 결과 요약이 함께 붙는다

지원 모델

  • Claude 3.7 Sonnet
  • 업그레이드된 Claude 3.5 Sonnet
  • Claude 3.5 Haiku

기업 제어 기능

  • Domain allow lists: 특정 도메인만 허용 (내부 문서, 신뢰 소스)
  • Domain block lists: 민감·경쟁·부적절 콘텐츠 차단
  • Organization-level management: 조직 차원 on/off 제어

Claude Code에서도 사용 가능

Claude Code에도 웹 검색이 들어왔다. 최신 API 문서, 기술 기사, 새로 나온 프레임워크의 정보를 개발 워크플로에서 바로 참조 가능.

파트너 코멘트

  • Quora Poe: "Poe 플랫폼에 환영할 만한 추가, 비용 효율적이고 속도가 인상적"
  • Adaptive (AI 앱 빌더): "다른 도구보다 일관되게 철저한 결과, 리서치 에이전트 역할 훌륭"

2026년에 다시 읽으며 — 내가 본 것

1. 1.5개월 만의 속도감 — 제품화에서 API화까지

타임라인을 정리하면:

  • 2025년 3월 20일: Claude.ai에 웹 검색 사용자 기능
  • 2025년 5월 7일: Anthropic API에 웹 검색 도구 (본 글)

불과 7주. 이게 짧은 이유는, 사용자용 웹 검색과 개발자용 API 웹 검색은 인프라가 거의 같지만 설계 결정이 매우 다르다는 점 때문이다.

개발자용 API는 추가로 고려할 게 많다:

  • Pricing: 얼마에 팔 것인가? ($10 / 1K가 Brave 마진 + Anthropic 부가가치 수수료)
  • Rate limits: 정상 사용 vs 남용 구분
  • Domain 제어: 기업용으로는 필수
  • Reasoning cost 포함: 단순 검색이 아니라 Claude가 판단해서 여러 번 검색하는 구조

이 결정들이 7주 안에 확정됐다. Anthropic이 "먼저 사용자에게 풀고, 피드백 반영해 API화" 라는 리듬을 확립했음을 보여준다.

2. "$10/1K"라는 가격 결정의 의미

Simon Willison의 블로그 글이 정확히 짚었다 — Brave Search API는 $3/$5/$9 per 1K이지만 Claude API web search는 $10. 즉 Brave 가격 + $1~$7의 Anthropic 마진이다.

이 마진을 정당화하는 건 뭘까? 단순히 "중간 수수료"라면 너무 비싸다. 실제로는 Anthropic이 추가로 제공하는 가치가 있다.

  • 쿼리 자동 생성: 사용자가 직접 쿼리 만들 필요 없음 (Claude의 reasoning)
  • 결과 분석: 수십 개 링크를 Claude가 추린 뒤 요약까지 반환
  • 반복 검색 자동화: 첫 결과 보고 두 번째 검색 여부 판단
  • 인용 자동 붙이기: Citations API와 같은 포맷
  • 보안·필터링: 도메인 제어, 악성 콘텐츠 차단

즉 이 $10은 "검색 API 사용료"가 아니라 "Claude가 조사 에이전트 역할을 하는 복합 서비스 요금". 비교 대상은 Brave 단독 API가 아니라 "개발자가 직접 구현한 search + rerank + summarize 파이프라인" 이어야 한다.

2026년 현재 이 가격대는 유지됐지만, Exa, Tavily, Serper 등 AI 친화적 검색 API가 $5 미만으로 내려오면서 경쟁이 생겼다. Anthropic의 웹 검색은 "편리함 프리미엄" 포지션을 유지한다.

3. "Brave를 쓴다"는 사실의 기술적 파장

이 블로그는 백엔드를 명시하지 않지만, 업계는 이미 Claude 웹 검색 = Brave Search 기반으로 알고 있다. 이게 기술적으로 의미하는 것:

  • Claude 검색 결과 품질 = Brave 검색 품질 (재랭킹 최소)
  • Google 품질에 못 미치는 영역 존재: 복잡한 쿼리, 의도 해석, 로컬 검색
  • Brave의 독립 크롤러 인덱스 크기: Google/Bing 대비 작음

실제로 WebSearchAPI.ai의 분석이 주목할 만하다 — "Claude 검색은 Google의 오랜 알고리즘에 비하면 상대적으로 새롭다. 복잡하거나 미묘한 쿼리에서는 품질이 낮을 수 있다."

그럼에도 Anthropic이 Brave를 유지하는 이유는:

  • 경쟁사 독립성: Google/Microsoft에 의존하지 않음
  • 프라이버시 우호적: Brave의 브랜드 가치
  • MCP 생태계와 잘 어울림: 제3자 파트너 전략

이 선택의 장단점이 2026년까지 이어지고 있다. 더 엄밀한 검색이 필요한 고객은 자체 Exa/Tavily MCP 서버를 Claude에 연결해서 쓰는 패턴이 늘었다.

4. "Claude Code가 웹 검색을 얻었다"의 개발자 워크플로 변화

본문에 한 줄 섞인 "Claude Code에도 웹 검색 추가" 가 실무에서는 훨씬 큰 변화다.

이전 AI 코딩 도구(GitHub Copilot, Cursor, Claude Code 초기 등)의 공통 한계:

  • 학습 데이터 이후 나온 라이브러리·API 버전을 모름
  • "npm install react@19"가 뭔지 모를 수 있음
  • 최신 프레임워크 릴리스 노트를 못 읽음
  • StackOverflow 최근 답변을 활용 못 함

웹 검색이 Claude Code에 들어온 순간 이 한계가 풀렸다. Claude Code가 "2025년 5월의 React 19 최신 문서" 같은 걸 직접 찾아서 코드에 반영한다. 개발자의 "이 라이브러리 새 버전 어떻게 쓰지?" 같은 질문에 Claude Code가 자체적으로 답을 구한다.

2026년 기준 Claude Code의 웹 검색 활용 패턴은 더 정교해졌다.

  • API 문서 검색 → 직접 코드 반영
  • GitHub issue/PR 검색 → 현재 문제의 해결 사례 찾기
  • 에러 메시지 검색 → 구체적 수정 방안
  • 버전 릴리스 노트 → 마이그레이션 자동화

5. "도메인 제어"가 엔터프라이즈에게 결정적인 이유

Domain allow/block list는 기술적으로는 정규표현식 필터링 정도지만, 엔터프라이즈 도입에서는 결정적이다.

시나리오를 생각해보자. 대형 제약회사의 연구원이 Claude에게 "최근 약물 상호작용 연구 보여줘"라고 요청했다고 치자. 웹 검색이 아무 제한 없이 작동하면:

  • 의심스러운 건강 블로그에서 잘못된 정보를 가져올 수 있음
  • 경쟁사 사이트의 정보를 무분별하게 인용할 수 있음
  • 법적으로 인용해선 안 되는 저작권 자료를 참조할 수 있음
  • 내부 규정 위반 소스(4chan 같은 곳)에 접근할 수 있음

도메인 제어가 있으면 "PubMed, NEJM, FDA.gov 같은 신뢰 소스만 검색하세요" 를 조직 단위로 강제할 수 있다. 이게 있어야 Compliance팀이 LLM 도입을 승인한다.

2026년 현재 이 도메인 제어는 훨씬 정교해졌다.

  • Dynamic Filtering (2026년 2월): 도메인뿐만 아니라 콘텐츠 유형, 출처 신뢰도까지 필터링
  • Citation-first mode: 모든 결과에 출처 필수
  • Enterprise knowledge weighting: 내부 문서를 외부 검색보다 우선시

6. "기존 검색 트래픽이 무너진다"는 맥락

Top AI Tech 기사가 지적한 통찰이 흥미롭다 — "Apple의 Eddy Cue가 최근 Safari 검색이 22년 만에 처음으로 감소했다고 언급".

2025년 5월 시점 미국 웹 검색 시장은 AI 검색 서비스로의 대체가 본격화된 상태였다. Perplexity, ChatGPT Search, Claude (claude.ai), Gemini의 AI Overviews — 모두 합치면 사람들은 "검색 엔진"보다 "AI에게 물어보기" 를 점점 더 쓰고 있었다.

Anthropic API 웹 검색은 이 흐름에 대한 인프라 레이어 대응이다. 사용자가 Claude에게 "이번 주 뉴스 요약해줘"라고 말하면, Claude가 직접 검색해서 답한다. 그 과정에서 사용자는 Google에 가지 않는다.

이 변화가 SEO, 광고, 콘텐츠 제작 전 산업에 영향을 미쳤다. 2026년 현재 많은 브랜드가 "Google에 노출"보다 "Claude/ChatGPT/Perplexity에 인용" 을 더 중요한 지표로 추적한다. 새로운 분야 LLMO(Large Language Model Optimization) 가 뜨는 이유다.


마무리

이 5월 7일의 공지는 표면적으로 "API에 검색 도구 추가"지만, 그 안에 담긴 결정들이 크다.

  • Claude의 웹 검색을 개발자 경제로 확장 — 수수료 모델 확립
  • Claude Code에 웹 검색을 얹어 AI 코딩 워크플로 진화
  • 도메인 제어로 엔터프라이즈 도입 장벽 제거
  • 에이전트적 반복 검색을 API 수준에서 제공
  • 웹 검색 API 시장 경쟁에 Anthropic이 본격 참전

2026년 시점에서 이 API는 Claude 기반 수많은 에이전트의 기본 도구(primitive) 가 됐다. Research 기능, Cowork 에이전트, Skills의 web research 모듈, Claude Code의 모든 조사 작업이 이 웹 검색 도구 위에서 돌아간다. 한 API 추가가 2년간의 에이전트 제품군 전체를 떠받치는 기반이 된 예시다.

0개의 댓글