firecrawl-webhooks-events
Implement FireCrawl webhook signature validation and event handling.\nUse when setting up webhook endpoints, implementing signature verification,\nor handling FireCrawl event notifications securely.\nTrigger with phrases like \
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Implement FireCrawl webhook signature validation and event handling.\nUse when setting up webhook endpoints, implementing signature verification,\nor handling FireCrawl event notifications securely.\nTrigger with phrases like \
How to use
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.