Webzoekopdrachten in n8n AI agents met de SerpCrypto SERP-API

Waarom de HTTP Request-node en geen custom node?

De documentatie van n8n zegt dat de HTTP Request-node als gewone node kan draaien of aan een AI agent kan worden gekoppeld om als tool te dienen. Dat dekt een REST API zoals SerpCrypto, die één GET-request met een header en een paar query parameters vraagt. Er is geen community node van ons om te installeren of up to date te houden, en de credential blijft in de versleutelde credential store van n8n.

De AI Agent-node heeft een chatmodel en minstens één tool-subnode nodig. Sinds n8n 1.82.0 werkt elke AI Agent als een Tools Agent, dus de agent beslist zelf wanneer hij de zoektool aanroept.

Hoe sla ik de API-sleutel op?

Maak een Header Auth-credential aan. De credential-documentatie van n8n beschrijft twee velden, de naam van de header en de waarde ervan, en merkt op dat een bearer token header auth is met de naam Authorization en de waarde Bearer <token>. Zet Authorization in Name en Bearer plus je SerpCrypto-sleutel in Value.

n8n noemt ook een generiek Bearer-authtype; beide sturen dezelfde header. Geef n8n een eigen API-sleutel, zodat je het gebruik ervan los van je andere scripts ziet en hem zo nodig alleen kunt intrekken. API-sleutels die je op elk moment kunt aanmaken en intrekken vanuit je dashboard.

Hoe vult het model de zoekopdracht in?

Laat het model q definiëren. Naast een geschikt parameterveld toont n8n een sterknop die de waarde aan het model geeft. Je kunt de expressie $fromAI() ook zelf typen; die neemt een key, een beschrijving, een type en een standaardwaarde, en de beschrijving vertelt het model wat erin moet. n8n documenteert dat $fromAI() alleen werkt met tools die aan de AI Agent-node zijn gekoppeld.

Houd gl en hl vast als je agent één markt bedient. Laat het model ze ook instellen als gebruikers naar verschillende landen vragen, en beschrijf de verwachte codes, zoals gb of de.

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

Waarom Optimize Response aanzetten?

Een volledige resultatenpagina in JSON is lang, en alles wat de tool teruggeeft komt in de context van het model. Optimize Response is een optie van de HTTP Request-node die alleen voor tools geldt en de data die naar het model gaat beperkt; n8n merkt op dat dit kosten kan verlagen. Zet bij het JSON-responstype Field Containing Data op organic_results en selecteer alleen title, link en snippet.

De agent leest dan ongeveer tien korte items per zoekopdracht in plaats van elk blok van de pagina. Als je agent lokale vragen beantwoordt, richt Field Containing Data dan in een tweede tool op local_results.

Hoe gebruik ik dezelfde API in een normale workflow?

Zonder de agent gebruik je de HTTP Request-node als gewone node met een vaste q, bijvoorbeeld in een Schedule Trigger-workflow die elke ochtend een keyword controleert. Voeg dan een Split Out-node toe met Field to Split Out op organic_results: die zet de lijst om in één item per resultaat, klaar voor een spreadsheet- of database-node.

Elke run is één zoekopdracht per keyword, dus 50 keywords per dag gebruiken ongeveer 1.500 credits per maand. Het 25.000 zoekopdrachten-pack (US$ 18,75) dekt dat ruim tien keer, en Prepaid zoekcredits verlopen nooit: ongebruikte zoekopdrachten blijven op je account staan tot je ze gebruikt.

Hoe test ik het request buiten n8n?

Voer hetzelfde request uit in een terminal. Werkt het daar, dan komt elk probleem in n8n door de node-instellingen; mislukt het, dan noemt de error body de oorzaak, zoals vermeld op de errors-pagina. Errors worden nooit in rekening gebracht.

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