Wyszukiwanie w sieci w agentach AI n8n z API SERP SerpCrypto

Dlaczego node HTTP Request, a nie własny node?

Dokumentacja n8n mówi, że node HTTP Request może działać jako zwykły node albo być podłączony do agenta AI i używany jako narzędzie. To obejmuje REST API takie jak SerpCrypto, które przyjmuje jedno zapytanie GET z nagłówkiem i kilkoma parametrami zapytania. Nie mamy własnego node'a społecznościowego do instalowania ani aktualizowania, a dane uwierzytelniające pozostają w zaszyfrowanym magazynie danych uwierzytelniających n8n.

Node AI Agent wymaga modelu czatu i co najmniej jednego podnode'a narzędziowego. Od n8n 1.82.0 każdy AI Agent działa jako Tools Agent, więc agent sam decyduje, kiedy wywołać narzędzie wyszukiwania.

Jak przechować klucz API?

Utwórz dane uwierzytelniające Header Auth. Dokumentacja danych uwierzytelniających n8n opisuje dwa pola, Name i Value nagłówka, i zaznacza, że token bearer to header auth z nazwą Authorization i wartością Bearer <token>. W Name wpisz Authorization, a w Value Bearer plus swój klucz SerpCrypto.

n8n wymienia też ogólny typ uwierzytelniania Bearer; oba wysyłają ten sam nagłówek. Daj n8n własny klucz API, żeby widzieć jego zużycie osobno od innych skryptów i w razie potrzeby unieważnić go tylko dla niego. Klucze API, które możesz tworzyć i unieważniać w dowolnym momencie z panelu.

Jak model wypełnia zapytanie wyszukiwania?

Pozwól modelowi zdefiniować q. Obok pola kwalifikującego się parametru n8n pokazuje przycisk gwiazdki, który przekazuje wartość modelowi. Możesz też sam wpisać wyrażenie $fromAI(), które przyjmuje klucz, opis, typ i wartość domyślną; opis mówi modelowi, co tam wpisać. Dokumentacja n8n podaje, że $fromAI() działa tylko z narzędziami podłączonymi do node'a AI Agent.

Ustaw na stałe gl i hl, jeśli agent obsługuje jeden rynek. Pozwól modelowi ustawiać je także wtedy, gdy użytkownicy pytają o różne kraje, i opisz oczekiwane kody, takie jak gb lub de.

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

Po co włączać Optimize Response?

Pełna strona wyników w JSON jest długa, a wszystko, co zwraca narzędzie, trafia do kontekstu modelu. Optimize Response to opcja node'a HTTP Request dostępna tylko dla narzędzi, która ogranicza dane przekazywane modelowi; n8n zaznacza, że może to obniżyć koszty. Przy typie odpowiedzi JSON ustaw Field Containing Data na organic_results i wybierz tylko title, link i snippet.

Agent czyta wtedy około dziesięciu krótkich wpisów na wyszukiwanie zamiast każdego bloku strony. Jeśli agent odpowiada na pytania lokalne, w drugim narzędziu wskaż Field Containing Data na local_results.

Jak użyć tego samego API w zwykłym workflow?

Bez agenta użyj node'a HTTP Request jako zwykłego node'a ze stałym q, na przykład w workflow z Schedule Trigger, który sprawdza słowo kluczowe każdego ranka. Dodaj potem node Split Out z Field to Split Out ustawionym na organic_results: zamienia listę na jeden element na wynik, gotowy dla arkusza kalkulacyjnego lub node'a bazy danych.

Każde uruchomienie to jedno wyszukiwanie na słowo kluczowe, więc 50 słów kluczowych dziennie zużywa około 1 500 kredytów miesięcznie. Pakiet 25 000 wyszukiwań (18,75 USD) pokrywa to z ponad dziesięciokrotnym zapasem, a Prepaid kredyty wyszukiwania nigdy nie wygasają: niewykorzystane wyszukiwania pozostają na Twoim koncie, dopóki ich nie wykorzystasz.

Jak przetestować zapytanie poza n8n?

Uruchom to samo zapytanie w terminalu. Jeśli tam działa, każdy problem w n8n wynika z ustawień node'a; jeśli nie działa, treść błędu podaje przyczynę, zgodnie z listą na stronie błędów. Błędy nigdy nie są naliczane.

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