用途:在定义可观测等价性之后,将现有抓取工作负载迁移到 Firecrawl v2,并保留旧适配器直到新路径通过内容、策略、性能与恢复等门槛。
主要能力:梳理旧来源、登录/会话行为、选择器与动作、发现规则、格式、解析器、重试、代理、调度、存储、合规控制、指标与运营成本;建立源到 Firecrawl 的能力映射,标记不支持、仅云端、依赖自托管、行为变化与策略敏感项;定义适配器契约与带来源、归一化内容哈希、必填字段覆盖、延迟、成本与可接受差异的黄金合成语料;在功能开关后实现最小 v2 路径;在获批金丝雀上影子运行两条路径并比较内容与元数据;分阶段切换流量;回滚到期后移除旧代码与密钥并归档证据。
使用方式:认证的云端操作从批准的密钥管理器注入 FIRECRAWL_API_KEY,REST 请求使用 Authorization: Bearer;不得打印、提交、传输密钥或把密钥放入 URL。无密钥访问仅在当前文档明确允许且工作负载接受其限制时使用。用 Read、Glob、Grep 检查代码、配置、测试与证据,仅在获批实现或文档变更时使用 Write/Edit。重放认证会话、改变目标行为或代理、启用仅云端处理、增加支出、切换流量或删除旧路径前需审批。
适用场景:替换文档爬虫等需先映射发现、渲染、过滤、重试与索引再影子运行的工作负载。
限制:一个端点不等同于所有旧工作流,Scrape、Crawl、Map、Batch、Parse、JSON 提取、Actions、Browser 与 Cloud/自托管能力契约和成本不同。必需行为无 Firecrawl 等价物时应保留旧组件或明确重新设计;影子输出含敏感差异时隔离比较并使用无内容指标;无法测量等价性时阻止迁移,不能仅凭目视检查。依赖端点、SDK 方法、计划限制、价格、保留选项或自托管版本前应阅读官方 Firecrawl 证据。