DEV Community

Cover image for Firecrawl Local Nedir? Firecrawl'ı Kendi Makinenizde Çalıştırın
Tobias Hoffmann
Tobias Hoffmann

Posted on Originally published at apidog.com

Firecrawl Local Nedir? Firecrawl'ı Kendi Makinenizde Çalıştırın

Firecrawl Local nedir? Kendi makinenizde çalışan Firecrawl

Firecrawl Local, kendi makinenizde web sitelerini temiz markdown'a kazıyan, tarayan ve haritalayan tek bir Rust ikili dosyasıdır. cargo install firecrawl-local ile kurulur; API anahtarı, veritabanı, kuyruk ve container olmadan, localhost:3002 üzerinde Firecrawl v2 API'sini sunabilir. Arama ve birkaç özellik hâlâ Firecrawl Cloud'a bağlanır; bunu kapatabilirsiniz.

Apidog'u bugün deneyin

Aşağıda: dizüstü bilgisayarınızda neyin çalıştığı, neyin buluta gittiği, nasıl kurulacağı, hangi API yönlendirmelerini sunduğu, sınırları ve kodlama ajanınızın Apidog CLI ile yerel API'yi nasıl test edebileceği yer alıyor.

Firecrawl Local nedir?

Firecrawl Local, Firecrawl'ın açık kaynaklı, cihaz üzerinde çalışan sürümüdür. Web sayfalarını getiren, barındırılan Firecrawl API'sinin kullandığı aynı HTML temizleme koduyla temizleyen ve markdown, HTML ya da bağlantı olarak döndüren tek bir ikili dosyadır. Bir CLI olarak, AI ajanları için bir MCP sunucusu olarak veya Firecrawl v2 API'sinin yerel bir kopyası olarak çalışır.

Firecrawl bunu 18 Kasım 2026'da X üzerinde bir lansman gönderisi ile duyurdu ve kod, Firecrawl deposunun apps/local klasöründe yer alıyor. Paket, crates.io üzerinde firecrawl-local adıyla yayımlandı ve depo AGPL-3.0 altında lisanslıdır.

Firecrawl, kendi barındırılan Firecrawl sürümünden 37 kat daha hızlı olduğunu ve 230 kat daha az bellek kullandığını (boşta 11 MB) iddia ediyor. README bir kıyaslama yöntemi yayımlamadığı için bunları firma iddiası olarak değerlendirin.

Barındırılan API'yi veya Firecrawl CLI'yi biliyorsanız, fikir basittir: aynı çağrılar, sizin makinenizde yanıtlanır.

Firecrawl Local nasıl çalışır: tek bir ikili dosya, on komut

Her özellik firecrawl-local komutunun bir alt komutu olarak yer alır. İşte README'deki tam liste:

Komut Ne yapar Nerede çalışır
scrape <urls...> Bir veya daha fazla URL'yi kazır Makineniz
crawl <url> Bir başlangıç URL'sinden bağlantıları takip eder Makineniz
map <url> Site haritalarından ve başlangıç sayfasından bir sitenin URL'lerini listeler Makineniz
serve Firecrawl v2 API'sini localhost üzerinde çalıştırır Makineniz
mcp Firecrawl MCP sunucusunu stdio üzerinden çalıştırır Makineniz, bazı araçlar bulutta
init MCP sunucusunu bu makinedeki AI araçlarına ekler Makineniz
search <query> Web'de arama yapar Firecrawl Cloud
find-tools <query> Alexandria veri sağlayıcılarını bulur Firecrawl Cloud, oturum açma
data <provider> <capability> Bir Alexandria veri sağlayıcısını çalıştırır Firecrawl Cloud, oturum açma
login Tarayıcıda Firecrawl'a giriş yapar Firecrawl Cloud

Günlük kullanımın çoğunu üç komut kapsar:

# Print one page as markdown
firecrawl-local scrape https://example.com --markdown

# Crawl up to 50 pages and save one markdown file per page
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages

# List every URL on a site
firecrawl-local map https://firecrawl.dev
Enter fullscreen mode Exit fullscreen mode

--markdown olmadan scrape, Firecrawl API'sinin JSON'unu yazdırır. --format, markdown, html, rawHtml ve links değerlerini kabul eder. PDF'ler ve Office belgeleri de yerel olarak ayrıştırılır.

JavaScript sayfaları için hâlihazırda sahip olduğunuz Chrome veya Chromium'u kullanır. Bunlar yoksa statik sayfalar hâlâ çalışır ve tarayıcı gerektiren bir sayfa uyarı döndürür. --browser auto|never|always Chrome'un ne zaman kullanılacağına karar verir.

Yerelde ne çalışır, Firecrawl Cloud'da ne çalışır

Kazıma, tarama, haritalama ve belge ayrıştırma makinenizde çalışır ve Firecrawl'a hiçbir şey göndermez. Üç özellik Firecrawl Cloud'a gider, çünkü bir dizüstü bilgisayarda dizin, ağ veya veri yoktur:

  • Arama. Makinenizde arama dizini yoktur. Anahtarsız arama çalışır ancak hız sınırına tabidir.
  • Makinenizi reddeden sayfalar. Bir site hem düz getirmeyi hem de yerel tarayıcıyı engellerse Firecrawl Cloud sayfayı getirir. Hesap gerekmez.
  • Alexandria veri sağlayıcıları. Bunlar Firecrawl Cloud üzerinde çalışır ve ücretsiz bir hesap gerektirir. Firecrawl Alexandria açıklamamız bunların ne olduğunu ele alıyor.

Firecrawl Local split: scrape, crawl, map and PDF and Office parsing run on your machine with optional Chrome, while search, the blocked-page fallback and Alexandria data go to Firecrawl Cloud under FIRECRAWL_CLOUD=auto, switchable to search or off

FIRECRAWL_CLOUD ortam değişkeni devri kontrol eder:

Değer Etki
auto (varsayılan) Arama, engellenen sayfa yedeği ve Alexandria'nın tümü çalışır
search Yalnızca arama Firecrawl Cloud'a gider
off Hiçbir şey Firecrawl Cloud'a gitmez

Tanınmayan bir değer off olarak sayılır. Bulut üzerinden getirilen sonuçlar "source": "firecrawl-cloud" taşır; bulut da başarısız olursa "blocked": true alırsınız.

Bulut çağrıları, rastgele bir kurulum kimliği ve çağıran aracın adını taşır; Firecrawl kurulumları bu şekilde sayar.

Firecrawl Local nasıl kurulur

Rust ve bir C derleyicisine ihtiyacınız var. Ardından:

  1. Derleme araçlarını kurun. macOS'ta xcode-select --install komutunu çalıştırın. Debian veya Ubuntu'da build-essential paketini kurun.
  2. Chrome veya Chromium ekleyin (isteğe bağlı), JavaScript ile işlenen sayfalara veya ekran görüntülerine ihtiyacınız varsa.
  3. Node.js 22 veya daha yenisini ekleyin (isteğe bağlı), firecrawl-mcp npm paketini npx üzerinden çalıştıran MCP sunucusunu istiyorsanız.
  4. Oturum açın (isteğe bağlı), Alexandria sağlayıcıları için firecrawl-local login komutuyla.

İkili dosyayı crates.io'dan kurun.

cargo install firecrawl-local
firecrawl-local --version
Enter fullscreen mode Exit fullscreen mode

Bunun yerine en son kodu derlemek için bir depo kopyasındaki apps/local dizininde cargo build --release komutunu çalıştırın.

Firecrawl Local API: localhost:3002 üzerindeki v2 yönlendirmeleri

firecrawl-local serve, 3002 portunda Firecrawl v2 API'sini yanıtlar. Yerel yönlendirmeler için API anahtarı gerekmez.

firecrawl-local serve

# in another terminal
curl -s http://localhost:3002/v2/scrape \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com","formats":["markdown"]}'
Enter fullscreen mode Exit fullscreen mode

Bu yönlendirmeler makinenizde çalışır:

Yönlendirme Ne yapar
POST /v2/scrape Bir URL'yi kazır
POST /v2/map Bir sitenin URL'lerini listeler
POST /v2/crawl, GET ve DELETE /v2/crawl/{id} Bir taramayı başlatır, kontrol eder ve iptal eder
POST /v2/batch/scrape, GET ve DELETE /v2/batch/scrape/{id} Bir toplu kazımayı başlatır, kontrol eder ve iptal eder
GET /health Sağlık kontrolü

Diğer tüm /v2 yönlendirmeleri, örneğin /v2/search, FIRECRAWL_CLOUD aksini söylemediği sürece Firecrawl Cloud'a iletilir. v0 ve v1 yönlendirmeleri sunulmaz.

Mevcut kod, tek bir ayar değiştirilerek taşınır: herhangi bir Firecrawl SDK'sının API URL'sini http://localhost:3002 adresine yönlendirin. Kazıyıcınız veya RAG hattınız kodunu korur ve yinelemeler yaparken bulut kredisi harcamayı bırakırsınız. Kazıma hatlarına daha geniş bir bakış için Firecrawl web kazıma rehberimize bakın.

AI ajanları için MCP sunucusu olarak Firecrawl Local

firecrawl-local init, Firecrawl Local'i bulduğu her AI aracında bir Model Context Protocol sunucusu olarak kaydeder. Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI ve Codex'i tanır, her yapılandırma dosyasını önce yedekler ve değişiklikleri önizlemek için --dry-run ya da tek bir aracı kurmak için --agent cursor seçeneklerini kabul eder.

Ajanınız standart Firecrawl MCP araçlarını alır: kazıma, tarama, haritalama ve toplu kazıma yerel olarak çalışır, geri kalanı Firecrawl Cloud'a gider.

Ajanınız güvenmediğiniz sitelerde gezinirse onu firecrawl-local mcp --public-only olarak kaydedin. Aksi takdirde gizli talimatlar içeren bir sayfa, ajanı ağınızdaki dahili bir URL'yi açmaya yönlendirebilir.

Firecrawl Local sınırları

Firecrawl Local, tam Firecrawl sunucusu değildir. README eksik olanları listeler:

  • Yerelde json veya summary formatı yok. Yerel kazımalar bir model gerektirdiği için bunları bir uyarıyla atlar.
  • Tarayıcı actions yok. Tıklama, kaydırma ve yazma adımları yok sayılır.
  • Ekran görüntüleri Chrome gerektirir.
  • İşler bellekte yaşar. Tarama ve toplu işler başladıktan bir saat sonra sona erer ve serve durduğunda kaybolur.
  • v0 veya v1 API yönlendirmesi yok.

Kuyruklar, çalışanlar ve her format için apps/api içindeki tam sunucu hâlâ mevcut; bu, Firecrawl'ın kendi kendine barındırma rehberinde ele alınıyor.

Bilmeniz gereken güvenlik varsayılanları

Varsayılanlar komuta göre farklılık gösterir, çünkü serve diğer programlardan istek alır:

  • scrape, crawl, map ve mcp klavyedeki kişi için çalışır, dolayısıyla localhost ve özel ağınıza erişebilirler. scrape, crawl ve mcp bu adresleri reddetmek için --public-only seçeneğini kabul eder.
  • serve, 127.0.0.1 adresine bağlanır ve --allow-private geçmediğiniz sürece localhost ve özel hedefleri reddeder. --host ile başka bir adrese bağlanmak --token gerektirir.
  • Link-local ve bulut meta veri adresleri her zaman engellenir, yönlendirmeler ve DNS çözümlemesi sonrasında bile.

Chrome, tek kullanımlık bir profille başsız ve sandbox içinde çalışır. Tarama yaparken Firecrawl Local, Robots Exclusion Protocol uyarınca robots.txt dosyasını okur; site sahipleri burada ona FirecrawlLocal olarak hitap edebilir.

Firecrawl Local kimin için?

  • Bulut hacmine ödeme yapmadan önce ücretsiz ve hızlı yineleme isteyen, kazıyıcı veya RAG hattı geliştiren geliştiriciler.
  • Her sayfayı üçüncü bir tarafa göndermeden Claude Code, Cursor veya Codex içinde web okumak isteyen kodlama ajanı kullanıcıları.
  • Getirilen içeriğin makinede kalması gereken veri kurallarına sahip ekipler; FIRECRAWL_CLOUD=off kullanır.

json çıkarımına, tarayıcı eylemlerine veya uzun ömürlü tarama işlerine bağlıysanız daha zayıf bir tercih. Yalnızca ajan aramasına ihtiyacınız varsa Claude için açık kaynaklı web araması derlememize bakın.

Kodlama ajanınızın yerel API'yi Apidog CLI ile test etmesini sağlayın

serve çalıştığında localhost:3002 üzerinde gerçek bir HTTP API'niz olur. Bir hattı ona bağlamadan önce yönlendirmelerin kodunuzun beklediği şekilde yanıt verdiğini kontrol edin. Kodlama ajanınıza istekleri tek tek tıklamak yerine Apidog CLI ve tek bir komut verin.

Bir kez kurun:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Enter fullscreen mode Exit fullscreen mode

Ardından ajanınıza şunu sorun:

Start firecrawl-local serve in the background. Write an OpenAPI 3 file for its
local routes (POST /v2/scrape, POST /v2/map, GET /health) and import it into
Apidog project <id>. Create an environment pointing at http://localhost:3002,
add test cases that assert /health returns 200 and /v2/scrape returns
success: true with non-empty data.markdown for https://example.com, then run
them and summarize any failures.
Enter fullscreen mode Exit fullscreen mode

Coding agent workflow: the agent starts firecrawl-local serve on localhost:3002, Apidog CLI imports the spec, creates test cases and runs them against POST /v2/scrape, POST /v2/map and GET /health, and writes a cli, json or junit report

Ajan şemayı okur, yükünü doğrular ve şu tarz komutları çalıştırır:

firecrawl-local serve &
apidog import --project <id> --format openapi --file ./firecrawl-local-v2.yaml
apidog environment create firecrawl-local --project <id> --base-url http://localhost:3002
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file ./case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json
Enter fullscreen mode Exit fullscreen mode

Apidog CLI istekleri makinenizden gönderir, dolayısıyla localhost:3002 erişilebilir. -r cli,json yerine -r junit yazarsanız aynı çalıştırma CI'a dahil olur; Apidog CLI CI/CD rehberimiz kurulumu gösteriyor ve Claude Code'da Apidog CLI ajan tarafını ele alıyor. Apidog'un Free planı 4 kullanıcıya kadar ekipleri kapsar.

SSS

Firecrawl Local ücretsiz mi? İkili dosya AGPL-3.0 altında açık kaynaklıdır ve yerel kazıma, tarama ve haritalama API anahtarı gerektirmez. Arama, engellenen sayfa yedeği ve Alexandria Firecrawl Cloud'a gider ve Alexandria ücretsiz bir hesap gerektirir.

Mevcut Firecrawl SDK kodumu Firecrawl Local ile kullanabilir miyim? Evet, yerel yönlendirmeler için kullanabilirsiniz. SDK'nın API URL'sini http://localhost:3002 olarak ayarlayın. Kazıma, haritalama, tarama ve toplu kazıma yerel olarak çalışır; v0 ve v1 yönlendirmeleri sunulmaz.

Firecrawl Local'in bulutu aramasını nasıl durdururum? FIRECRAWL_CLOUD=off ayarlayın. Arama ve engellenen sayfa yedeği çalışmayı durdurur ve açık bir login dışında makinenizden hiçbir şey çıkmaz.

Firecrawl Local'in kendi kendine barındırılan Firecrawl'dan farkı nedir? Kendi kendine barındırılan Firecrawl, apps/api içindeki tam sunucudur; kuyruklar, çalışanlar ve her formatı barındırır. Firecrawl Local ise json ve summary formatlarını, tarayıcı eylemlerini ve kalıcı işleri bırakan daha hafif tek bir ikili dosyadır.

Top comments (0)