Firecrawl Local'i kullanmak için cargo install firecrawl-local komutuyla kurun, Claude Code ve Cursor'da MCP sunucusu olarak kaydetmek için firecrawl-local init komutunu çalıştırın ve ardından iki aracı da yeniden başlatın. Aracınız artık kendi makinenizde site kazıyabilir, tarayabilir ve haritalayabilir. Kodla kullanmak için firecrawl-local serve komutunu çalıştırın ve herhangi bir Firecrawl SDK'sını http://localhost:3002 adresine yönlendirin.
Bu rehber, 19 Kasım 2026'da gerçekleştirdiğimiz test çalışmasındaki gerçek çıktıyla (arm64 Mac üzerinde Firecrawl Local 0.1.0) Firecrawl Local'in adım adım nasıl kullanılacağını, aracınıza vereceğiniz komutları ve o aracın yerel API'yi Apidog CLI ile test etmesini nasıl sağlayacağınızı gösterir.
Başlamadan önce ihtiyacınız olanlar
Firecrawl Local, Firecrawl deposundaki tek bir Rust ikili dosyasıdır. Kurmadan önce şunlara sahip olduğunuzu kontrol edin:
-
Rust ve bir C derleyicisi. Rust'ı rustup.rs adresinden edinin. macOS'ta
xcode-select --installkomutunu çalıştırın; Debian veya Ubuntu'dabuild-essentialpaketini kurun. -
Node.js 22 veya daha yenisi (MCP sunucusunu istiyorsanız).
firecrawl-mcpnpm paketininpxüzerinden çalıştırır. - Chrome veya Chromium (isteğe bağlı). Firecrawl Local, JavaScript gerektiren sayfalar için zaten sahip olduğunuz tarayıcıyı kullanır. Statik sayfalar tarayıcı olmadan da çalışır.
-
Claude Code, Cursor veya başka bir MCP istemcisi.
initayrıca Claude Desktop, Windsurf, Gemini CLI ve Codex'i de tanır.
Firecrawl'a yeniyseniz, önce Firecrawl web kazıma rehberimizle başlayın ve sonra geri dönün.
Adım 1: Firecrawl Local'i kurun
Paketi crates.io üzerinden kurup sürümü doğrulayın:
cargo install firecrawl-local
firecrawl-local --version
# firecrawl-local 0.1.0
Cargo, paketi kaynaktan derler. Bizim Mac'imizde release derlemesi 6 dakika 54 saniyede tamamlandı ve ikili dosya ~/.cargo/bin/firecrawl-local konumuna yerleşti. Bu klasörün PATH üzerinde olduğundan emin olun veya tam yolu not alın: manuel MCP kurulumunda buna ihtiyacınız olacak.
Adım 2: İlk kazıma işleminizi terminalden çalıştırın
Herhangi bir şeyi aracınıza bağlamadan önce, istekte bulunmanın çalıştığını doğrulayın:
FIRECRAWL_CLOUD=off firecrawl-local scrape https://example.com --markdown
Sayfanın ana metnini 1,2 saniyede markdown olarak yazdırdı. --markdown seçeneğini kaldırırsanız Firecrawl API'sinin döndürdüğü aynı JSON'u alırsınız. --format markdown,links formatları seçer; yerel seçenekler markdown, html, rawHtml ve links'tir.
Şimdi de her sayfa için bir markdown dosyası yazan bir tarama:
FIRECRAWL_CLOUD=off firecrawl-local crawl https://docs.firecrawl.dev --limit 20 --out ./pages
Bu işlem Firecrawl dokümantasyonunun 20 sayfasını 4,4 saniyede getirdi ve 0005-docs.firecrawl.dev_advanced-scraping-guide.md gibi adlarla dosyalar kaydetti. firecrawl-local crawl --help çıktısındaki kullanışlı tarama seçenekleri:
| Seçenek | Ne yapar |
|---|---|
-l, --limit |
Maksimum sayfa sayısı (varsayılan 100) |
--max-depth |
Kaç bağlantı derinliğine kadar takip edileceği |
--include, --exclude
|
Tutulacak veya atlanacak yol regex'i, tekrarlanabilir |
--entire-domain |
Başlangıç yolunun dışındaki bağlantıları takip et |
-c, --concurrency |
Aynı anda getirilen sayfa sayısı |
--ignore-robots |
robots.txt'i atla (varsayılan olarak okunur) |
firecrawl-local map https://firecrawl.dev komutu, site haritalarından ve başlangıç sayfasından bulduğu her URL'yi tek bir JSON satırı olarak döndürür.
Adım 3: init ile Firecrawl Local'i Claude Code ve Cursor'a ekleyin
init, makinenizdeki yapay zeka araçlarını bulur ve Firecrawl Local'i her birinin MCP yapılandırmasına ekler. Önce önizleyin:
firecrawl-local init --dry-run
Mac'imizde dokunacağı her aracı listeledi:
Firecrawl MCP server:
Claude Code: would be added in ~/.claude.json
Claude desktop: would be added in ~/Library/Application Support/Claude/claude_desktop_config.json
Cursor: would be added in ~/.cursor/mcp.json
Gemini CLI: would be added in ~/.gemini/settings.json
Codex: would be added in ~/.codex/config.toml
Deneme çalıştırması ayrıca Firecrawl Cloud'a nelerin gideceğini de yazdırır: arama sorguları, makinenizi engelleyen bir sayfanın URL'si, oturum açtığınızda Alexandria çağrıları ve rastgele bir kurulum kimliği ile yapay zeka aracınızın adı. Yerelde sorunsuz yüklenen sayfalar asla gönderilmez.
Bu rehberin ele aldığı iki aracı kurmak için --agent seçeneğini tekrarlayın:
firecrawl-local init --agent claude-code --agent cursor
Geçerli adlar claude-code, claude-desktop, cursor, windsurf, gemini ve codex'tir. init her yapılandırma dosyasını yazmadan önce yedekler. Yeni sunucuyu yüklemeleri için ardından Claude Code ve Cursor'u yeniden başlatın.
Firecrawl Local'i Claude Code'a elle ekleme
Bir aracın yapılandırmalarınızı düzenlemesine izin vermek istemiyorsanız, stdio sunucusunu Claude Code MCP komutuyla kendiniz ekleyin:
claude mcp add firecrawl -e FIRECRAWL_CLOUD=off -- ~/.cargo/bin/firecrawl-local mcp --public-only
Sunucunun bağlı olduğunu doğrulamak için Claude Code içinde /mcp komutunu çalıştırın.
Firecrawl Local'i Cursor'a elle ekleme
Cursor, MCP sunucularını ~/.cursor/mcp.json (genel) veya .cursor/mcp.json (tek proje) dosyasından okur. İkili dosyanın tam yolunu kullanın:
{
"mcpServers": {
"firecrawl": {
"command": "/Users/you/.cargo/bin/firecrawl-local",
"args": ["mcp", "--public-only"],
"env": { "FIRECRAWL_CLOUD": "off" }
}
}
}
--public-only, sunucunun localhost ve özel ağ adreslerini reddetmesini sağlar. Aracınız güvenmediğiniz sayfaları okuduğunda bunu açık tutun: aksi halde bir sayfadaki gizli talimatlar aracıyı dahili bir URL'ye yönlendirebilir.
Adım 4: Aracınıza vereceğiniz komutlar
firecrawl-local mcp, yerel API'yi bir loopback portunda başlatır ve firecrawl-mcp paketini ona karşı çalıştırır. Aracınız standart Firecrawl MCP araçlarını görür; kazıma, tarama, haritalama ve toplu kazıma makinenizde çalışır. Barındırılan Firecrawl MCP sunucusunu kullandıysanız araç adları aynıdır.
Yerel araçlara uygun komutlar:
Map https://docs.example.com, then crawl only the /api/ pages (limit 40)
and write a summary of every endpoint into docs/vendor-api.md.
Scrape the changelog at https://example.com/changelog as markdown and list
every breaking change from the last three releases.
Batch scrape these five pricing pages and build a comparison table of
plan names and limits. Quote only what the pages say.
Arama gerektiren komutları atlayın: FIRECRAWL_CLOUD=off ile o araç hiçbir yere gitmez. Tamamen yerel bir arama kurulumu için Claude için açık kaynak web araması rehberimize bakın.
Adım 5: Firecrawl Local API'yi çalıştırın ve SDK'nızı ona yönlendirin
Betikler ve iş akışları için API sunucusunu çalıştırın:
FIRECRAWL_CLOUD=off firecrawl-local serve
127.0.0.1:3002 üzerinde dinler. Sağlık kontrolü hemen yanıt verir:
curl -s localhost:3002/health
# {"status":"ok","engine":"firecrawl-local","version":"0.1.0"}
Bir kazıma, tanıdık v2 yapısını döndürür; içinde iki yerel işaret bulunur: "engine": "local-fetch" ve "source": "local" ile creditsUsed: 0.
curl -s localhost:3002/v2/scrape -H 'content-type: application/json' \
-d '{"url":"https://example.com","formats":["markdown","links"]}'
Firecrawl SDK'larını API anahtarı olmadan ona yönlendirin. Python:
from firecrawl import Firecrawl
app = Firecrawl(api_url="http://localhost:3002")
print(app.scrape("https://example.com").markdown)
Node:
import { Firecrawl } from "firecrawl";
const app = new Firecrawl({ apiUrl: "http://localhost:3002" });
const doc = await app.scrape("https://example.com");
console.log(doc.markdown);
init ayrıca bir kısayol önerir: FIRECRAWL_API_URL=http://127.0.0.1:3002 ayarlayın ve mevcut Firecrawl kodunuz yerelde çalışsın. Firecrawl CLI kayıtlı oturum açma bilgilerini Firecrawl Local ile paylaşır, böylece iki araçtan herhangi birinin login komutu ikisi için de çalışır.
Taramalar asenkron çalışır. POST /v2/crawl hemen bir iş kimliği döndürdü ve birkaç saniye sonra GET /v2/crawl/{id} status: completed, total: 10, creditsUsed: 0 ve expiresInSeconds: 3587 bildirdi. İşler bellekte yaşar, başladıktan bir saat sonra sona erer ve serve durduğunda kaybolur; bu nedenle sonuçları bir tarama tamamlanır tamamlanmaz kaydedin.
Sunucu süreci, ps ile ölçüldüğünde boşta yaklaşık 10 MB yerleşik bellekte ve 10 sayfalık o taramadan hemen sonra 43 MB'ta oturdu. Firecrawl'ın tanıtım gönderisi, kendi barındırılan Firecrawl'a kıyasla 37 kat daha hızlı ve 230 kat daha az bellek kullandığını iddia ediyor; README herhangi bir yöntem yayımlamıyor, bu yüzden bunları Firecrawl'ın kendi rakamları olarak kabul edin.
Firecrawl Local'i FIRECRAWL_CLOUD ile tamamen yerelde tutun
Varsayılan olarak (auto), üç şey Firecrawl Cloud'a gider: arama, makinenizi engelleyen sayfalar ve Alexandria veri sağlayıcıları (firecrawl-local login ile ücretsiz bir hesap gerektirir). FIRECRAWL_CLOUD bu devri kontrol eder:
| Değer | Etki |
|---|---|
auto (varsayılan) |
Arama, engellenen sayfa yedeği ve Alexandria ç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 kapalıyken POST /v2/search, "code":"CLOUD_ONLY" yanıtını ve FIRECRAWL_API_KEY ya da FIRECRAWL_CLOUD=auto ayarlamanızı söyleyen bir mesaj döndürür. Bulutun sizin için getirdiği bir sayfa "source": "firecrawl-cloud" taşır, böylece bir sonucun nereden geldiğini her zaman anlayabilirsiniz.
serve, --allow-private seçeneğini geçmediğiniz sürece localhost ve özel hedefleri reddeder ve loopback olmayan bir --host bağlamak --token gerektirir. Bulut üst verileri ve bağlantı-yerel adresler her modda engellenir.
Kodlama aracınızın Firecrawl Local API'yi Apidog CLI ile test etmesini sağlayın
Tarama uç noktası bir iş akışını bozma olasılığı en yüksek olanıdır: asenkron çalışır, iş sona erer ve durdurulan bir sunucu onu kaybeder. Elle yoklama yapmak yerine, kodlama aracınızın Apidog CLI ile bir test oluşturup çalıştırmasına izin verin.
Bir kez kurun:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Ardından Claude Code veya Cursor'a tek bir komut verin:
firecrawl-local serve is running on http://localhost:3002. In Apidog project <id>,
import an OpenAPI file for POST /v2/scrape, POST /v2/crawl and GET /v2/crawl/{id},
create an environment for that base URL, and build a test scenario that starts a
crawl of https://docs.firecrawl.dev with limit 10, saves the returned id, polls
GET /v2/crawl/{id} until status is "completed", and asserts total equals completed
and every page has non-empty markdown. Run it and summarize any failures.
Araç her yük şemasını okur, doğrular ve CLI 2.2.12'deki apidog <cmd> --help çıktısından alınan şu komutları çalıştırır:
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-scenario-create
apidog cli-schema validate test-scenario-create --file scenario.json
apidog test-scenario create --project <id> --file ./scenario.json
apidog run -t <scenarioId> --project <id> -e <envId> -r cli,json
Apidog CLI istekleri makinenizden gönderir, böylece localhost:3002 erişilebilir olur. Aynı çalıştırmayı CI'ya bırakmak için -r junit seçeneğine geçin; Claude Code'da Apidog CLI ve Cursor'da Apidog CLI rehberlerimiz aracı tarafını ele alır. Apidog'un Free planı 4 kullanıcıya kadar olan ekipleri kapsar.
Firecrawl Local sorun giderme
| Belirti | Çözüm |
|---|---|
/v1/scrape üzerinde NOT_FOUND ile 404
|
Yalnızca v2 sunuluyor; istemcinizi /v2/... olarak değiştirin |
/v2/search üzerinde CLOUD_ONLY
|
FIRECRAWL_CLOUD=off ile beklenen durum; auto ya da search kullanın |
| Araç Firecrawl araçlarını listelemiyor |
init sonrası aracı yeniden başlatın; Node.js 22+ sürümünü kontrol edin |
| JavaScript sayfası eksik geliyor | Chrome'u kurun veya --browser always ayarlayın |
json veya summary biçimi eksik |
Yerelde desteklenmez; bunun yerine bir uyarı alırsınız |
| Tarama kimliği bulunamadı | İş bir saat sonra sona erdi veya serve yeniden başladı |
SSS
Firecrawl Local ücretsiz mi? Yerel kazıma, tarama ve haritalama Firecrawl'a hiçbir şey göndermez ve testlerimizde 0 kredi kullandı. Kod AGPL-3.0; SDK'lar MIT. Arama ve Alexandria Firecrawl Cloud üzerinden gider.
Firecrawl Local'i kullanmak için API anahtarına ihtiyacım var mı? Hayır, yerel rotalar için gerekmez. Yalnızca Alexandria veri sağlayıcıları için firecrawl-local login veya FIRECRAWL_API_KEY aracılığıyla bir anahtara ihtiyacınız var.
Firecrawl Local Windsurf, Codex ve Gemini CLI ile çalışır mı? Evet. init, Claude Code, Claude Desktop ve Cursor'ın yanı sıra windsurf, codex ve gemini'yi de tanır.
Mevcut Firecrawl kodum değiştirmeden onun üzerinde çalışabilir mi? v2 scrape, map, crawl ve batch scrape için evet: API URL'sini http://localhost:3002 olarak değiştirin. v0 ve v1 rotaları sunulmaz ve tarayıcı actions işlemleri yok sayılır.
Firecrawl Local robots.txt'e uyuyor mu? Evet. Tararken robots.txt dosyasını okur ve User-Agent'ında kendini tanıtır, böylece site sahipleri ona FirecrawlLocal olarak hitap edebilir. --ignore-robots bunu kapatır; yalnızca sahibi olduğunuz sitelerde kullanın.


Top comments (0)