Recherche web avec Claude

Cette page explique comment permettre à Claude d’effectuer des recherches sur le web avec l’outil web_search. Les ID de modèle, les adresses d’endpoint et les fournisseurs sont décrits dans la présentation de la famille Claude.

L'essentielLa recherche web nécessite de sélectionner le fournisseur Anthropic ; elle est limitée à Fable 5, Opus 4.8, Opus 4.7 et Sonnet 5, et uniquement via l’API native Anthropic.

Ajoutez l’outil côté serveur officiel web_search dans tools : le modèle lance lui-même les recherches et cite ses sources dans la réponse.

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": "Quelle est la dernière version stable de Python ?"}],
)
print("".join(b.text for b in message.content if b.type == "text"))
print("Nombre de recherches :", message.usage.server_tool_use.web_search_requests)

Le content de la réponse contient successivement des blocs server_tool_use (mots-clés de recherche), web_search_tool_result (résultats de recherche) et text (réponse).
usage.server_tool_use.web_search_requests indique le nombre réel de recherches ; les recherches sont facturées à l’unité, au prix indiqué sur la page du modèle .
max_uses limite le nombre maximal de recherches par requête.

Les autres erreurs sont décrites dans Erreurs courantes.

Recherche web avec Claude

Python

cURL