firecrawl-core-workflow-a

Execute FireCrawl primary workflow: Core Workflow A.\nUse when implementing primary use case,\nbuilding main features, or core integration tasks.\nTrigger with phrases like \

1. Zainstaluj pakiet Firecrawl: upewnij się, że w twoim projekcie jest zainstalowana biblioteka @mendable/firecrawl-js oraz że masz ustawioną zmienną środowiskową FIRECRAWL_API_KEY z kluczem API z serwisu Firecrawl.

2. Zainicjalizuj klienta Firecrawl: utwórz instancję FirecrawlApp, przekazując klucz API z zmiennej środowiskowej. Ta instancja będzie używana do wszystkich żądań pobierania i crawlowania.

3. Dla pojedynczej strony użyj scrapeUrl: wywołaj metodę scrapeUrl z adresem URL strony, którą chcesz pobrać. Ustaw opcję onlyMainContent na true, aby automatycznie usunąć nawigację, stopki i paski boczne. Dodaj waitFor z czasem oczekiwania (np. 2000 ms), jeśli strona wymaga renderowania JavaScript.

4. Dla całej witryny użyj crawlUrl: jeśli chcesz pobrać wiele powiązanych stron, użyj crawlUrl zamiast scrapeUrl. Ustaw limit na maksymalną liczbę stron do pobrania (np. 50) i maxDepth na głębokość przeszukiwania (np. 3 poziomy). Firecrawl automatycznie będzie śledzić linki i renderować JavaScript na każdej stronie.

5. Przetwórz wynik: sprawdź pole success w zwróconej odpowiedzi. Jeśli operacja się powiodła, dostęp do metadanych (tytuł, źródłowy URL) oraz do zawartości markdown. Markdown zawiera czystą, sformatowaną treść gotową do dalszego przetwarzania przez modele AI.

6. Obsługuj asynchroniczne crawlowanie: dla dużych witryn Firecrawl może zwrócić identyfikator zadania zamiast natychmiastowego wyniku. W takim przypadku użyj polling, aby regularnie sprawdzać status zadania, aż do jego ukończenia i pobrania pełnego wyniku.