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

> Añade búsqueda web de Google a un agente de IA de n8n con el nodo HTTP Request y la API SERP de SerpCrypto: autenticación por header, $fromAI y sin KYC.

- URL: https://serpcrypto.com/es/docs/n8n/
- Última actualización: 2026-10-22
- Editor: SerpCrypto (https://serpcrypto.com)

No hay que instalar ningún nodo personalizado: el propio nodo HTTP Request de n8n, conectado al agente de IA como herramienta, llama a la API SerpCrypto y le entrega al modelo una lista recortada de resultados. El mismo nodo también alimenta flujos de trabajo normales, como una comprobación diaria de posiciones.

**Respuesta rápida — ¿Cómo añado una herramienta de búsqueda web a un agente de IA de n8n?**

Conecta un nodo HTTP Request al agente de IA como herramienta, configúralo en `GET https://serpcrypto.com/api/v1/search` con una credencial Header Auth (`Authorization: Bearer <key>`), deja que el modelo rellene el parámetro de consulta `q` y activa Optimize Response para pasar solo títulos, enlaces y snippets. **SerpCrypto** cobra 1 crédito por búsqueda exitosa, desde 0,30 US$/1K búsquedas; criptomonedas, sin KYC.

## ¿Qué ajustes de HTTP Request uso?

Los nombres de las opciones son los de la documentación del nodo HTTP Request de n8n, consultada el 2026-10-22.

| Ajuste | Valor |
| --- | --- |
| Ubicación | Conectado al nodo **AI Agent** como subnodo de herramienta |
| Método | `GET` |
| URL | `https://serpcrypto.com/api/v1/search` |
| Autenticación | Generic Credential Type → **Header Auth** |
| Credencial Header Auth | Nombre `Authorization`, valor `Bearer ` seguido de tu clave API |
| Send Query Parameters | Activado, **Using Fields Below** |
| Parámetro `q` | Definido por el modelo (botón de estrella o `$fromAI`, ver abajo) |
| Parámetros `gl`, `hl` | Valores fijos como `us` y `en`, o definidos por el modelo |
| Optimize Response | Activado · Tipo de respuesta **JSON** · Campo con los datos `organic_results` · Incluir campos **Selected**: `title`, `link`, `snippet` |

## ¿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`.

*Valor del campo q, como expresión de n8n*

```javascript
{{ $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](https://serpcrypto.com/es/docs/errors/). Los errores nunca se cobran.

*La misma petición con curl*

```bash
# 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}'
```

## Preguntas sobre n8n

### ¿Funciona esto en n8n Cloud y en n8n autoalojado?

El nodo HTTP Request, las credenciales Header Auth y el nodo AI Agent son funciones básicas de n8n documentadas para ambos. El lado de SerpCrypto es un endpoint HTTPS público, así que no importa dónde se ejecute n8n.

### ¿Puede el agente buscar en Google News o Google Maps?

Sí. Añade una segunda herramienta HTTP Request con el query parameter `engine` en `google_news` o `google_maps`, y descríbela para que el modelo sepa cuándo usarla. Todos los motores cuestan lo mismo: 1 crédito por búsqueda.

### ¿Qué recibe el agente cuando falla una búsqueda?

Un error HTTP con un cuerpo JSON pequeño que indica la causa, como `429 concurrency_limit`. No se usa ningún crédito, así que reintentar más tarde no cuesta nada extra.

### ¿Necesito una tarjeta de crédito para la clave API?

No. Los créditos de SerpCrypto se pagan con BTC, USDT, USDC, ETH, SOL, LTC, sin identificación, sin selfie y sin documentos. Inicio de sesión con el número de cuenta; el email es opcional.

## Fuentes

1. [Nodo HTTP Request](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) — n8n docs (read 2026-10-22)
2. [Credenciales HTTP Request](https://docs.n8n.io/integrations/builtin/credentials/httprequest/) — n8n docs (read 2026-10-22)
3. [Nodo AI Agent](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/) — n8n docs (read 2026-10-22)
4. [Deja que la IA especifique los parámetros de la herramienta con $fromAI()](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/) — n8n docs (read 2026-10-22)
5. [Nodo Split Out](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.splitout/) — n8n docs (read 2026-10-22)

---

SerpCrypto: SerpCrypto es una API SERP para desarrolladores y agentes de IA que devuelve resultados de Google y Bing como JSON, pagada con criptomonedas sin subir ningún documento de identidad. Los créditos de búsqueda prepagados desde 0,30 US$/1K búsquedas nunca caducan. Sin KYC: ni identificación, ni selfie, ni documentos. Paga con criptomonedas.
