用途：把 Firecrawl 封装在应用自有的窄接口之后，避免供应商变更、策略、重试和测试逻辑扩散到整个代码库。
主要能力：Node 使用 firecrawl 安装面提供的命名 Firecrawl 客户端，Python 使用 firecrawl-py 中的 Firecrawl。当前 v2 顶层方法包括 scrape、crawl、startCrawl、getCrawlStatus、map、batchScrape、startBatchScrape、getBatchScrapeStatus、search、parse 以及 agent 相关接口；功能冻结的 v1 位于单独的兼容边界之后。
使用方式：先检查运行时、官方包及解析版本、编译设置、现有 HTTP/客户端层和所需操作；定义仅含获批字段的应用请求/结果类型，包含显式范围/限制、来源、原始状态、终态和分页元数据；在每个进程边界用校验过的配置构造一个客户端并注入服务与测试；将供应商文档和错误映射为可区分的结果模型，区分 API 失败、原始错误、校验拒绝、部分结果和取消；仅在阻塞符合截止时间时暴露等待方法，否则暴露提交/状态/取消及持久分页；集中处理有界重试、策略、脱敏、指标和版本报告，不要用 any 或字典式透传抹掉 SDK 类型；添加合成契约测试，通过锁文件固定依赖，并记录升级与回滚流程。
认证：云操作从批准的密钥管理器注入 FIRECRAWL_API_KEY，REST 请求使用 Authorization: Bearer；切勿打印、提交、传输密钥或将其放入 URL。无密钥访问仅在当前文档明确允许且工作负载接受其限制时适用。
限制与边界：新增/升级 SDK、暴露新操作、放宽类型、更改重试策略或让领域代码直接接受供应商响应前需获得批准。文档与已安装类型不一致时先固定证据再编码；缺少必需结果字段时返回类型化的部分/失败状态而非编造默认值；v1 与 v2 混用时隔离旧兼容并制定迁移计划。调用本技能本身不应触发实际调用 Firecrawl、轮换密钥、更改账户设置、抓取目标或部署。