SerpCrypto SERP API ile n8n AI agent'larda web arama

Neden özel bir node yerine HTTP Request node?

n8n'in belgeleri, HTTP Request node'un normal bir node olarak çalıştırılabileceğini veya bir AI agent'a araç olarak eklenebileceğini söylüyor. Bu, SerpCrypto gibi bir REST API'yi kapsar; tek bir header ve birkaç sorgu parametresiyle bir GET isteği alır. Yüklenecek veya güncel tutulacak bir topluluk node'umuz yok ve kimlik bilgisi n8n'in şifrelenmiş kimlik bilgisi deposunda kalır.

AI Agent node'u bir chat model ve en az bir araç alt node'u gerektirir. n8n 1.82.0 sürümünden beri her AI Agent bir Tools Agent olarak çalışır, yani agent arama aracını ne zaman çağıracağına kendisi karar verir.

API anahtarını nasıl saklarım?

Bir Header Auth kimlik bilgisi oluşturun. n8n'in kimlik bilgisi belgeleri iki alanı, header Name ve Value değerini açıklar ve bearer token'ın Authorization adlı ve Bearer <token> değerli header auth olduğunu belirtir. Name alanına Authorization, Value alanına Bearer ve SerpCrypto anahtarınızı koyun.

n8n ayrıca genel bir Bearer auth türü de listeler; ikisi de aynı header'ı gönderir. n8n'e kendi API anahtarını verin, böylece kullanımını diğer script'lerinizden ayrı görebilir ve gerekirse yalnızca onu iptal edebilirsiniz. Dashboard'ınızdan istediğiniz zaman oluşturup iptal edebileceğiniz API anahtarları.

Model arama sorgusunu nasıl doldurur?

Modelin q tanımlamasına izin verin. Uygun bir parametre alanının yanında n8n, değeri modele devreden bir yıldız düğmesi gösterir. $fromAI() ifadesini kendiniz de yazabilirsiniz; bu ifade bir key, bir description, bir type ve bir varsayılan değer alır ve description modele oraya ne koyacağını söyler. n8n, $fromAI() ifadesinin yalnızca AI Agent node'una bağlı araçlarla çalıştığını belirtir.

Agent'ınız tek bir pazara hizmet ediyorsa gl ve hl sabit kalsın. Kullanıcılar farklı ülkeleri soruyorsa modelin bunları da ayarlamasına izin verin ve beklenen kodları, örneğin gb veya de, açıklayın.

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

Neden Optimize Response açılmalı?

JSON'daki tam bir sonuç sayfası uzundur ve aracın döndürdüğü her şey modelin bağlamına girer. Optimize Response, HTTP Request node'unun modele aktarılan veriyi kısaltan yalnızca araçlarda kullanılabilen bir seçeneğidir; n8n bunun maliyetleri düşürebileceğini belirtir. JSON yanıt türünde Field Containing Data alanına organic_results yazın ve yalnızca title, link ve snippet alanlarını seçin.

Böylece agent, sayfanın her bloğu yerine arama başına yaklaşık on kısa girdi okur. Agent'ınız yerel soruları yanıtlıyorsa, ikinci bir araçta Field Containing Data alanını local_results olarak ayarlayın.

Aynı API'yi normal bir workflow'da nasıl kullanırım?

Agent olmadan HTTP Request node'unu sabit bir q ile normal bir node olarak kullanın; örneğin her sabah bir anahtar kelimeyi kontrol eden bir Schedule Trigger workflow'unda. Ardından Field to Split Out alanı organic_results olarak ayarlanmış bir Split Out node'u ekleyin: bu node listeyi her sonuç için bir öğeye dönüştürür ve bir elektronik tablo veya veritabanı node'una hazır hale getirir.

Her çalıştırma anahtar kelime başına bir aramadır, yani günde 50 anahtar kelime ayda yaklaşık 1.500 kredi kullanır. 25.000 arama paketi ($18,75) bunu on kattan fazla karşılar ve Ön ödemeli arama kredileri hiçbir zaman sona ermez: kullanılmayan aramalar siz kullanana kadar hesabınızda kalır.

İsteği n8n dışında nasıl test ederim?

Aynı isteği bir terminalde çalıştırın. Orada çalışıyorsa n8n'deki herhangi bir sorun node ayarlarından kaynaklanıyordur; başarısız olursa hata gövdesi nedeni belirtir, hatalar sayfasında listelendiği gibi. Hatalar için asla ücret alınmaz.

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