Busca na web do Claude

Esta página explica como fazer o Claude buscar na web com a ferramenta web_search. IDs de modelo, endereços de endpoint e informações sobre provedores estão na visão geral da família Claude.

ResumoA busca na web exige indicar o provedor Anthropic, funciona apenas com Fable 5, Opus 4.8, Opus 4.7 e Sonnet 5 e só é suportada no endpoint nativo da Anthropic.

Adicione a ferramenta de servidor oficial web_search em tools; o modelo faz as buscas por conta própria e cita as fontes na resposta:

Python

claude_web_search.py


import os
import anthropic
 
client = anthropic.Anthropic(
    base_url="https://api.ofox.io/anthropic",
    api_key=os.environ["OFOX_API_KEY"],
    default_headers={"X-OfoxAI-Provider-Type": "anthropic"},
)
 
message = client.messages.create(
    model="anthropic/claude-sonnet-5",
    max_tokens=1500,
    tools=[{"type": "web_search_20250305", "name": "web_search", "max_uses": 3}],
    messages=[{"role": "user", "content": "Qual é a versão estável mais recente do Python?"}],
)
print("".join(b.text for b in message.content if b.type == "text"))
print("Buscas:", message.usage.server_tool_use.web_search_requests)

No content da resposta aparecem, nesta ordem, os blocos server_tool_use (termos de busca), web_search_tool_result (resultados da busca) e text (resposta).
usage.server_tool_use.web_search_requests é o número real de buscas. As buscas são cobradas por uso; o preço unitário está na página do modelo .
max_uses limita o número máximo de buscas por requisição.

Outros erros estão em Erros comuns.

Busca na web do Claude

Python

cURL