Nota importante: Tu organización debe habilitar la herramienta de búsqueda web en la consola de configuración antes de usarla. Puedes encontrar esta configuración aquí: https://platform.claude.com/settings/privacy(se abre en una pestaña nueva)
Claude incluye una herramienta de búsqueda web integrada que le permite buscar en internet información actual o especializada para responder preguntas de los usuarios. A diferencia de otras herramientas donde necesitas proporcionar la implementación, Claude maneja todo el proceso de búsqueda automáticamente: solo necesitas proporcionar un esquema simple para habilitarla.
Configurando la herramienta de búsqueda web
Para usar la herramienta de búsqueda web, creas un objeto de esquema con estos campos requeridos:
web_search_schema = {
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5
}El campo max_uses limita cuántas búsquedas puede realizar Claude. Claude podría hacer búsquedas de seguimiento basadas en los resultados iniciales, por lo que esto evita llamadas excesivas a la API. Una sola búsqueda devuelve múltiples resultados, pero Claude puede decidir que se necesitan búsquedas adicionales.
Cómo funciona la respuesta
Cuando Claude usa la herramienta de búsqueda web, la respuesta contiene varios tipos de bloques:
- Bloques de texto - La explicación de Claude sobre lo que está haciendo
- ServerToolUseBlock - Muestra la consulta de búsqueda exacta que usó Claude
- WebSearchToolResultBlock - Contiene los resultados de la búsqueda
- WebSearchResultBlock - Resultados de búsqueda individuales con títulos y URLs
- Bloques de citas - Texto que respalda las afirmaciones de Claude
La estructura de la respuesta te permite ver exactamente qué buscó Claude y qué fuentes encontró. Las citas incluyen el texto específico que Claude usó para respaldar sus respuestas, junto con las URLs de origen.
Restringiendo dominios de búsqueda
Puedes limitar las búsquedas a dominios específicos usando el campo allowed_domains. Esto es particularmente útil cuando quieres fuentes confiables y autorizadas:
web_search_schema = {
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5,
"allowed_domains": ["nih.gov"]
}Por ejemplo, al preguntar sobre consejos médicos o de ejercicio, restringir a dominios como PubMed (nih.gov) asegura que obtengas información basada en evidencia en lugar de contenido aleatorio de blogs.
Renderizando resultados de búsqueda
Los diferentes tipos de bloques en la respuesta están diseñados para una renderización específica en la interfaz de usuario:
- Renderiza los bloques de texto como contenido regular
- Muestra los resultados de búsqueda web como una lista de fuentes en la parte superior
- Muestra las citas en línea con el texto, incluyendo el dominio de origen, el título de la página, la URL y el texto citado
Esta estructura ayuda a los usuarios a entender cómo Claude llegó a sus respuestas y proporciona transparencia sobre las fuentes que se están usando. El formato de citas deja claro qué información específica proviene de qué fuentes, generando confianza en las respuestas de la IA.
Uso práctico
La herramienta de búsqueda web funciona mejor para:
- Eventos actuales y desarrollos recientes
- Información especializada que no está en los datos de entrenamiento de Claude
- Verificación de hechos y búsqueda de fuentes autorizadas
- Tareas de investigación que requieren información actualizada
Simplemente incluye el esquema en tu arreglo de herramientas al hacer llamadas a la API, y Claude decidirá automáticamente cuándo una búsqueda web ayudaría a responder la pregunta del usuario.