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.
Cómo funciona
Cuando incluyes el esquema de búsqueda web en tu lista de herramientas, Claude decidirá automáticamente cuándo buscar según tu pregunta. Por ejemplo, preguntar "¿Cuál es el mejor ejercicio para ganar músculo en las piernas?" podría activar una búsqueda de investigación actual sobre fitness.
La respuesta contiene varios tipos de bloques:
- TextBlock - 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
- CitationsWebSearchResultLocation - Citas de texto específicas que respaldan las afirmaciones de Claude
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 autorizadas:
web_search_schema = {
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5,
"allowed_domains": ["nih.gov"]
}Esto asegura que Claude solo busque en dominios confiables, como sitios gubernamentales de salud, en lugar de blogs de fitness aleatorios con información potencialmente poco confiable.
Renderizando resultados de búsqueda
La estructura de la respuesta está diseñada para una renderización de interfaz de usuario enriquecida. Normalmente:
- Muestras los bloques de texto como contenido regular
- Muestras los resultados de búsqueda web como una lista de referencias en la parte superior
- Renderizas las citas en línea con enlaces de vuelta al material de origen
- Resaltas el texto citado para mostrar cómo Claude respalda sus afirmaciones
Esto crea una experiencia transparente donde los usuarios pueden verificar las fuentes de Claude y entender cómo llegó a sus conclusiones. El sistema de citas ayuda a generar confianza al mostrar la evidencia detrás de las respuestas de Claude.