firecrawl-hello-world

Firecrawl Hello World to zestaw czterech minimalnych przykładów kodu pokazujących core API Firecrawl: scrape (pojedyncza strona), crawl (wiele stron), map (odkrywanie URL-i) i extract (strukturyzacja danych przez LLM). Każdy snippet jest gotowy do natychmiastowego uruchomienia. Używaj tej umiejętności gdy rozpoczynasz nową integrację z Firecrawl, testujesz konfigurację lub uczysz się podstawowych wzorców API. Kompatybilna z Claude Code, Codex i OpenClaw.

1. Zainstaluj bibliotekę Firecrawl dla Node.js poleceniem npm install @mendable/firecrawl-js w swoim projekcie.

2. Ustaw zmienną środowiskową FIRECRAWL_API_KEY na wartość Twojego klucza API z Firecrawl — bez tego kroku przykłady nie będą działać.

3. Zacznij od scrape (scrapowania pojedynczej strony): zaimportuj FirecrawlApp, utwórz instancję z Twoim kluczem API, a następnie wywołaj scrapeUrl() z adresem URL strony. Metoda zwraca markdown, HTML, metadane i linki — wyświetl je w konsoli aby zobaczyć strukturę odpowiedzi.

4. Przejdź do crawl (crawlowania wielu stron) gdy chcesz przejść całą witrynę: użyj crawlUrl() zamiast scrapeUrl(), ustaw limit na maksymalną liczbę stron (np. 10 aby zaoszczędzić kredyty), a następnie iteruj przez zwrócone dane aby zobaczyć tytuły i URL-e każdej strony.

5. Eksperymentuj z map (odkrywaniem URL-i) aby uzyskać listę wszystkich dostępnych stron na domenie bez ich scrapowania — przydatne do planowania crawlowania.

6. Przetestuj extract (ekstrakcję strukturyzowaną) gdy potrzebujesz wydobyć konkretne dane ze strony za pomocą LLM — każdy przykład pokazuje pełny przepływ od żądania do parsowania odpowiedzi.