firecrawl-webhooks-events
Installation
SKILL.md
Firecrawl Webhooks & Events
Overview
Handle Firecrawl webhooks for real-time notifications on async crawl and batch scrape jobs. Instead of polling checkCrawlStatus, configure a webhook URL and Firecrawl will POST events as pages are scraped and jobs complete. Signed with HMAC-SHA256 via X-Firecrawl-Signature.
Webhook Event Types
| Event | Trigger | Payload |
|---|---|---|
crawl.started |
Crawl job begins | Job ID, config |
crawl.page |
Individual page scraped | Page markdown, metadata |
crawl.completed |
Full crawl finishes | All pages array |
crawl.failed |
Crawl job errors | Error message |
batch_scrape.completed |
Batch scrape finishes | All scraped pages |
Instructions
Step 1: Start Crawl with Webhook
import FirecrawlApp from "@mendable/firecrawl-js";