DEV Community

Cover image for Firecrawl CLI Kurulumu ve Firecrawl CLI Kullanımı
Tobias Hoffmann
Tobias Hoffmann

Posted on • Originally published at apidog.com

Firecrawl CLI Kurulumu ve Firecrawl CLI Kullanımı

#ai #cli #tutorial #webscraping

Firecrawl CLI

Firecrawl CLI, yapay zeka ajanları ve geliştiriciler için temiz markdown, JSON, ekran görüntüleri ve daha fazlasını doğrudan dosya sisteminize kaydederek herhangi bir web sitesini kazımanıza, aramanıza, haritalandırmanıza, taramanıza ve tarayıcıları otomatikleştirmenize olanak tanıyan birleşik bir terminal aracıdır. npx firecrawl komutuyla kurulum gerektirmeden hemen kullanmaya başlayabilir veya global olarak kurabilirsiniz. firecrawl init komutuyla Claude Code, Cursor veya OpenCode gibi ajanlara kolayca entegre olabilirsiniz.

Apidog'u bugün deneyin

Yapay zeka ajanları ve geliştiriciler, özel betiklerin kırılganlığıyla veya engellenen isteklerle uğraşmadan güvenilir, gerçek zamanlı web verilerine ihtiyaç duyar. Firecrawl CLI, kazıma, web araması, site haritalandırma, özyinelemeli tarama 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 çıktısı ile LLM'ler için token kullanımını optimize eder. Claude Code, Cursor ve OpenCode gibi ajanlar, JavaScript ile işlenmiş dinamik sayfalardan veya korumalı akışlardan içerik çekmek için Firecrawl CLI'yı günlük olarak kullanır.

💡 İpuçu: İlk Firecrawl CLI komutunuzu çalıştırmadan önce Apidog'u ücretsiz edinin. Firecrawl CLI'ın arka planda kullandığı Firecrawl API uç noktalarını görsel olarak test edin ve hata ayıklayın; ajan entegrasyonlarınızda zamandan kazanın.

Sisteminizi hazırlayın, Firecrawl CLI'yı yükleyin, kimlik doğrulama yapın, temel komutları keşfedin ve ajanlarla entegre ederek en iyi uygulamaları hayata geçirin. Firecrawl CLI; eşzamanlılık, hız limiti ve yerel önbelleğe almayı otomatik yönetir. Biçim seçiciler veya bekleme zamanlayıcıları gibi hassas bayraklar çıktı kalitesini ve verimliliği artırır.

Firecrawl CLI'nın Avantajları

  • JavaScript'i bulut tarayıcılar üzerinden işler, anti-bot korumalarına saygı duyar ve karmaşık sitelerde yüksek içerik erişimi sağlar.
  • LLM için optimize edilmiş, sade markdown çıktı ile bağlam penceresini verimli kullanır.
  • Kazınan içerikler yerel dosya olarak saklanır; tekrar API çağrısı yapmadan bash ile arama yapabilirsiniz.
  • Kazıma, arama, haritalama ve tarama işlemlerini script ve ajan döngülerinize kolayca entegre edin.
  • --only-main-content gibi opsiyonlar ile çıktınızı temiz ve odaklı tutun.

Firecrawl CLI Kurulumu: Adım Adım

1. Ortamınızı Hazırlayın

Node.js ≥18 sürümünün yüklü olduğundan emin olun:

node --version
Enter fullscreen mode Exit fullscreen mode

Güncellemeniz gerekiyorsa, paket yöneticisi veya nvm kullanabilirsiniz.

Çıktılar için bir çalışma dizini oluşturun:

mkdir firecrawl-cli-projects && cd firecrawl-cli-projects
Enter fullscreen mode Exit fullscreen mode

İsteğe bağlı olarak telemetriyi devre dışı bırakmak için:

export FIRECRAWL_NO_TELEMETRY=1
Enter fullscreen mode Exit fullscreen mode

2. Firecrawl CLI'yı Kurun ve Agent İçin Init Yöntemini Kullanın

Tek adımda kurulum, kimlik doğrulama ve ajan entegrasyonu için:

npx -y firecrawl-cli@latest init --all --browser
Enter fullscreen mode Exit fullscreen mode

Bu komut, tarayıcıda giriş sağlar, API anahtarınızı oluşturur ve Claude Code, Cursor gibi ajanlarda Firecrawl yeteneklerini otomatik olarak tanımlar. Ajanınızı yeniden başlatarak yeni entegrasyonu algılamasını sağlayın.

3. Firecrawl CLI'yı Global Olarak Kurun (Opsiyonel)

Projeler arası hızlı erişim için:

npm install -g firecrawl-cli
firecrawl --version
Enter fullscreen mode Exit fullscreen mode

4. Kimlik Doğrulama & Yapılandırma

Kimlik doğrulama ile tam özellikleri açın:

firecrawl login
Enter fullscreen mode Exit fullscreen mode

Alternatif olarak, API anahtarınızı manuel olarak ayarlayın:

export FIRECRAWL_API_KEY=fc-your-key-here
Enter fullscreen mode Exit fullscreen mode

Durumu kontrol edin:

firecrawl --status
firecrawl view-config
Enter fullscreen mode Exit fullscreen mode

Hesap değiştirmek için:

firecrawl logout
Enter fullscreen mode Exit fullscreen mode

Kendi barındırdığınız örnekler için:

firecrawl --api-url http://localhost:3002
Enter fullscreen mode Exit fullscreen mode

Temel Firecrawl CLI Komutları

Scrape: Web Sayfası Kazıma

Bir URL'den ana içeriği çıkarmak için:

firecrawl scrape https://example.com --only-main-content
Enter fullscreen mode Exit fullscreen mode

Sonucu dosyaya kaydetmek için:

firecrawl scrape https://example.com --only-main-content -o output.md
Enter fullscreen mode Exit fullscreen mode

Birden fazla formatta çıktı alın:

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

Ekran görüntüsü almak için:

firecrawl scrape https://example.com --screenshot
Enter fullscreen mode Exit fullscreen mode

Belirli etiketleri dahil/dışla:

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

Zamanlamaları görmek için:

firecrawl scrape https://example.com --timing
Enter fullscreen mode Exit fullscreen mode

Search: Web Araması & Sonuç Kazıma

İnternette arama yapıp sonuçları kazıyın:

firecrawl search "latest AI agent benchmarks" --scrape --limit 8 --scrape-formats markdown
Enter fullscreen mode Exit fullscreen mode

Map: Site Haritası Çıkartma

Bir sitenin URL haritasını çıkarın:

firecrawl map https://example.com -o sitemap.json
Enter fullscreen mode Exit fullscreen mode

Crawl: Tüm Siteyi Özyinelemeli Olarak Tarama

Sitenin tümünü derinlemesine tarayın:

firecrawl crawl https://example.com --wait --progress -o crawl-output.json
Enter fullscreen mode Exit fullscreen mode

Derinlik, maksimum sayfa ve eşzamanlılık parametrelerini ayarlayarak kontrol sağlayın.

Browser: Bulut Tarayıcı Oturumları

Etkileşimli oturum başlatın ve işlemleri yürütün:

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

Oturumları sonlandırarak kaynakları serbest bırakmayı unutmayın.

Firecrawl CLI'nın Gelişmiş Yapılandırması

API URL'si ve eşzamanlılık gibi global ayarları belirleyin:

firecrawl config --api-url https://your-custom-endpoint --concurrency 5
Enter fullscreen mode Exit fullscreen mode

JSON çıktısını veya özel başlıkları zorlayabilirsiniz. Uzun işlemlerden önce --status ile kredilerinizi kontrol edin. FIRECRAWL_API_KEY'i profil dosyanıza yazarak sürekli oturum sağlayın.

Firecrawl CLI ile Ajan Entegrasyonu

Bir kez yetenek kurulumunu gerçekleştirin:

npx -y firecrawl-cli@latest init --all
Enter fullscreen mode Exit fullscreen mode

Ajanlarınız, Firecrawl CLI komutlarını otomatik olarak algılayacak ve kullanacaktır. CLI + Skills modunda açıkça, MCP modunda ise arka planda çalışır. Firecrawl CLI, ham içerik yerine dosya yolu döndürerek bağlamı optimize eder.

Sorun Giderme

  • Kimlik doğrulama problemi: firecrawl login komutunu tekrar çalıştırın.
  • Hız limitine takıldınız: Eşzamanlılığı azaltın veya planınızı kontrol edin.
  • JS ağırlıklı sitelerde boş sonuç: --wait-for süresini artırın veya --only-main-content kullanın.
  • Anahtar değişimi: firecrawl logout ile temizleyin.

En İyi Uygulamalar

  • Gürültüsüz çıktı için her zaman --only-main-content ekleyin.
  • Açıklayıcı dosya adları ve özel klasörler kullanın.
  • Büyük işlemlerden önce küçük örneklerle test yapın.
  • Arama → haritalama → tarama ardışık düzenini kullanın.
  • Çıktı dizinlerini sürüm kontrolüne alın.
  • Haftalık kredi kullanımınızı izleyin.

Apidog ile Firecrawl CLI İş Akışlarını Güçlendirin

Apidog'u ücretsiz edinin ve Firecrawl uç noktalarını koleksiyonlara aktarın. API anahtarınızı değişken olarak saklayın, yanıtları simüle edin ve otomatik testler çalıştırın. Terminalde karmaşık komutları çalıştırmadan önce Apidog ile görsel test ve hata ayıklama yapabilirsiniz. Böylece hem güncel web verileri hem de doğrulanmış API davranışı ile uçtan uca güven elde edersiniz.

Sonuç

Artık Firecrawl CLI'nın kurulumundan gelişmiş kazıma, arama, haritalama ve tarayıcı otomasyonuna kadar tüm adımlarına hakimsiniz. Firecrawl CLI, web erişimini geliştiriciler ve ajanlar için terminal odaklı, güvenilir bir iş akışı haline getirir.

Bugün init komutunu çalıştırarak başlayın, bir kazıma işlemi test edin ve çıktılarınızı geliştirin. Doğru bayraklar ve testlerle Firecrawl CLI'dan maksimum verimi alın.

Firecrawl CLI testlerinizi ve API doğrulamanızı hızlandırmak için Apidog'u şimdi ücretsiz deneyin. Firecrawl CLI'yı kurun, kullanın ve gerçek zamanlı web verisiyle projelerinizi güçlendirin.

Ek Kaynaklar

Top comments (0)