Cómo hacer que Claude busque en internet

Abre un chat en claude.ai, pulsa el botón + de la esquina inferior izquierda de la caja de texto y elige la opción de búsqueda web (Web search). Aparece una marca de verificación cuando está activa; vuelve a pulsarla para apagarla. Se activa chat a chat. Si tu cuenta ya tiene la nueva experiencia de Claude, no verás ese interruptor: Claude busca en internet solo cuando le sirve para responder. En los planes Team y Enterprise, antes tiene que activarla para toda la organización un propietario, en la configuración de la organización, apartado de capacidades.

Con la búsqueda activa, Claude busca cuando la pregunta necesita información actual: noticias, precios, versiones o cualquier cosa que pueda haber cambiado. Si quieres asegurarte, díselo: empieza con busca en internet. Cada respuesta trae citas con enlaces a las páginas de donde sale cada dato, y puede mostrar imágenes de los resultados con su fuente. También puedes pegarle una dirección concreta para que lea esa página. Antes de usar un dato importante, abre la cita y compruébalo.

Busca en internet las novedades de la última
versión de Python y resúmelas en 5 puntos,
cada uno con su fuente.

Lee esta página y dime qué cambia para
un usuario de España:
https://ejemplo.com/noticia

Buscar y leer páginas cuenta para tu límite de uso. En la cuenta gratuita el límite se renueva cada cinco horas, y leer un artículo largo a partir de su enlace puede gastar buena parte. Si una conversación no necesita datos actuales, por ejemplo para redactar o resumir un texto que ya le has pegado, apaga la búsqueda. Ten en cuenta también que, para resultados locales, Claude puede usar la ubicación que deduce de tu conexión.

Si estás construyendo tu propia aplicación, la búsqueda se activa pasando la herramienta web_search en la petición. Necesitas el SDK de Anthropic y una clave de API de la consola, guardada en la variable de entorno ANTHROPIC_API_KEY y nunca dentro del código. Con la herramienta incluida, Claude decide cuándo buscar, la API ejecuta las búsquedas y la respuesta llega ya redactada y con citas. Con max_uses fijas cuántas búsquedas puede hacer como máximo en cada petición. La búsqueda web viene activada en la organización salvo que un administrador la haya desactivado en la consola.

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # lee ANTHROPIC_API_KEY del entorno

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    tools=[{
        "type": "web_search_20250305",
        "name": "web_search",
        "max_uses": 3,
    }],
    messages=[{
        "role": "user",
        "content": "¿Cuál es la última versión estable de Python?",
    }],
)

for block in response.content:
    if block.type == "text":
        print(block.text)

La respuesta no es solo texto. Trae un bloque server_tool_use con la búsqueda que hizo Claude, un bloque web_search_tool_result con los resultados (dirección, título y antigüedad de la página) y bloques de texto con citas, cada una con la dirección, el título y hasta 150 caracteres del texto citado. Si muestras la respuesta a tus usuarios, la documentación de Anthropic pide incluir esas citas a la fuente original. Para seguir la conversación en otro turno, devuelve los bloques tal como llegaron, incluido el contenido cifrado de cada resultado.

for block in response.content:
    es_resultado = block.type == "web_search_tool_result"
    if es_resultado and isinstance(block.content, list):
        for result in block.content:
            print("Resultado:", result.title, result.url)
    elif block.type == "text":
        print(block.text)
        for cita in block.citations or []:
            print("  Fuente:", cita.title, cita.url)

Para que busque solo en fuentes de confianza, como la documentación oficial o tu propia web, usa allowed_domains; para excluir sitios, blocked_domains. Los dominios van sin https, y se puede añadir una ruta, como ejemplo.com/blog. Con user_location orientas los resultados a un país, una región, una ciudad o una zona horaria, algo útil si quieres fuentes de España o de un país concreto de Latinoamérica. El país va con su código de dos letras.

tool = {
    "type": "web_search_20250305",
    "name": "web_search",
    "max_uses": 3,
    "allowed_domains": ["docs.python.org", "python.org"],
    "user_location": {
        "type": "approximate",
        "country": "ES",
        "timezone": "Europe/Madrid",
    },
}

Cada búsqueda cuesta 10 dólares por cada 1.000, además de los tokens: los resultados que trae entran como tokens de entrada. Cuántas búsquedas hizo una petición está en usage, dentro de server_tool_use. Un error de búsqueda no tumba la petición: la API responde bien y el error llega dentro del resultado con un código, como max_uses_exceeded o too_many_requests, y esa búsqueda no se cobra. Una búsqueda que funciona pero no encuentra nada devuelve una lista vacía, no un error.

uso = response.usage.server_tool_use
print("Búsquedas:", uso.web_search_requests)

for block in response.content:
    es_resultado = block.type == "web_search_tool_result"
    if es_resultado and not isinstance(block.content, list):
        print("Error en la búsqueda:", block.content.error_code)