Skip to main content

Vercel Marketplace

从 Vercel Marketplace 安装 Firecrawl,将其关联到项目,并在你的 Vercel 应用中使用注入的 FIRECRAWL_API_KEY。
1 min read

Firecrawl 提供原生的 Vercel Marketplace 集成。安装后,它会为你的 Vercel 项目配置 Firecrawl,并自动将 FIRECRAWL_API_KEY 添加到项目环境变量中。

如果你希望通过 Vercel 完成 Firecrawl 的计费、API 密钥设置和项目配置,请参考本指南。

集成的作用#

当你通过 Vercel Marketplace 安装 Firecrawl 时,Vercel 会将 Firecrawl 连接到所选项目,并将 API 密钥作为环境变量提供给你。

  • 通过 Marketplace 流程创建 Firecrawl 账户并提供 API 密钥
  • FIRECRAWL_API_KEY 添加到你的 Vercel 项目环境变量中
  • 将 Firecrawl 的计费保留在你的 Vercel 账单中
  • 集成连接后,你可以直接从 Vercel 打开 Firecrawl
Note

如果你已经有 Firecrawl API 密钥,并且想手动配置 Vercel,请改用 Vercel Functions 快速入门

从 Vercel 安装#

  1. 打开 Vercel Marketplace 上的 Firecrawl 页面
  2. 点击 连接账户
  3. 选择你想使用的 Firecrawl 套餐。
  4. 选择要接收该环境变量的 Vercel 项目。
  5. 完成安装流程。

安装完成后,重新部署你的项目,以便 Vercel Functions 和框架的服务器端代码能够读取新的环境变量。

安装 SDK#

在你的 Vercel 项目中安装 Firecrawl Node SDK:

无需将 API 密钥粘贴到代码中。请在服务端读取 process.env.FIRECRAWL_API_KEY

抓取网页#

app/api/scrape/route.ts 中创建一个路由处理程序:

部署完成后,测试该路由:

进行网页搜索#

当你的应用需要最新的网页搜索结果以及页面内容时,使用 search

与动态页面交互#

当应用需要在提取内容前先点击、滚动或填写表单时,请使用 interact

Note

较长时间的交互可能会超过较短的无服务器超时时限。对于在生产环境中可能耗时更久的工作流,请将这类工作放到后台任务中运行,或使用 Firecrawl 的异步 API 并配合 Webhook。

将 Firecrawl 与 Vercel AI SDK 结合使用#

如果你在使用 Vercel AI SDK 构建代理,请安装 Firecrawl AI SDK 工具:

然后将 Firecrawl 工具传给你的模型。通过 Marketplace 安装的 FIRECRAWL_API_KEY 会从环境变量中读取。

Note

以下示例使用 Vercel AI Gateway 的模型字符串格式。请分别配置你的 AI SDK 模型提供商或 AI Gateway 凭证。

后续步骤#