firecrawl-sdk-patterns

Skill dostarcza production-ready wzorce kodowania dla FireCrawl SDK w TypeScript i Python. Obejmuje singleton client, typizowane wrappery, retry z exponential backoff, walidację odpowiedzi oraz reusable scraping services. Użyj go podczas implementacji integracji FireCrawl, refaktoryzacji kodu lub ustalania standardów kodowania w zespole. Kompatybilny z Claude Code, Codex i OpenClaw.

1. Zainstaluj wymagane pakiety: @mendable/firecrawl-js dla TypeScript lub firecrawl-py dla Pythona, wraz z zależnościami async/await.

2. Utwórz plik konfiguracyjny singleton client (np. src/firecrawl/client.ts), który inicjalizuje FirecrawlApp z API key z zmiennej środowiskowej FIRECRAWL_API_KEY. Skill pokazuje, jak bezpiecznie zarządzać instancją klienta i obsługiwać błędy braku klucza.

3. Zdefiniuj typizowany wrapper dla operacji scrape (np. src/firecrawl/scrape.ts), który zwraca strukturyzowany rezultat zawierający URL, tytuł, markdown, linki i timestamp. To zapewnia konsystentny interfejs w całej aplikacji.

4. Wyzwól skill frazami takimi jak "firecrawl SDK patterns", "firecrawl best practices", "firecrawl code patterns", "idiomatic firecrawl" lub "firecrawl wrapper", aby uzyskać konkretne przykłady kodu.

5. Implementuj retry logic z exponential backoff dla niezawodności — skill zawiera wzorce obsługi timeout'ów i błędów sieciowych.

6. Rozszerz wzorce na reusable scraping services, które mogą być używane w wielu miejscach projektu, utrzymując DRY principle i ułatwiając testowanie.