firecrawl-advanced-troubleshooting

Skill do głębokich diagnostyki problemów Firecrawl, które nie poddają się standardowym metodom. Używaj gdy scrapowanie zwraca puste treści, zadania crawlingu się zawieszają, wyniki ekstrakcji są niespójne lub webhooki nie dostarczają danych. Narzędzie prowadzi cię przez systematyczną izolację problemu warstwa po warstwie — od testów podstawowych po zaawansowaną analizę. Idealne do przygotowania zestawu dowodów dla zespołu wsparcia Firecrawl.

1. Zainstaluj skill w swoim środowisku Claude Code lub Codex, dodając go do listy dostępnych umiejętności. Upewnij się, że masz dostęp do narzędzi Read, Grep i Bash z uprawnieniami do curl i node.

2. Wyzwól skill frazą zawierającą słowa kluczowe takie jak "firecrawl hard bug", "firecrawl mystery error", "firecrawl impossible to debug", "firecrawl deep debug" lub "firecrawl not scraping". Opisz problem — na przykład że scrapowanie zwraca puste wyniki, zadanie crawlingu się zawiesza lub webhooki nie działają.

3. Przygotuj minimalny przypadek reprodukcji. Skill poprowadzi cię przez testy podstawowe: sprawdzenie czy Firecrawl w ogóle scrape'uje, testowanie konkretnego adresu URL, dodanie czasu oczekiwania na rendering JavaScript (parametr waitFor). Każdy test pokaże czy problem jest w konfiguracji, domenie czy logice.

4. Analizuj wyniki każdego testu — długość zwróconej treści, flagi sukcesu, komunikaty błędów. Skill pomoże ci izolować warstwę problemu: czy to API, sieć, JavaScript, czy sama domena.

5. Zbieraj dowody: logi z testów, konfiguracje żądań, odpowiedzi API. Skill ułatwi przygotowanie pełnego zestawu informacji potrzebnych do eskalacji do zespołu wsparcia Firecrawl.

6. Iteruj testy z różnymi parametrami — zmień formaty wyjścia, dodaj opóźnienia, testuj różne adresy URL. Skill wspiera Node.js i curl, więc możesz testować zarówno z kodu jak i z linii poleceń.