> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 geri dönüş çıkarıcısı olarak

Bot atlatma ve önbelleğe alma desteği sunan barındırılan bir çıkarma/arama hizmetidir;
bu da JS ağırlıklı sitelerde veya düz HTTP getirmelerini engelleyen sayfalarda yardımcı olur.

## Plugin'i yükleyin

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/firecrawl-plugin
openclaw gateway restart
```

## Anahtarsız web\_fetch ve API anahtarları

Açıkça seçilen barındırılan Firecrawl `web_fetch` geri dönüşü, API anahtarı olmadan başlangıç
erişimini destekler. Daha yüksek limitlere ihtiyacınız olduğunda Gateway ortamına
`FIRECRAWL_API_KEY` ekleyin veya yapılandırın. Firecrawl `web_search` ve
`firecrawl_scrape` bir API anahtarı gerektirir.

## Firecrawl aramasını yapılandırın

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    web: {
      search: {
        provider: "firecrawl",
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "FIRECRAWL_API_KEY_HERE",
            baseUrl: "https://api.firecrawl.dev",
          },
        },
      },
    },
  },
}
```

Notlar:

* İlk kurulumda Firecrawl'ı seçmek veya `openclaw configure --section web` çalıştırmak, yüklü Firecrawl Plugin'ini otomatik olarak etkinleştirir.
* 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'a ayarlanır. Kendi barındırdığınız 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 geri dönüşüdür.

## Firecrawl web\_fetch geri dönüşünü yapılandırın

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    web: {
      fetch: {
        provider: "firecrawl", // explicit selection enables keyless fallback
      },
    },
  },
  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` geri dönüşü API anahtarı olmadan çalışır. Yapılandırıldığında OpenClaw, daha yüksek limitler için `plugins.entries.firecrawl.config.webFetch.apiKey` veya `FIRECRAWL_API_KEY` gönderir.
* İlk kurulum sırasında Firecrawl'ı seçmek veya `openclaw configure --section web` çalıştırmak, Plugin'i etkinleştirir ve başka bir getirme sağlayıcısı zaten yapılandırılmamışsa `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 denetler (ms). Varsayılan 2 gündür.
* Eski `tools.web.fetch.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 barındırdığınız 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şmesiyle eşleşecek şekilde, belirgin özel, loopback, metadata ve HTTP(S) dışı hedef URL'leri Firecrawl'a iletmeden önce reddeder.

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

### Kendi barındırdığınız 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://` adreslerini yalnızca loopback, ö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ı

### `firecrawl_search`

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

Temel parametreler:

* `query`
* `count`
* `sources`
* `categories`
* `scrapeResults`
* `timeoutSeconds`

### `firecrawl_scrape`

Düz `web_fetch` zayıf kaldığında, JS ağırlıklı veya bot korumalı sayfalar için bunu kullanın.

Temel parametreler:

* `url`
* `extractMode`
* `maxChars`
* `onlyMainContent`
* `maxAgeMs`
* `proxy`
* `storeInCache`
* `timeoutSeconds`

## Gizlilik / bot atlatma

Firecrawl, bot atlatma için bir **proxy modu** parametresi sunar (`basic`, `stealth` veya `auto`).
OpenClaw, Firecrawl istekleri için her zaman `proxy: "auto"` ile birlikte `storeInCache: true` kullanır.
Proxy atlanırsa Firecrawl varsayılan olarak `auto` kullanır. `auto`, temel deneme başarısız olursa stealth proxy'lerle yeniden dener; bu, yalnızca basic kazımadan daha fazla kredi kullanabilir.

## `web_fetch` Firecrawl'ı nasıl kullanır

`web_fetch` çıkarma sırası:

1. Readability (yerel)
2. Firecrawl (seçildiğinde veya yapılandırılmış kimlik bilgilerinden otomatik algılandığında)
3. Temel HTML temizliği (son geri dönüş)

Seçim düğmesi `tools.web.fetch.provider` değeridir. Bunu atlarsanız OpenClaw,
mevcut kimlik bilgilerinden ilk hazır web-fetch sağlayıcısını otomatik algılar.
Resmi Firecrawl Plugin'i bu geri dönüşü sağlar.

## İlgili

* [Web Search genel bakış](/tr/tools/web) -- tüm sağlayıcılar ve otomatik algılama
* [Web Fetch](/tr/tools/web-fetch) -- Firecrawl geri dönüşlü web\_fetch aracı
* [Tavily](/tr/tools/tavily) -- arama + çıkarma araçları