Saltearse al contenido
Nappai Documentation

Serp Search API

Serp Search API hace búsquedas en Google mediante el servicio SerpApi y te devuelve los resultados: el título, el enlace y el fragmento de texto de cada página encontrada. Sirve para que un flujo o un agente trabaje con información actual de internet.

Puedes usarlo de dos maneras. Como paso de un flujo, escribes la búsqueda en Input y recibes los resultados en la salida Data. Como herramienta, conectas su salida Tool al conector Tools de un agente: el agente decide cuándo buscar y qué escribir en la búsqueda.

Cuándo usarlo

  • Un agente de atención al cliente necesita consultar información pública reciente, como horarios o noticias de un proveedor.
  • Quieres vigilar qué aparece en Google sobre tu marca o un producto.
  • Preparas informes de mercado y necesitas reunir enlaces y resúmenes de varias páginas.
  • Quieres dar a un agente acceso a internet sin que tenga que navegar por las páginas.

Configuración

Necesitas una credencial SerpApi con la clave de tu cuenta de SerpApi. Elígela en el campo de credencial del componente. Consulta Credenciales.

CampoQué hace
SerpAPI API Key (obligatorio)La clave de tu cuenta de SerpApi.
InputLo que quieres buscar, por ejemplo horario oficinas Correos Madrid. Cuando el componente se usa como herramienta, la búsqueda la escribe el agente.

Opciones avanzadas

CampoQué hace
ParametersParámetros adicionales de la búsqueda que admite SerpApi, como pares nombre y valor. Por ejemplo, hl con valor es para pedir resultados en español o gl con valor es para resultados de España. Déjalo vacío si no los necesitas.

Resultado

  • Data: una lista con un elemento por cada resultado de Google. Cada elemento incluye, entre otros datos, el título, el enlace y el fragmento de texto de la página. Puedes conectarlo a componentes que formatean texto, filtran datos o a un agente que los resuma.
  • Tool: la búsqueda lista para que un agente la use. Conéctala al conector Tools del agente. El agente recibe los resultados como texto.

Ejemplo

Una agencia de viajes quiere que su asistente responda dudas sobre eventos en las ciudades de destino.

  1. Añade Serp Search API y elige la credencial SerpApi de la agencia.
  2. En Parameters, añade hl con valor es.
  3. Conecta la salida Tool al conector Tools del agente.
  4. Cuando un cliente pregunta “¿Hay conciertos en Sevilla este fin de semana?”, el agente busca en Google y responde con lo que encuentra.

Buenas prácticas

  • SerpApi cobra por búsqueda en tu cuenta. Si el agente busca demasiado, indícale en sus instrucciones cuándo debe usar la búsqueda.
  • Pide al agente que cite el enlace de donde sacó la información para que el usuario pueda comprobarla.

Componentes relacionados