用途：当 Firecrawl API 或 SDK 调用失败时，依据其公布的错误目录，把错误翻译成安全的处置动作，避免对所有非成功响应盲目重试，也避免把返回的文档状态误当成 API 传输故障。
主要能力：区分可重试与需修正的错误。当前可重试状态码为 408、429、500、502、503、504，422 为条件性。认证、额度不足、受限和请求结构错误需先修正，而非重试。需采集 HTTP 状态、错误字符串、可选 code/details、请求或任务 ID、操作、时间戳、SDK 版本及脱敏后的请求结构；检查返回文档的 metadata.statusCode，被捕获的 403/404 页面消耗的是结果路径，不应按 API 传输错误处理。
使用方式：401 检查密钥注入与密钥选择，不打印密钥；402 停止工作，将额度或计费决策交由负责人；403 检查套餐权益、团队归属、端点或格式密钥限制、IP 限制及策略控制，不得用另一个未受控密钥绕过；429 区分限流与并发压力，遵守 Retry-After，减少生产者；可重试的超时或服务器故障使用有界指数退避加抖动，随后带脱敏 ID 与时间戳升级。认证操作用 FIRECRAWL_API_KEY，REST 使用 Authorization: Bearer，密钥不得打印、提交、传输或放入 URL。无密钥访问仅在当前文档明确允许且工作负载接受其限制时适用。
适用场景：排查 400/422 请求校验问题、认证与额度问题、限流与并发、超时与服务器故障，以及识别成功抓取中携带来源错误状态的情况。
限制：是否调用 Firecrawl、轮换密钥、修改账户设置、抓取目标或部署，均不因调用本技能而自动执行；轮换凭证、开启按量付费、升级套餐、放宽密钥或 IP 限制、提高并发、向支持共享目标细节，均需事先批准。未知错误应保留原始状态与错误字符串并对照当前文档。资料未提供具体价格、套餐额度与保留策略，需以官方文档为准。