Anthropic이 Claude AI 모델을 위한 웹 검색 API를 출시했습니다. 이번 발표는 AI 모델의 ‘지식 단절(knowledge cutoff)’ 문제를 해결하는 중요한 진전으로, 개발자들이 Claude의 기존 지식 기반에 최신 웹 정보를 결합할 수 있게 해줍니다.
어떻게 작동하는가?
Anthropic의 웹 검색 API는 간단하면서도 강력한 방식으로 작동합니다:
- 개발자가 Messages API에 요청을 보낼 때 웹 검색 도구를 활성화합니다.
- Claude는 사용자 질문이 최신 정보나 전문 지식을 필요로 하는지 자체적으로 판단합니다.
- 필요한 경우, Claude는 검색 쿼리를 생성하고 관련 결과를 검색합니다.
- 검색된 정보를 분석하여 출처 인용과 함께 포괄적인 답변을 제공합니다.
특히 주목할 점은 Claude가 복수의 연속 검색을 수행할 수 있다는 것입니다. 이전 검색 결과를 바탕으로 후속 쿼리를 정교화하는 ‘에이전트’ 방식의 정보 수집이 가능해진 것입니다. 개발자는 max_uses 매개변수를 조정하여 이 기능을 제어할 수 있습니다.
지난 몇 년간 AI 모델의 가장 큰 한계 중 하나는 학습 데이터 이후의 최신 정보에 접근하지 못한다는 점이었습니다. 이제 웹 검색 API를 통해 Claude는 실시간에 가까운 정보를 활용하여 보다 정확하고 시의적절한 응답을 제공할 수 있게 되었습니다.
Anthropic의 웹 검색 API 관리 화면 (출처: Anthropic)
개발자를 위한 Claude 웹 검색 API 사용법
Claude 웹 검색 API를 실제로 활용하기 위한 기본적인 단계를 알아보겠습니다.
지원 모델
현재 웹 검색 기능은 다음 모델에서 사용 가능합니다:
- Claude 3.7 Sonnet (
claude-3-7-sonnet-20250219또는claude-3-7-sonnet-latest) - 업그레이드된 Claude 3.5 Sonnet (
claude-3-5-sonnet-latest) - Claude 3.5 Haiku (
claude-3-5-haiku-latest)
API 요청 구조
웹 검색 API를 사용하기 위해서는 Messages API 요청의 tools 배열에 웹 검색 도구를 포함시켜야 합니다. 기본적인 curl 요청 예시는 다음과 같습니다:
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data '{
"model": "claude-3.5-sonnet-latest",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "양자 컴퓨팅의 최신 발전 동향을 알려줘"
}
],
"tools": [{
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5
}]
}'
주요 매개변수
웹 검색 도구는 다음과 같은 선택적 매개변수를 제공합니다:
max_uses(정수, 선택 사항):- 단일 API 요청 내에서 Claude가 수행할 수 있는 검색 작업 수를 제한합니다.
- 검색의 깊이와 잠재적 비용을 관리하는 데 유용합니다.
allowed_domains(문자열 배열, 선택 사항):- Claude가 검색 결과를 검색할 수 있는 허용된 도메인 목록을 지정합니다.
- 예:
["example.com", "trusteddomain.org"] - HTTP/HTTPS 스킴은 포함하지 않습니다(예:
example.com사용,https://example.com사용 안 함).
blocked_domains(문자열 배열, 선택 사항):- Claude가 절대 접근해서는 안 되는 도메인 목록을 지정합니다.
allowed_domains와 동시에 사용할 수 없습니다.
user_location(객체, 선택 사항):- 사용자의 지리적 컨텍스트에 맞게 검색 결과를 현지화합니다.
- 구조 예시:
"user_location": { "type": "approximate", "city": "서울", "region": "서울특별시", "country": "KR", "timezone": "Asia/Seoul"}
Claude 웹 검색 API 요청 예시 (출처: Apidog 블로그)
응답 처리
Claude가 웹 검색 도구를 사용할 때, API 응답에는 검색 프로세스와 결과를 세부적으로 설명하는 특정 블록이 포함됩니다:
- Claude의 검색 결정 (type: “text”): Claude가 검색하려는 의도를 나타내는 간단한 텍스트
- 서버 도구 사용 블록 (type: “server_tool_use”):
- Claude가 서버 측 도구(웹 검색 등)를 사용하기로 결정했음을 알리는 블록
id, 도구의name(“web_search”), 실제 검색 쿼리를 포함하는input객체가 포함됨
- 웹 검색 도구 결과 블록 (type: “web_search_tool_result”):
- 검색 결과를 포함하는 블록
- 성공적인 검색의 경우
web_search_result객체 배열을 포함 - 각 결과 객체에는
url,title,encrypted_content,page_age등의 정보가 포함됨
- Claude의 합성 응답 (type: “text” with citations):
- 검색 결과를 통합한 Claude의 텍스트 답변
- 인용된 부분은
citations객체를 통해 출처 정보 제공
비용 관리
웹 검색 사용량은 토큰 사용량과 별도로 청구됩니다. 1,000회 검색당 $10의 비용이 발생하며, 각 웹 검색 호출은 반환되는 결과 수에 관계없이 하나의 사용으로 계산됩니다. 검색 중 오류가 발생하면 일반적으로 비용이 청구되지 않습니다.
활용 사례: 산업별 적용 가능성
웹 검색 API의 출시로 다양한 산업 분야에서 새로운 AI 솔루션 개발이 가능해졌습니다:
- 금융 서비스: 실시간 주가, 시장 동향, 규제 업데이트를 분석하는 AI 에이전트
- 법률 연구: 최신 법원 판결, 규제 변경, 법률 뉴스에 접근하는 도구
- 개발자 도구: 최신 API 문서, GitHub 릴리스, 기술 업데이트 참조 기능
- 생산성 도구: 최신 회사 보고서, 경쟁사 정보, 산업 연구를 통합하는 에이전트
Quora의 AI 플랫폼 Poe는 이미 이 기능을 도입했으며, Poe의 제품 책임자 Spencer Chan은 “Anthropic의 웹 검색 도구는 비용 효율적이고 인상적인 속도로 검색 결과를 제공한다”고 평가했습니다.
관리와 통제: 기업을 위한 보안 기능
모든 웹 기반 응답에는 출처 인용이 포함되어 사용자가 정보를 직접 확인할 수 있으며, 이는 정확성과 책임성이 요구되는 민감한 사용 사례에 특히 중요합니다.
조직은 다음과 같은 관리 설정을 통해 추가적인 통제 기능을 유지할 수 있습니다:
- 도메인 허용 목록: Claude가 검색하고 정보를 검색할 수 있는 승인된 도메인을 지정
- 도메인 차단 목록: 민감하거나 부적절한 콘텐츠가 포함된 특정 도메인에 대한 접근 차단
- 조직 수준 관리: 관리자가 조직 수준에서 웹 검색 사용을 허용하거나 금지
경쟁 구도 분석: 가격과 성능
Anthropic의 웹 검색 API는 1,000회 검색당 $10(기본 토큰 비용 별도)의 가격으로 제공됩니다. 이는 경쟁 서비스와 비교했을 때 어떤 위치에 있을까요?
- Brave Search API: 1,000회 검색당 $3~$9(사용 방식에 따라 다름)
- Google Gemini: 하루 1,500회까지 무료, 이후 1,000회 요청당 $35
- OpenAI(ChatGPT): 자세한 검색 API 가격 정보는 공개되지 않았으나, 웹 통합 서비스 제공 중
Simon Willison의 블로그에 따르면, Anthropic의 웹 검색은 Brave 검색 엔진을 기반으로 하는 것으로 추정되며, 검색 결과 형식은 Anthropic Citations API와 유사합니다.
업계 의미와 전망
Anthropic의 웹 검색 API 출시는 AI 모델의 정보 접근성을 향상시키는 중요한 진전입니다. 이는 단순히 기능 추가를 넘어 AI의 활용 범위와 신뢰성을 확장하는 의미를 갖습니다.
특히 주목할 점은 다음과 같습니다:
- 정보 최신성의 중요성 증가: 실시간 정보 접근은 AI 플랫폼 선택의 핵심 기준이 되고 있습니다.
- 에이전트 기반 AI의 부상: 단순 응답을 넘어 복수의 검색을 통해 심층 연구를 수행하는 AI 에이전트 개발이 가속화될 것입니다.
- 통제와 신뢰의 균형: 도메인 관리 기능은 정보 정확성과 보안 사이의 균형을 맞추는 중요한 요소입니다.
- 개발자 생태계 확장: 웹 검색 API는 Claude를 기반으로 한 새로운 애플리케이션 개발을 촉진할 것입니다.
마치며
Anthropic의 웹 검색 API 출시는 AI 시장의 경쟁 구도를 변화시키는 중요한 전환점이 될 수 있습니다. 실시간 정보에 대한 접근성이 AI 모델의 성능과 유용성을 결정하는 핵심 요소로 부상하면서, 이러한 기능 경쟁은 더욱 치열해질 전망입니다.
현재 이 API는 Claude 3.7 Sonnet, Claude 3.5 Sonnet, Claude 3.5 Haiku 모델에서 사용 가능하며, 개발자들은 이를 통해 최신 정보를 활용한 다양한 AI 솔루션을 구축할 수 있게 되었습니다.
결국 웹 검색 API의 출시는 단순한 기술적 진전을 넘어, AI가 더욱 신뢰할 수 있고 유용한 도구로 발전하는 과정의 중요한 이정표로 기록될 것입니다.
Comments