n8n AI agent'larında web sayfalarını WebReaderAPI ile okuyun

HTTP Request node'unu neden araç olarak kullanmalıyım?

Çünkü bu API'nin ihtiyaç duyduğu her şeyi zaten yapıyor: tek bir GET isteği, tek bir header ve iki sorgu parametresi. n8n, HTTP Request node'unun normal bir node olarak çalışabileceğini veya bir AI agent'a araç olarak bağlanabileceğini ve bazı seçeneklerin yalnızca araç formunda bulunduğunu belirtir.

Kurulacak veya güncellenecek bizim adımıza hiçbir şey yok ve anahtar workflow'da değil n8n'in credential deposunda durur. n8n'e kendi anahtarını verin; böylece kullanımı diğer script'lerinizden ayrı görünür ve onu tek başına iptal edebilirsiniz. Örneğin ajan veya proje başına bir tane olmak üzere birkaç API anahtarı oluşturun ve bunlardan istediğinizi panelinizden iptal edin.

Model okunacak URL'yi nasıl seçiyor?

url parametresini modelin tanımlamasına izin verin. n8n, uygun parametre alanlarının yanında değeri modele veren bir düğme gösterir; ifadeyi n8n'in $fromAI() fonksiyonuyla kendiniz de yazabilirsiniz. Bir key, bir açıklama, bir tür ve isteğe bağlı bir varsayılan alır; örneğin url key'i, "The http or https address of the page to read" açıklaması ve string türü.

n8n, $fromAI()'ün yalnızca AI Agent node'una bağlı araçlarda çalıştığını belirtir. Araç açıklamasını da sade bir dille yazın; örneğin "Reads a public web page and returns its main content as Markdown", böylece agent onu ne zaman çağıracağını bilir.

Optimize Response'u neden açmalıyım?

Çünkü bir aracın döndürdüğü her şey modelin bağlamına girer. Optimize Response, modele iletilen veriyi azaltan yalnızca araçlara özgü bir seçenektir. JSON yanıt türüyle yalnızca seçili alanları dahil edebilirsiniz; title, final_url ve markdown alanlarını tutun, gerisini atın.

Uzunluğu bizim tarafımızda max_chars ile sınırlayın; bu, Markdown'ı API'den çıkmadan önce keser. Node'un HTML ve Text yanıt türlerinin kendi Truncate Response seçeneği vardır, ancak bizim JSON yanıtımızda max_chars daha basit kontrol.

API'yi zamanlanmış bir workflow'da nasıl kullanırım?

HTTP Request node'unu araç olarak değil, Schedule Trigger arkasında normal bir node olarak kullanın. Ona sabit bir url verin; izlediğiniz bir changelog veya fiyatlandırma sayfası gibi, ve markdown alanını bir sonraki node'a gönderin: bir dosya, bir veritabanı, bir sohbet mesajı veya önceki çalıştırmayla bir karşılaştırma.

Her çalıştırma URL başına bir sayfa okur. 20 sayfayı günde bir kez izlemek, tarayıcı gerektirmeyen sayfalar için ayda yaklaşık 600 kredi kullanır, yani 10.000 sayfa ($3,75) bir yıldan fazla dayanır. Ön ödemeli kreditler asla süresi dolmaz: kullanılmayan sayfalar siz kullanana kadar hesabınızda kalır.

Bir site okumayı reddettiğinde ne olur?

Node, blocked_by_robots veya target_refused gibi bir kodla hata yanıtı alır ve hiçbir ücret alınmaz. robots.txt'e uyarız: crawler'ımız kendini WebReaderAPI olarak tanıtır, kendisi için veya tüm robotlar için yazılmış kurallara uyar ve bir sitenin izin vermediği sayfayı okumaz. Reddedilen sayfalar için ücret alınmaz. Bir agent'ta, aracın hatayı döndürmesine izin verin ki model onu açıklayabilsin veya başka bir kaynak deneyebilsin; zamanlanmış bir workflow'da hataları bunları kaydeden bir dala yönlendirin. Hatalar sayfası her kodu listeler.

Workflow'u oluşturmadan önce çağrıyı deneyebilir miyim?

Aynı çağrıyı terminalde curl ile çalıştırın, curl tarifleri bölümünde gösterildiği gibi. Orada çalışıp n8n'de başarısız olursa, neden node ayarlarındadır; çoğunlukla credential değerinde Bearer öneki eksiktir veya url parametresi boş bırakılmıştır.