OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Firecrawl

OpenClaw, Firecrawl'ı üç şekilde kullanabilir:

  • web_search sağlayıcısı olarak
  • açık Plugin araçları olarak: firecrawl_search ve firecrawl_scrape
  • web_fetch için yedek ayıklayıcı olarak

Bot engellerini aşmayı ve önbelleğe almayı destekleyen, barındırılan bir ayıklama/arama hizmetidir; bu özellikler yoğun JS kullanan sitelerde veya düz HTTP getirme isteklerini engelleyen sayfalarda yardımcı olur.

Plugin'i yükleme

Resmî Plugin'i yükleyin, ardından Gateway'i yeniden başlatın:

bash
openclaw plugins install @openclaw/firecrawl-pluginopenclaw gateway restart

Anahtarsız erişim ve API anahtarları

Firecrawl iki web_search sağlayıcısı kaydeder:

  • Firecrawl Arama (firecrawl) — anahtarınızla barındırılan /v2/search API'sini kullanır; bir anahtar mevcut olduğunda otomatik olarak algılanır.
  • Firecrawl Arama (Ücretsiz) (firecrawl-free) — barındırılan anahtarsız başlangıç katmanını kullanır; API anahtarı gerekmez. Yalnızca açıkça etkinleştirilebilir ve hiçbir zaman otomatik olarak seçilmez, çünkü bunun seçilmesi arama sorgularınızı Firecrawl'ın ücretsiz katmanına gönderir.

Açıkça seçilen Firecrawl web_fetch yedeği de anahtarsızdır. Açık firecrawl_search ve firecrawl_scrape araçları bir API anahtarı gerektirir. Daha yüksek sınırlar için gateway ortamına FIRECRAWL_API_KEY ekleyin veya yapılandırın.

Firecrawl aramasını yapılandırma

json5
{  tools: {    web: {      search: {        provider: "firecrawl",      },    },  },  plugins: {    entries: {      firecrawl: {        enabled: true,        config: {          webSearch: {            apiKey: "FIRECRAWL_API_KEY_HERE",            baseUrl: "https://api.firecrawl.dev",          },        },      },    },  },}

Notlar:

  • İlk katılım sırasında veya openclaw configure --section web içinde Firecrawl'ı seçmek, yüklü Firecrawl Plugin'ini otomatik olarak etkinleştirir.
  • API anahtarı olmadan anahtarsız çalıştırmak için ilk katılım sırasında Firecrawl Arama (Ücretsiz) seçeneğini belirleyin (veya provider: "firecrawl-free" ayarlayın). Anahtarlı Firecrawl Arama sağlayıcısı plugins.entries.firecrawl.config.webSearch.apiKey veya FIRECRAWL_API_KEY gönderir.
  • Firecrawl ile web_search, query ve count destekler.
  • sources, categories veya sonuç kazıma gibi Firecrawl'a özgü denetimler için firecrawl_search kullanın.
  • baseUrl, varsayılan olarak https://api.firecrawl.dev adresindeki barındırılan Firecrawl'ı kullanır. Kendi kendine barındırılan geçersiz kılmalara yalnızca özel/dahili uç noktalar için izin verilir; HTTP yalnızca bu özel hedefler için kabul edilir.
  • FIRECRAWL_BASE_URL, Firecrawl arama ve kazıma temel URL'leri için paylaşılan ortam yedeğidir.
  • Firecrawl arama isteklerinin varsayılan zaman aşımı 30 saniyedir; firecrawl_search aracının timeoutSeconds parametresi bunu çağrı bazında geçersiz kılar.

Firecrawl web_fetch yedeğini yapılandırma

json5
{  tools: {    web: {      fetch: {        provider: "firecrawl", // açık seçim anahtarsız yedeği etkinleştirir      },    },  },  plugins: {    entries: {      firecrawl: {        enabled: true,        config: {          webFetch: {            baseUrl: "https://api.firecrawl.dev",            onlyMainContent: true,            maxAgeMs: 172800000,            timeoutSeconds: 60,          },        },      },    },  },}

Notlar:

  • Açıkça seçilen Firecrawl web_fetch yedeği, API anahtarı olmadan çalışır. Yapılandırıldığında OpenClaw, daha yüksek sınırlar için plugins.entries.firecrawl.config.webFetch.apiKey veya FIRECRAWL_API_KEY gönderir.
  • İlk katılım sırasında veya openclaw configure --section web içinde Firecrawl'ı seçmek, başka bir getirme sağlayıcısı zaten yapılandırılmamışsa Plugin'i etkinleştirir ve web_fetch için Firecrawl'ı seçer.
  • firecrawl_scrape bir API anahtarı gerektirir.
  • maxAgeMs, önbelleğe alınmış sonuçların ne kadar eski olabileceğini (ms) denetler. Varsayılan değer 172.800.000 ms'dir (2 gün).
  • onlyMainContent varsayılan olarak true değerini; timeoutSeconds ise varsayılan olarak 60 değerini kullanır.
  • Eski tools.web.fetch.firecrawl.* ve tools.web.search.firecrawl.* yapılandırması, openclaw doctor --fix tarafından otomatik olarak taşınır.
  • Firecrawl kazıma/temel URL geçersiz kılmaları, aramayla aynı barındırılan/özel kuralını izler: herkese açık barındırılan trafik https://api.firecrawl.dev kullanır; kendi kendine barındırılan geçersiz kılmalar özel/dahili uç noktalara çözümlenmelidir.
  • firecrawl_scrape, açık Firecrawl kazıma çağrıları için web_fetch hedef güvenliği sözleşmesine uygun olarak, belirgin özel, geri döngü, meta veri ve HTTP(S) dışı hedef URL'lerini Firecrawl'a iletmeden önce reddeder.

firecrawl_scrape, gerekli API anahtarı da dahil olmak üzere aynı plugins.entries.firecrawl.config.webFetch.* ayarlarını ve ortam değişkenlerini yeniden kullanır.

Kendi kendine barındırılan Firecrawl

Firecrawl'ı kendiniz çalıştırdığınızda plugins.entries.firecrawl.config.webSearch.baseUrl, plugins.entries.firecrawl.config.webFetch.baseUrl veya FIRECRAWL_BASE_URL ayarlayın. OpenClaw, http:// değerini yalnızca geri döngü, özel ağ, .local, .internal veya .localhost hedefleri için kabul eder. Firecrawl API anahtarlarının yanlışlıkla rastgele uç noktalara gönderilmemesi için herkese açık özel ana makineler reddedilir.

Firecrawl Plugin araçları

Genel web_search yerine Firecrawl'a özgü arama denetimleri istediğinizde bunu kullanın. API anahtarı gerektirir.

Parametreler:

  • query
  • count (1-100)
  • sources
  • categories
  • includeDomains / excludeDomains (yalnızca ana makine adları; birbirini dışlar)
  • tbs (zaman filtresi; örneğin qdr:d, qdr:w, sbd:1)
  • location ve country (coğrafi hedefleme)
  • scrapeResults
  • timeoutSeconds

firecrawl_scrape

Düz web_fetch yönteminin yetersiz kaldığı, yoğun JS kullanan veya bot korumalı sayfalar için bunu kullanın.

Parametreler:

  • url
  • extractMode
  • maxChars
  • onlyMainContent
  • maxAgeMs
  • proxy
  • storeInCache
  • timeoutSeconds

Gizli mod / bot engellerini aşma

firecrawl_scrape ve web_fetch Firecrawl yedeği, çağıran bu parametreleri geçersiz kılmadığı sürece varsayılan olarak proxy: "auto" ile birlikte storeInCache: true kullanır. firecrawl_search ve web_search Firecrawl sağlayıcında proxy/storeInCache denetimleri yoktur; gizli proxy modu yalnızca kazıma/getirme isteklerine uygulanır.

Firecrawl'ın proxy modu, bot engellerini aşmayı denetler (basic, stealth veya auto). auto, temel bir deneme başarısız olursa gizli proxy'lerle yeniden dener; bu, yalnızca temel kazımadan daha fazla kredi kullanabilir.

web_fetch, Firecrawl'ı nasıl kullanır?

web_fetch ayıklama sırası:

  1. Readability (yerel)
  2. Firecrawl gibi yapılandırılmış getirme sağlayıcısı (seçildiğinde veya yapılandırılmış kimlik bilgileri üzerinden otomatik algılandığında)
  3. Temel HTML temizleme (son yedek)

Seçim ayarı tools.web.fetch.provider değeridir. Bunu belirtmezseniz OpenClaw, mevcut kimlik bilgilerinden hazır olan ilk web getirme sağlayıcısını otomatik olarak algılar. Resmî Firecrawl Plugin'i bu yedeği sağlar.

İlgili

Was this useful?
On this page

On this page