SuperAPI AI 工具集

firecrawl-local-dev-loop

编程与开发

查看项目

更新于 10-15 23:25

技能介绍

用途:让 Firecrawl 相关开发保持离线、可重复,避免日常测试依赖真实网络与生产密钥;只有需要端到端行为时才启用自托管。

主要能力:为 scrape、crawl 提交/状态、batch、map/search 等定义类型化适配器接口,使测试不 mock 内部实现;为直接 SDK 文档、REST 信封、源站错误页、分页任务、限流、额度、策略拒绝、无效抽取、webhook 签名等建立合成夹具;默认对假实现运行单元与契约测试,禁止生产密钥、真实客户 URL、抓取正文和外部网络访问。

使用方式:先检查应用运行时、官方 SDK 版本、包装边界、测试框架与实际调用的操作;再定义适配器接口并创建合成夹具;需要端到端时按当前官方自托管指南在其固定版本上、于可信本地网络运行,不要自创单容器替代方案;单独验证就绪状态与一次 /v2/scrape,记录不支持的功能,用后拆除或隔离评估栈;保持锁文件、夹具、契约固定版本与本地设置说明最新,修复缺陷前先加回归测试。

认证:Cloud 操作从批准的密钥管理器注入 FIRECRAWL_API_KEY,REST 使用 Authorization: Bearer,禁止打印、提交、传输密钥或把密钥放入 URL;无密钥访问仅在当前文档明确允许且工作负载接受其限制时使用。

限制与边界:当前自托管指南固定特定已验证版本,API 暴露在 localhost 3002,首次运行基线禁用数据库认证,明确缺少生产认证、持久存储、TLS、高可用及若干 Cloud 能力,使用前须重读其发布与 Compose 契约。启动 Docker 服务、下载新版本、本地测试使用 Cloud、抓取真实页面或保留自托管数据库前需审批。工具纪律上仅用 Read、Glob、Grep 检查,Write/Edit 仅用于获批改动,不得因调用本技能就调用 Firecrawl、轮换密钥、改账户、抓取目标或部署。输出应包含适配器边界、夹具清单、应运行命令、契约固定版本、自托管能力缺口、测试结果、网络/密钥态势与清理状态。错误处理:夹具偏离固定契约应经评审更新而非取自生产载荷;自托管栈在可信主机外可达应停止并修正网络控制;需要 Cloud 专属功能应使用受保护测试环境而非假装本地对等。具体价格、计划限制、保留选项等事实资料未提供。