Cómo activar la web search tool de Claude

Muchas veces la herramienta que necesitas ya está construida y solo toca conectarla. La web search de Claude es el ejemplo perfecto: Anthropic ya dejó lista la búsqueda en Internet, así que tú no la programas, la activas. Esta guía es para quienes construyen agentes con la Claude API y quieren dejar de fabricar todo desde cero.

¿Por qué usar una herramienta lista en vez de fabricarla?

Para buscar en la web de verdad, alguien tiene que mandar una consulta a un motor de búsqueda, traer los resultados y filtrarlos. Todo eso ya existe y ya funciona. Anthropic lo empaquetó para que solo le digas a Claude: tienes esta herramienta disponible, y la conexión queda hecha [00:20].

Y aquí viene lo interesante: se siente muy distinto usar una herramienta lista frente a construir una. En la clase anterior habíamos definido una Weather Tool con una función get_weather que tenía información hardcodeada. La temperatura siempre era 18 grados sin importar la ciudad, y siempre había lluvia ligera, porque la pregunta era si necesitábamos paraguas hoy en Bogotá [00:52].

Toda esa estructura era compleja para lo que hacía, y peor aún con datos fijos. Al usar una tool que provee Claude, nada de eso hace falta.

¿Qué significa hardcodear datos? Es escribir información fija directamente en el código, como poner siempre 18 grados. El problema es que nunca refleja la realidad: responde lo mismo aunque cambie la ciudad o el clima.

¿Cómo se activa la web search tool en el código?

El cambio parte por eliminar la función de clima y su data fija. Ya no la necesitas [01:20]. El bloque print, que muestra la respuesta en la terminal, se ajusta para unir el texto que venga de cada bloque del response content, pero solo cuando el tipo de bloque es igual a text [01:30].

Luego defines la estructura dentro de tools, un objeto con dos campos:

• El tipo, que es web-search-2025-0305, el ID que entrega Claude.
• El nombre, que es web-search.
• Todo lo demás queda igual, incluyendo la pregunta y los tokens máximos.

Con esto también puedes limpiar lo que ya no usas. Se van el JSON y el callable, y te quedas solo con OS y anthropic [02:00]. Menos piezas, mismo resultado.

¿Qué es una tool en la Claude API? Es una capacidad externa que Claude puede invocar, como buscar en Internet. Le pasas su definición y el modelo decide cuándo usarla para responder mejor.

¿Qué respuesta devuelve cuando busca en Internet real?

Al ejecutar el código en la terminal, la respuesta llega un poco más lenta. Y tiene sentido: ya no lee un dato fijo del archivo, sino que se conecta al web search, busca en Internet, trae resultados y los junta con su prompt [02:30].

El resultado fue concreto. Para el jueves 11 de junio, el pronóstico de IDIGER en Bogotá reportó temperaturas entre 7 y 19 grados centígrados, con lluvia dispersa cercana y humedad de 71 [02:50]. El consejo final: en el sur de Bogotá el paraguas es casi obligatorio, y en el resto de la ciudad mejor llevarlo por precaución, con opción de monitorear el mapa de lluvias en tiempo real.

La respuesta salió larga por la cantidad de tokens asignados, pero deja algo claro: ya no depende solo de la información que teníamos en la tool anterior.

¿Dónde encuentro la documentación de las herramientas de Anthropic?

La web search tool tiene una página propia en la documentación de la Claude API [03:15]. Ahí encuentras cómo usarla y varios detalles prácticos:

• Los parámetros que puedes pasarle.
• La estructura para llamarla en distintos lenguajes.
• La máxima cantidad de usos permitidos.
• La localización, por si quieres sectorizar un resultado.

Después de revisar esto, vale saber que la web search no es la única. Anthropic ofrece un listado de otras tools por defecto que puedes pasarle a tus agentes, y ambos enlaces quedan en la sección de recursos.

Esa es la otra mitad del oficio: a veces fabricas la herramienta y a veces solo la conectas. Saber cuándo toca cada cosa te ahorra un montón de trabajo.

¿Qué pasa cuando una sola búsqueda no alcanza?

Aquí aparece el límite actual. ¿Qué haces cuando el primer resultado no responde del todo y haría falta buscar otra vez o usar otra herramienta antes de contestar bien? Por ahora, el agente no sabe hacerlo: queda atascado en un solo paso [04:00].

Quitarle ese límite, dejar que use lo que necesite las veces que haga falta hasta dar con la respuesta, es lo que cambia todo. ¿Ya probaste conectar la web search a tu propio agente? Cuéntame en los comentarios cómo te fue con la primera búsqueda real.