Firecrawl CLI Kurulumu ve Firecrawl CLI Kullanımı

Firecrawl CLI

Firecrawl CLI, yapay zeka ajanlarının ve geliştiricilerin temiz markdown, JSON, ekran görüntüleri ve daha fazlasıyla herhangi bir web sitesini doğrudan dosya sisteminize yazarak kazımasına, arama yapmasına, haritalandırmasına, taramasına ve tarayıcıları otomatikleştirmesine olanak tanıyan birleşik bir terminal aracıdır. Firecrawl CLI'yı npx firecrawl aracılığıyla (kuruluma gerek yok) çalıştırın veya global olarak kurun, ardından yeteneği otomatik olarak ekleyen tek bir firecrawl init komutuyla Claude Code, Cursor veya OpenCode'a bağlanın.

Yapay zeka ajanları ve geliştiriciler, kırılgan özel betikler veya engellenmiş istekler olmadan güvenilir, gerçek zamanlı web verilerine ihtiyaç duyduğu için Firecrawl CLI'yı yüklersiniz. Firecrawl CLI, kazımayı, web aramasını, site haritalandırmasını, özyinelemeli taramayı ve bulut tarayıcı oturumlarını tek bir terminal tabanlı araçta birleştirir. Temiz markdown, yapılandırılmış JSON, ekran görüntüleri veya HTML'i doğrudan dosya sisteminize çıktılar, böylece LLM'ler için token sayılarını düşük ve bağlamı hassas tutar. Claude Code, Cursor ve OpenCode gibi ajanlar, geleneksel araçların işleyemediği JavaScript ile işlenmiş sayfalardan, dinamik sitelerden veya korumalı akışlardan taze içerik çekmek için Firecrawl CLI'yı günlük olarak kullanır.

Sisteminizi hazırlarsınız, Firecrawl CLI'yı yüklersiniz, kimlik doğrulaması yaparsınız, temel komutları keşfedersiniz, ajanlarla entegre olursunuz ve en iyi uygulamaları uygularsınız. Firecrawl CLI, eşzamanlılığı, hız limitlerini ve yerel önbelleğe almayı otomatik olarak yönetir, böylece siz değerli verileri çıkarmaya odaklanırsınız. Firecrawl CLI'daki biçim seçiciler veya bekleme zamanlayıcıları gibi hassas bayrak seçimleri, çıktı kalitesi ve verimliliğinde önemli iyileşmeler sağlar.

Firecrawl CLI Ne Sunar ve Geleneksel Web Araçlarından Neden Daha İyi Performans Gösterir?

Firecrawl CLI, JavaScript'i bulut tarayıcılar aracılığıyla yerel olarak işler, anti-bot korumalarına saygı duyar ve cheerio tabanlı veya temel Puppeteer betiklerinin başarısız olduğu karmaşık sitelerde %80'den fazla içerik geri çağırma sağlar. Varsayılan olarak, genel ifadelerden arındırılmış, LLM için optimize edilmiş markdown alırsınız; bu da sonuçları ajanlara beslerken bağlam penceresi baskısını azaltır.

Firecrawl CLI, büyük yükleri akışla göndermek yerine dosyaları yerel olarak yazar, bu da kazınmış içerik üzerinde tekrarlanan API çağrıları olmadan bash destekli arama yapmayı sağlar. Firecrawl CLI kazıma, arama, haritalama, tarama ve tarayıcı komutlarını betiklerde veya ajan döngülerinde sorunsuz bir şekilde birleştirirsiniz. Bu yetenekler, ayrı kütüphanelere, başsız örneklere veya proxy rotasyonlarına olan ihtiyacı ortadan kaldırır. Firecrawl CLI'da --only-main-content gibi küçük kararlar, daha temiz, daha ucuz çıktılar sağlar ve büyük üretkenlik kazançlarına dönüşür.

Firecrawl CLI Kurulumundan Önce Ortamınızı Hazırlama

Node.js ≥18 sürümünü doğrulayın, çünkü Firecrawl CLI modern npm özelliklerine bağlıdır. Terminalinizde node --version komutunu çalıştırın. Gerekirse paket yöneticiniz veya nvm aracılığıyla güncelleyin.

Firecrawl CLI çıktılarını düzenlemek için bir çalışma alanı dizini oluşturursunuz:

mkdir firecrawl-cli-projects && cd firecrawl-cli-projects

Bu, dağınıklığı önler ve veri kümelerini git ile takip etmeyi kolaylaştırır. İsteğe bağlı olarak telemetriyi devre dışı bırakabilirsiniz:

export FIRECRAWL_NO_TELEMETRY=1

Ajanlar İçin Önerilen Init Yöntemi Kullanılarak Firecrawl CLI Kurulumu

En hızlı yol, Firecrawl CLI'yı kurar, kimlik doğrulaması yapar ve ajan yeteneklerini tek adımda ekler. Çalıştırın:

npx -y firecrawl-cli@latest init --all --browser

Firecrawl CLI, Firecrawl hesabına giriş (veya kayıt) için tarayıcınızı açar, API anahtarınızı güvenli bir şekilde oluşturur/saklar ve Claude Code, Cursor ve diğer uyumlu ajanlar için yetenekleri yapılandırır. Daha sonra ajanınızı yeniden başlatın, böylece yeni Firecrawl CLI yeteneklerini algılar. Bu yöntem, Firecrawl CLI'yı global olarak donatır ve MCP/sunucusuz tarayıcı erişimini etkinleştirir.

Sık Kullanım İçin npm Aracılığıyla Firecrawl CLI'ı Global Olarak Kurma

Projeler arasında kalıcı, düşük gecikmeli erişim için Firecrawl CLI'yı global olarak kurun:

npm install -g firecrawl-cli

Şununla doğrulayın:

firecrawl --version

Firecrawl CLI artık npx yükü olmadan herhangi bir dizinden anında yanıt verir.

Firecrawl CLI Kimlik Doğrulaması ve Yapılandırmanızı Kontrol Etme

Kimlik doğrulama, tam Firecrawl CLI özelliklerini açar. Çalıştırın:

firecrawl login

Firecrawl CLI tarayıcı tabanlı OAuth ister. Alternatif olarak, anahtarınızı manuel olarak ayarlayın:

export FIRECRAWL_API_KEY=fc-your-key-here

Durumu istediğiniz zaman kontrol edin:

firecrawl --status

Bu, kredileri, eşzamanlılık limitlerini ve kimlik doğrulama durumunu gösterir. Tam yapılandırmayı görüntüleyin:

firecrawl view-config

firecrawl logout ile hesapları değiştirin, sonra tekrar giriş yapın. Yerel/kendi barındırdığınız Firecrawl örnekleri için bulut kimlik doğrulamasını ve kredilerini atlamak üzere --api-url http://localhost:3002 kullanın.

Firecrawl CLI'da Scrape Komutunda Ustalaşma

Herhangi bir URL'den içerik şununla çıkarırsınız:

firecrawl scrape https://example.com --only-main-content

Firecrawl CLI temiz markdown döndürür ve -o output.md eklediğinizde ./output.md konumuna kaydeder. Navigasyon, reklamlar ve kenar çubuklarını kaldırmak için her zaman --only-main-content'i tercih edin, bu token kullanımını önemli ölçüde azaltır.

Birden çok format isteyin:

firecrawl scrape https://example.com --format markdown,json,html,links,images --pretty

Firecrawl CLI istenen tüm verileri içeren yapılandırılmış JSON çıktısı verir. Ekran görüntüleri yakalayın: --screenshot veya --full-page-screenshot. Yavaş yükleyicileri --wait-for 5000 ile ele alın.

Hassas bir şekilde filtreleyin:

firecrawl scrape https://docs.example.com --include-tags main,article --exclude-tags nav,footer,script

Performansı karşılaştırmak için --timing ekleyin. Firecrawl CLI sonuçları yerel olarak saklar, piping veya ajan alımı için hazırdır.

Firecrawl CLI ile Web Araması Yapma

İnternette arama yapar ve en iyi sonuçları birlikte kazırsınız:

firecrawl search "latest AI agent benchmarks" --scrape --limit 8 --scrape-formats markdown

Firecrawl CLI sonuçları alır, içeriği çıkarır ve dosyaları kaydeder. Yeniliğe göre --tbs qdr:w, konuma veya kaynak türüne göre filtreleyin. Daha derin doğrulama için aramayı tarayıcı oturumlarıyla birleştirin. Bu nedenle Firecrawl CLI, tek bir araçta tam araştırma döngülerini destekler.

Firecrawl CLI Kullanarak Web Sitelerini Haritalama

Derinlemesine çıkarma yapmadan önce tüm URL'leri keşfedin:

firecrawl map https://example.com -o sitemap.json

Firecrawl CLI metadata ile yapılandırılmış bir liste döndürür. Filtrelenmiş URL'leri kazıma veya tarama komutlarına besleyin. Firecrawl CLI, robots.txt'ye ve nazik taramaya otomatik olarak uyar.

Firecrawl CLI ile Tüm Siteleri Özyinelemeli Olarak Tarama

Kapsamlı bir şekilde tarayın:

firecrawl crawl https://example.com --wait --progress -o crawl-output.json

Firecrawl CLI dahili bağlantıları takip eder, sayfaları kazır ve her şeyi yerel olarak saklar. Maliyetleri yönetmek için derinliği, maksimum sayfa sayısını ve eşzamanlılığı kontrol edin. Gerçek zamanlı ilerleme raporlaması, büyük işleri izlemenize veya iptal etmenize olanak tanır.

Firecrawl CLI'da Tarayıcı Oturumlarını Otomatikleştirmek

Bulut tarayıcılarla etkileşimli akışları yönetin:

firecrawl browser launch-session

Firecrawl CLI bir oturum kimliği döndürür. Eylemleri yürütün:

firecrawl browser execute "open https://news.ycombinator.com" --session <id>
firecrawl browser execute "click .titleline > a" --session <id>
firecrawl browser execute "scrape" --session <id>

Firecrawl CLI dinamik etkileşimlerden sonra tıklamaları, yazmayı, gezinmeyi ve çıkarmayı destekler. Kaynakları serbest bırakmak için oturumları kapatın. Firecrawl CLI, karmaşık Puppeteer kodunu basit, ajan tarafından okunabilir komutlarla değiştirir.

Gelişmiş Firecrawl CLI Yapılandırması ve Global Bayraklar

Kalıcı olarak özelleştirin:

firecrawl config --api-url https://your-custom-endpoint --concurrency 5

Firecrawl CLI bunları her çalıştırmada uygular. JSON çıktısını global olarak zorlayın veya başlıkları ayarlayın. Büyük işlemlerden önce kredileri --status ile izleyin. Kesintisiz oturumlar için FIRECRAWL_API_KEY'i kabuk profilinize aktarın.

Firecrawl CLI'ı Yapay Zeka Kodlama Ajanları ile Entegre Etme

Firecrawl CLI yeteneğini bir kez kurun (npx -y firecrawl-cli@latest init --all) ve ajanlar onu otomatik olarak keşfedecektir. CLI + Beceriler modunda, ajanlar gerektiğinde Firecrawl CLI komutlarını açıkça çalıştırır. MCP modunda, ajanlar yerel araçları görünmez bir şekilde çağırır.

Firecrawl CLI, ham içerik yerine yerel dosya yolları döndürür, bu da az yer kaplayan bağlam pencerelerini korur. Bu nedenle ajanlar, ek istemler olmadan güvenilir web araştırması yapabilirler.

Firecrawl CLI Sorunlarını Verimli Bir Şekilde Giderme

Kimlik doğrulama başarısız mı oldu? firecrawl login komutunu tekrar çalıştırın. Hız limitlerine mi ulaşıldı? Eşzamanlılığı azaltın veya plan yükseltmeleri için kontrol panelini kontrol edin. JS ağırlıklı sitelerde boş sonuçlar mı alıyorsunuz? --wait-for süresini artırın veya --only-main-content'i etkinleştirin. Tanılamalar için --timing kullanın. Anahtarları değiştirirken firecrawl logout ile kimlik bilgilerini temizleyin.

Firecrawl CLI'dan En İyi Verimi Almak İçin En İyi Uygulamalar

Gürültüsüz markdown için her zaman --only-main-content'i dahil edin. Açıklayıcı çıktı dosya adları ve özel klasörler kullanın. Tam taramadan önce küçük kapsamları test edin. Arama → haritalama → tarama ardışık düzenlerini birleştirin. Tekrarlanabilir veri kümeleri için çıktı dizinlerini sürüm kontrolüne alın. Verimli kalmak için haftalık kredi kullanımını gözden geçirin. Bu alışkanlıklar Firecrawl CLI'yı hızlı, uygun maliyetli ve güvenilir tutar.

Apidog ile Firecrawl CLI İş Akışlarını Tamamlama

Apidog'u ücretsiz indirin ve Firecrawl uç noktalarını (kazıma, arama, tarama vb.) koleksiyonlara aktarın. Apidog istekleri görselleştirir, Firecrawl CLI API anahtarınızı bir değişken olarak saklar, yanıtları taklit eder ve otomatik testler çalıştırır. Terminal yürütmesinden önce karmaşık Firecrawl CLI seçeneklerini veya özel yükleri hata ayıklarsınız. Firecrawl CLI + Apidog, uçtan uca güven sağlar: güncel web verileri ve doğrulanmış API davranışı.

Sonuç

Artık Firecrawl CLI'ın kurulum ve kimlik doğrulamasından gelişmiş kazıma, arama, haritalama, tarama ve tarayıcı otomasyonuna kadar her yönüne hakimsiniz. Firecrawl CLI, kaotik web erişimini hem ajanlara hem de geliştiricilere güç veren temiz, terminal öncelikli bir ardışık düzene dönüştürür.

Bugün init komutunu çalıştırın, bir kazımayı test edin ve oradan ilerleyin. Firecrawl CLI, dikkatli bayrak kullanımı ve deneyleri dramatik şekilde daha iyi sonuçlarla ödüllendirir.

Firecrawl CLI testlerinizi ve API doğrulamanızı süper şarj etmek için Apidog'u şimdi ücretsiz indirin. Firecrawl CLI'yı kurun, Firecrawl CLI'yı kullanın ve gerçek zamanlı web ustalığının kilidini açın.

Ek Kaynaklar

• Firecrawl CLI dokümantasyonu → https://docs.firecrawl.dev/sdks/cli
• Firecrawl ana sitesi → https://www.firecrawl.dev
• GitHub deposu → https://github.com/firecrawl/cli
• API referansı → https://docs.firecrawl.dev/api-reference
• Kontrol Paneli / API anahtarı → https://app.firecrawl.dev
• Apidog ücretsiz API istemcisi → https://apidog.com