SuperAPI AI 工具集

firecrawl-hello-world

数据与分析

查看项目

更新于 10-15 23:25

技能介绍

用途:验证当前 Firecrawl v2 接口能否成功抓取一个受控页面,并确认返回文档确实来自预期 URL,而非来源错误页。

主要能力:提供 Node、Python 与 REST 三种调用路径。Node 安装 firecrawl 并导入命名客户端调用 scrape;Python 安装 firecrawl-py 并导入 Firecrawl 调用 scrape;REST 使用 POST https://api.firecrawl.dev/v2/scrape 加 Bearer 认证。SDK 直接返回文档数据,REST 则包在 success 与 data 中。

使用方式:选择已批准的公开或合成 URL,记录预期标题或标记;用仓库锁定的包管理器安装官方 SDK 或改用 REST;认证场景从密钥管理器注入 FIRECRAWL_API_KEY,REST 请求头使用 Authorization: Bearer。首次测试只请求 markdown,避免 actions、自定义头、截图、原始 HTML、location、代理覆盖和保留策略变更。断言 metadata.sourceURL、metadata.statusCode、非空 markdown 与预期标记,不打印完整正文。记录延迟、cacheState、creditsUsed、SDK/API 表面和脱敏后结果大小。

适用场景:新集成冒烟测试、SDK 版本与接口表面核对、凭据注入方式验证。

限制与边界:密钥不得打印、提交、传输或放入 URL;无密钥访问仅在当前文档明确允许且工作负载接受其限制时使用。使用私有 URL、站点凭据或请求头、保留响应、转为周期任务前需审批。401 时检查密钥注入;来源状态为 403 或 404 时内容断言失败;标记缺失时不要盲目放宽选项。依赖端点、SDK 方法、套餐限制、价格、保留选项或自托管版本前,应先查阅官方 Firecrawl 文档。