Google Serper API

El componente Google Serper API permite a los usuarios buscar información en Google directamente desde el dashboard de Nappai. Al introducir una consulta, el componente devuelve los resultados más relevantes en forma de objetos de datos que pueden ser usados en otras partes del flujo de trabajo o mostrados al usuario.

¿Cómo funciona?

El componente se conecta al servicio Serper.dev mediante la librería GoogleSerperAPIWrapper.

1. El usuario escribe una consulta en el campo Input.
2. Se indica cuántos resultados desea obtener con el campo Number of results.
3. El componente envía la consulta a la API de Serper usando la clave API que el usuario ha configurado previamente como credencial de tipo Google Serper Api.
4. La API devuelve una lista de resultados orgánicos.
5. Cada resultado se transforma en un objeto Data que contiene la información completa del resultado y su fragmento (snippet).
6. El componente devuelve dos salidas:
   • Data – la lista de resultados que puede ser procesada o visualizada.
   • Tool – una herramienta que puede ser llamada por un modelo de lenguaje para realizar búsquedas dinámicas dentro de un flujo de trabajo.

Entradas

Credencial

Antes de usar el componente, debes:

1. Ir a la sección de Credenciales de Nappai y crear una credencial de tipo Google Serper Api.
2. Ingresar la API Key que obtuviste en https://serper.dev/.
3. En el componente, seleccionar esa credencial en el campo Credential.

Campos de Entrada

Campo	Descripción
Input	Escribe la consulta que quieres buscar en Google. Puedes usar texto libre, frases o palabras clave.
Number of results	Indica cuántos resultados quieres recibir. El valor por defecto es 4, pero puedes ajustarlo según tus necesidades.

Nota: Los campos relacionados con la credencial (API Key, etc.) no aparecen aquí porque ya están configurados en la sección de credenciales.

Salidas

Salida	Tipo	Descripción
Data	Data	Lista de objetos que contienen cada resultado de búsqueda y su fragmento de texto.
Tool	Tool	Herramienta que permite ejecutar búsquedas de Google desde un modelo de lenguaje dentro del flujo de trabajo.

Ejemplo de Uso

1. Configura la credencial:
   • Ve a Credenciales → Agregar credencial → Selecciona Google Serper Api → Ingresa tu API Key.
2. Añade el componente al flujo de trabajo.
3. Selecciona la credencial creada en el campo Credential.
4. Introduce la consulta:
   • Input: Nappai automation features
5. Define el número de resultados:
   • Number of results: 3
6. Ejecuta el flujo.
7. Revisa la salida:
   • En la pestaña Data verás tres resultados con sus títulos, URLs y fragmentos.
   • En la pestaña Tool puedes usar la herramienta google_search dentro de un modelo de lenguaje para obtener resultados dinámicos.

Componentes Relacionados

• Google Serper API – Este mismo componente, útil para búsquedas rápidas.
• Tool – Permite integrar la búsqueda con modelos de lenguaje dentro de Nappai.

Consejos y Mejores Prácticas

• Mantén la clave API segura: No la compartas en dashboards públicos.
• Limita el número de resultados: Un valor alto puede consumir tu cuota gratuita rápidamente.
• Usa consultas claras: Cuanto más específica sea la consulta, mejores serán los resultados.
• Combina con filtros: Si necesitas resultados de un dominio específico, añade site:nappai.com a la consulta.

Consideraciones de Seguridad

• La clave API se almacena de forma cifrada en Nappai; no aparece en la interfaz de usuario.
• Evita exponer la credencial en flujos de trabajo compartidos.
• Revisa los límites de uso de la API de Serper para evitar bloqueos inesperados.