# SerpCrypto SERP API ile n8n AI agent'larda web arama

> n8n AI Agent'a Google web araması ekleyin: SerpCrypto SERP API için HTTP Request node ayarları ve $fromAI ile Optimize Response. Kripto ödeme, KYC yok.

- URL: https://serpcrypto.com/tr/docs/n8n/
- Son güncelleme: 2026-10-22
- Yayıncı: SerpCrypto (https://serpcrypto.com)

Kurulacak özel node yok: n8n'in kendi HTTP Request node'u, AI Agent'a tool olarak bağlandığında SerpCrypto API'sini çağırır ve modele kısaltılmış bir sonuç listesi verir. Aynı node düz workflow'ları da besler, örneğin günlük bir sıralama kontrolü.

**Hızlı yanıt — Bir n8n AI Agent'a web arama tool'u nasıl eklerim?**

HTTP Request node'unu AI Agent'a tool olarak bağlayın, `GET https://serpcrypto.com/api/v1/search` olarak ayarlayın ve bir Header Auth credential (`Authorization: Bearer <key>`) kullanın, modelin `q` sorgu parametresini doldurmasına izin verin ve yalnızca başlıkları, bağlantıları ve snippet'leri iletmek için Optimize Response'u açın. **SerpCrypto** başarılı arama başına 1 kredi ücretlendirir, $0,30/1K arama'den başlar; kripto ile ödeme, KYC yok.

## Hangi HTTP Request ayarlarını kullanmalıyım?

Seçenek adları, 2026-10-22 tarihinde okunan n8n'in HTTP Request node belgelerindekilerle aynıdır.

| Ayar | Değer |
| --- | --- |
| Konum | **AI Agent** node'una tool alt-node olarak bağlı |
| Method | `GET` |
| URL | `https://serpcrypto.com/api/v1/search` |
| Kimlik doğrulama | Generic Credential Type → **Header Auth** |
| Header Auth credential | Name `Authorization`, Value `Bearer ` ve ardından API anahtarınız |
| Send Query Parameters | Açık, **Using Fields Below** |
| Parameter `q` | Model tarafından tanımlanır (yıldız düğmesi veya `$fromAI`, aşağıya bakın) |
| Parameters `gl`, `hl` | `us` ve `en` gibi sabit değerler veya model tarafından tanımlanır |
| Optimize Response | Açık · Response type **JSON** · Field Containing Data `organic_results` · Include Fields **Selected**: `title`, `link`, `snippet` |

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

*q alanının değeri, bir n8n ifadesi olarak*

```javascript
{{ $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](https://serpcrypto.com/tr/docs/errors/) listelendiği gibi. Hatalar için asla ücret alınmaz.

*Aynı istek curl ile*

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

## n8n soruları

### Bu, n8n Cloud'da ve kendi sunucunuzda barındırılan n8n'de çalışır mı?

HTTP Request node, Header Auth kimlik bilgileri ve AI Agent node'u, her ikisi için de belgelenmiş temel n8n özellikleridir. SerpCrypto tarafı herkese açık bir HTTPS endpoint'tir, dolayısıyla n8n'in nerede çalıştığı önemli değildir.

### Agent Google News veya Google Maps'te arama yapabilir mi?

Evet. Sorgu parametresi `engine` `google_news` veya `google_maps` olarak ayarlanmış ikinci bir HTTP Request aracı ekleyin ve modelin ne zaman kullanacağını bilmesi için bunu açıklayın. Her motor arama başına aynı 1 krediye mal olur.

### Bir arama başarısız olduğunda agent ne alır?

Nedeni belirten küçük bir JSON gövdesiyle birlikte bir HTTP hatası, örneğin `429 concurrency_limit`. Kredi kullanılmaz, dolayısıyla daha sonra tekrar denemek ekstra ücrete mal olmaz.

### API anahtarı için kredi kartına ihtiyacım var mı?

Hayır. SerpCrypto kredi BTC, USDT, USDC, ETH, SOL, LTC ile ödenir; kimlik yok, selfie yok, belge yok. Hesap numarasıyla giriş; email isteğe bağlı.

## Kaynaklar

1. [HTTP Request node](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) — n8n docs (read 2026-10-22)
2. [HTTP Request kimlik bilgileri](https://docs.n8n.io/integrations/builtin/credentials/httprequest/) — n8n docs (read 2026-10-22)
3. [AI Agent node](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/) — n8n docs (read 2026-10-22)
4. [AI'nın $fromAI() ile araç parametrelerini belirlemesine izin verin](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/) — n8n docs (read 2026-10-22)
5. [Split Out node](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.splitout/) — n8n docs (read 2026-10-22)

---

SerpCrypto: SerpCrypto, Google ve Bing sonuçlarını JSON olarak döndüren, geliştiriciler ve AI agent'lar için bir SERP API'dir; kripto ile ödeme yapılır, kimlik yüklemek gerekmez. $0,30/1K arama ön ödemeli arama kredisinin süresi asla dolmaz. KYC olmadan — kimlik yok, selfie yok, belge yok. Kripto ile ödeme yapın.
