Serp Search API

El Serp Search API te permite buscar información en la web directamente desde tu panel de Nappai. Con una sola entrada puedes enviar una consulta y recibir los resultados más relevantes, listados con sus títulos y fragmentos de texto. Es ideal para generar datos de referencia, actualizar dashboards con noticias recientes o alimentar procesos de IA con información actualizada.

¿Cómo funciona?

El componente utiliza la librería SerpAPIWrapper de LangChain para comunicarse con el servicio externo SerpAPI. Cuando ejecutas el componente:

1. Se construye un wrapper con tu clave API (obtenida de la credencial SerpApi) y, opcionalmente, parámetros adicionales que refinen la búsqueda (por ejemplo, idioma, país, número de resultados).
2. Se envía la consulta (input_value) al endpoint de SerpAPI.
3. Se reciben los resultados en formato JSON. El componente extrae la lista de resultados orgánicos (organic_results).
4. Se devuelve una lista de objetos Data donde cada elemento contiene la información completa del resultado y su fragmento de texto (snippet).
   Además, el método build_tool crea una herramienta (Tool) que puede ser utilizada por otros componentes o flujos de trabajo de IA.

Entradas

Campos de Entrada

• Input:
  Es el texto de búsqueda que quieres enviar a SerpAPI. Puedes escribir una frase, una pregunta o cualquier término que te interese.
• Parameters:
  Un diccionario de parámetros opcionales que permiten afinar la búsqueda. Por ejemplo, puedes especificar el idioma (hl), el país (gl), el número máximo de resultados (num) o filtros de contenido. Si no necesitas ajustes, deja este campo vacío.

Credencial
Este componente necesita una credencial de tipo SerpApi.

1. Ve a la sección de credenciales de Nappai y configura una nueva credencial llamada SerpApi.
2. Introduce tu API Key que puedes encontrar en la página de gestión de claves de SerpAPI.
3. En el componente, selecciona la credencial recién creada en el campo Credential.

Salidas

• Data:
  Una lista de objetos Data que contienen cada resultado de búsqueda. Cada objeto incluye la información completa del resultado y su fragmento de texto (snippet). Puedes usar estos datos para mostrarlos en tu dashboard, procesarlos con IA o guardarlos en tu base de datos.
• Tool:
  Una herramienta (Tool) que encapsula la función de búsqueda. Puede ser invocada por otros componentes o flujos de trabajo de IA para realizar búsquedas dinámicas dentro de procesos automatizados.

Ejemplo de Uso

1. Configura la credencial SerpApi con tu API Key.
2. Añade el componente Serp Search API al flujo.
3. En el campo Input, escribe:

   Últimas noticias sobre inteligencia artificial

4. En Parameters, opcionalmente añade:

   {
     "hl": "es",
     "gl": "es",
     "num": 5
   }

5. Ejecuta el flujo.
6. El componente devolverá una lista de los 5 resultados más relevantes en español, con sus títulos y fragmentos de texto, que puedes mostrar en un widget de noticias o procesar con un modelo de lenguaje.

Componentes Relacionados

• Google Search API – Busca en Google con parámetros más específicos.
• Web Scraper – Extrae contenido de páginas web después de una búsqueda.
• Data Parser – Analiza y limpia los datos obtenidos para su uso posterior.

Consejos y Mejores Prácticas

• Define consultas claras: Cuanto más específica sea la búsqueda, más relevantes serán los resultados.
• Limita el número de resultados: Usa el parámetro num para evitar sobrecargar tu flujo con demasiada información.
• Revisa los parámetros: Ajusta hl y gl para obtener resultados en el idioma y país deseados.
• Maneja la cuota: SerpAPI tiene límites de uso; revisa tu plan y controla la frecuencia de llamadas.

Consideraciones de Seguridad

• Protege tu API Key: Nunca la expongas en código público. Utiliza la gestión de credenciales de Nappai.
• Control de acceso: Limita quién puede editar la credencial y el componente en tu organización.
• Registra las llamadas: Si tu plan lo permite, habilita el registro de consultas para auditoría y depuración.