用途:在不泄露 API 密钥或抓取内容的前提下,分层诊断 Firecrawl v2 集成失败,区分 Firecrawl 传输故障、目标站点行为与下游解析缺陷,每次只改动一个变量。
主要能力:将结果归类为请求校验、认证、额度、速率/并发、渲染、源站响应、抽取/模式、保留策略冲突或下游处理;对不同环节分别取证;按官方错误目录判定可重试状态,遵循 Retry-After 并使用有界抖动退避;保留原始幂等决策;可输出逐层诊断、最小复现、重试分类、脱敏证据、根因或剩余假设、修复方案、金丝雀结果与回滚条件。
使用方式:先记录客户端包、解析版本、运行时、端点族、请求类、请求或任务 ID 及首次失败时间;用最小输出格式和单一公开或合成 URL 复现;对照当前 v2 schema,逐个移除可选动作、请求头、代理、JSON 抽取与缓存覆盖;异步任务检查队列状态、任务状态、分页游标、爬取错误和终态;用 metadata.statusCode 区分被捕获的源站错误页与 Firecrawl 请求失败;仅对官方标记可重试的状态重试;逐项恢复选项并在金丝雀上验证最小修复,最后生成脱敏证据收据。
认证:已认证的 Cloud 操作应从批准的密钥管理器注入 FIRECRAWL_API_KEY,REST 使用 Authorization: Bearer;不得打印、提交、传输密钥或将其放入 URL。无密钥访问仅在当前文档明确允许且负载可接受其限制时使用。
工具与审批边界:用 Read、Glob、Grep 检查代码、配置、测试和证据,仅在批准的实现或文档变更中使用 Write/Edit;不得仅因调用本技能就调用 Firecrawl、轮换密钥、更改账户设置、抓取目标或部署。测试私有或已认证目标、更改代理或位置策略、提高爬取上限、放宽保留控制、轮换密钥或将证据发送给 Firecrawl 支持前,均需审批。
限制:资料未提供具体端点、SDK 方法、套餐限制、价格、保留选项或自托管版本细节,使用前应查阅官方 Firecrawl 文档。证据可能暴露内容或凭据时,应以哈希、大小、状态和不可读 ID 替代。