firecrawl-advanced-troubleshooting

Apply FireCrawl advanced debugging techniques for hard-to-diagnose issues.\nUse when standard troubleshooting fails, investigating complex race conditions,\nor preparing evidence bundles for FireCrawl support escalation.\nTrigger with phrases like \

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ń.