Búsqueda web en agentes de IA de n8n con la API SERP de SerpCrypto

¿Por qué el nodo HTTP Request y no un nodo personalizado?

La documentación de n8n indica que el nodo HTTP Request puede ejecutarse como un nodo normal o adjuntarse a un AI Agent para usarse como herramienta. Eso cubre una API REST como SerpCrypto, que acepta una petición GET con un header y unos pocos query parameters. No hay ningún nodo de la comunidad nuestro que instalar ni mantener actualizado, y la credencial se queda en el almacén de credenciales cifradas de n8n.

El nodo AI Agent necesita un chat model y al menos un subnodo de herramienta. Desde n8n 1.82.0, todos los AI Agent funcionan como Tools Agent, así que el agente decide por sí mismo cuándo llamar a la herramienta de búsqueda.

¿Cómo guardo la clave API?

Crea una credencial Header Auth. La documentación de credenciales de n8n describe dos campos, el Name del header y su Value, y señala que un token bearer es header auth con el nombre Authorization y el valor Bearer <token>. Pon Authorization en Name y Bearer más tu clave de SerpCrypto en Value.

n8n también incluye un tipo genérico Bearer auth; cualquiera de los dos envía el mismo header. Dale a n8n su propia clave API, así ves su consumo aparte de tus otros scripts y puedes revocarla por sí sola si hace falta. Claves API que puedes crear y revocar en cualquier momento desde tu dashboard.

¿Cómo rellena el modelo la consulta de búsqueda?

Deja que el modelo defina q. Junto a un campo de parámetro apto, n8n muestra un botón de estrella que pasa el valor al modelo. También puedes escribir tú mismo la expresión $fromAI(), que toma una clave, una descripción, un tipo y un valor por defecto; la descripción le dice al modelo qué poner ahí. n8n documenta que $fromAI() solo funciona con herramientas conectadas al nodo AI Agent.

Mantén gl y hl fijos si tu agente sirve a un solo mercado. Deja que el modelo también los defina si los usuarios preguntan por distintos países, y describe los códigos esperados, como gb o de.

{{ $fromAI("query", "The search query, as a person would type it", "string") }}

¿Por qué activar Optimize Response?

Una página de resultados completa en JSON es larga, y todo lo que devuelve la herramienta va al contexto del modelo. Optimize Response es una opción exclusiva de herramientas del nodo HTTP Request que recorta los datos pasados al modelo; n8n señala que puede reducir costes. Con el tipo de respuesta JSON, pon Field Containing Data en organic_results y selecciona solo title, link y snippet.

Así el agente lee unas diez entradas cortas por búsqueda en lugar de todos los bloques de la página. Si tu agente responde preguntas locales, apunta Field Containing Data a local_results en una segunda herramienta.

¿Cómo uso la misma API en un flujo de trabajo normal?

Sin el agente, usa el nodo HTTP Request como nodo normal con un q fijo, por ejemplo en un flujo de trabajo con Schedule Trigger que revise una palabra clave cada mañana. Luego añade un nodo Split Out con Field to Split Out en organic_results: convierte la lista en un elemento por resultado, listo para una hoja de cálculo o un nodo de base de datos.

Cada ejecución es una búsqueda por palabra clave, así que 50 palabras clave al día usan unos 1.500 créditos al mes. El pack de 25.000 búsquedas (18,75 US$) lo cubre más de diez veces, y Los créditos de búsqueda prepagados no caducan nunca: las consultas sin usar se quedan en tu cuenta hasta que las uses.

¿Cómo pruebo la petición fuera de n8n?

Ejecuta la misma petición en una terminal. Si funciona ahí, cualquier problema en n8n viene de la configuración del nodo; si falla, el cuerpo del error indica la causa, como se lista en la página de errores. Los errores nunca se cobran.

# The request the HTTP Request node sends, for a test in a terminal
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=n8n self-hosted vs cloud" -d gl=us -d hl=en \
  | jq '.organic_results[]? | {title, link, snippet}'