SuperAPI AI 工具集

firecrawl-ci-integration

部署与运维

查看项目

更新于 10-15 23:25

技能介绍

用途:为 Firecrawl v2 集成建立确定性的 CI 门禁,在常规 PR 流程中验证请求构造、响应处理、分页、脱敏、重试与策略执行,且不消耗额度、不暴露生产目标。

主要能力:固定经评审的 Firecrawl v2 OpenAPI 或 SDK 提交用于契约测试;区分 SDK 直接数据响应与 REST success/data 信封;将可重试性、Webhook 事件名、分页游标作为契约断言而非宽松快照;创建合成夹具,覆盖抓取文档、来源错误页、分页爬取与批量结果、校验失败、402、403、429 及可重试服务端错误;为请求构造、爬取上限、URL 策略、脱敏、缓存与保留选项、Retry-After 解析、有界重试、取消与幂等编写单元测试;对不可信 PR 仅用假凭证运行静态分析、单元测试、契约测试、密钥扫描与产物检查。

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

用法与边界:用 Read/Glob/Grep 检查代码、配置、测试与证据,Write/Edit 仅用于获准的实现或文档改动;不得因调用本技能而调用 Firecrawl、轮换密钥、更改账户、抓取目标或部署。新增依赖、更新契约固定版本、启用联网 CI、授予 CI 密钥、更改必需检查或保留实时响应前需审批。若确需实时验证,仅设一个只读合成金丝雀,置于受保护环境,对 fork 禁用,限制额度与时长并丢弃响应正文。失败要 fail closed,并输出含契约固定版本与测试结果的凭据。

限制:官方文档未提供具体价格、额度、计划限制或自托管发布细节;使用前应查阅当前官方 Firecrawl 证据。