SuperAPI AI 工具集

firecrawl-webhooks-events

通用与其它

查看项目

更新于 10-15 23:25

技能介绍

用途:把 Firecrawl 的 Webhook 当作进入持久化状态机的已认证投递提示。先验证再解析或产生副作用,及时确认接收,并在漏投后通过状态 API 核对。

主要能力:支持当前文档列出的事件,包括 crawl.started/page/completed、batch_scrape.started/page/completed、extract.started/completed/failed、agent.started/action/completed/failed/cancelled、monitor.page 和 monitor.check.completed。Firecrawl 用 HMAC-SHA256 对原始请求体签名,头为 X-Firecrawl-Signature,格式 sha256=hex。端点需在 10 秒内返回 2xx;失败投递在 1、5、15 分钟后重试,之后停止。

使用方式:注册 HTTPS 端点,只选工作流所需事件,将账户 Webhook 密钥存入受批密钥管理器。在任何 JSON 解析前捕获原始请求体,要求单个 X-Firecrawl-Signature 值,校验 sha256 前缀,安全地十六进制解码,并以时序安全方式比较等长摘要。缺失、格式错误或不匹配的签名应在解析、记录、排队或修改状态前被拒绝,未设置密钥不得视为验证成功。验证后解析信封,允许列表精确事件类型与模式,绑定到预期团队/任务,并按 webhookId 加事件/任务上下文去重。持久化收件箱记录并在期限内返回 2xx,异步处理内容与下游写入,保证租户隔离与幂等。按文档事件族处理页面与终态事件,不要等待不存在的 crawl.failed 或 batch_scrape.failed,而应核对任务状态与分页。

适用场景:需要异步接收 Firecrawl 各流程事件的集成,如爬取进度跟踪、批量抓取、结构化提取和监控检查。

限制:涉及创建端点、存储密钥、添加自定义头/元数据、保留页面负载、重放生产事件或更改事件过滤需先获批准。调用本技能本身不应触发调用 Firecrawl、轮换密钥、更改账户设置、抓取目标或部署。签名或原始体不可用时返回非 2xx 且无副作用;确认后处理失败应从持久化收件箱重试并核对提供方状态;重试耗尽或终态事件缺失时轮询文档化任务状态并分页。端点、SDK 方法、套餐限制、价格、保留选项或自托管发布等事实,资料未提供具体内容,应以官方 Firecrawl 文档为准。