firecrawl-webhooks-events
Obsługuj webhooki Firecrawl i otrzymuj powiadomienia o postępie scrapowania w czasie rzeczywistym.
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do obsługi zdarzeń webhook z serwisu Firecrawl. Zamiast odpytywać status crawlingu, skonfiguruj endpoint webhook, a Firecrawl będzie wysyłać powiadomienia w miarę scrapowania stron i zakończenia zadań. Obsługuje walidację podpisu HMAC-SHA256 oraz zdarzenia takie jak rozpoczęcie crawlingu, scrapowanie pojedynczej strony, ukończenie zadania i błędy. Idealny do asynchronicznego przetwarzania wyników scrapowania w czasie rzeczywistym.
Jak używać
Zainstaluj skill w swoim środowisku Claude Code, Codex lub OpenClaw. Upewnij się, że masz dostęp do klucza API Firecrawl (zmienna środowiskowa FIRECRAWL_API_KEY).
Przygotuj endpoint webhook na swoim serwerze, który będzie odbierać żądania POST od Firecrawl. Endpoint powinien być dostępny publicznie, np. https://twoja-aplikacja.com/webhooks/firecrawl.
Uruchom crawl z parametrem webhook, przekazując adres URL swojego endpointu. Możesz użyć prostej formy (webhook jako string) lub zaawansowanej (webhook jako obiekt z metadanymi i filtrowaniem zdarzeń).
Firecrawl będzie wysyłać zdarzenia do Twojego endpointu: crawl.started (początek), crawl.page (pojedyncza strona), crawl.completed (koniec), crawl.failed (błąd) lub batch_scrape.completed (batch). Każde zdarzenie zawiera odpowiedni payload z danymi.
Zaimplementuj walidację podpisu HMAC-SHA256 na podstawie nagłówka X-Firecrawl-Signature, aby upewnić się, że żądania pochodzą od Firecrawl.
Przetwarzaj zdarzenia asynchronicznie w swoim endpoincie — zapisuj dane do bazy, aktualizuj interfejs użytkownika lub wyzwalaj dalsze akcje na podstawie typu zdarzenia i zawartości payload'u.