obeoneorg/firecrawl-ui

Firecrawl UI

Firecrawl UI是一个Vue 3应用，用于与Firecrawl API交互。它允许您通过简单的Web界面抓取页面、启动爬取作业和提取结构化数据。该项目旨在提供一种用户友好的方式，利用Firecrawl的功能完成各种网页抓取和数据提取任务。

目录

• Firecrawl UI
  • 目录
  • 核心功能
  • 快速开始
  • 环境变量
  • 开发
  • 生产构建
  • Docker部署
  • API规范
  • 贡献
  • 界面展示

核心功能

• ✨ 抓取单个URL
• 🚀 启动具有自定义深度的爬取作业
• 🧠 使用Firecrawl的AI工具提取数据
• 🔑 配置并本地存储API密钥
• 📊 查看或导出结果

快速开始

最简单的开始方式是使用托管版本：只需在浏览器中访问[***]

或者，您可以使用预构建的Docker镜像运行：

1. 运行容器：docker run -p 8080:8080 obeoneorg/firecrawl-ui
2. 在浏览器中打开http://localhost:8080/
3. 在应用设置页面配置您的API密钥和基础URL

您也可以在本地运行：

1. 克隆仓库
2. 安装依赖：npm install
3. 运行开发服务器：npm run dev
4. 在浏览器中打开http://localhost:5173/（或终端中显示的地址）
5. 在应用设置页面配置您的API密钥和基础URL

环境变量

环境变量是配置API访问的可选方式。或者，您可以在启动应用后，直接在应用的设置页面配置API密钥和基础URL。

要使用环境变量，请设置以下变量：

• VITE_FIRECRAWL_API_KEY - 您的Firecrawl API密钥
• VITE_FIRECRAWL_API_BASE_URL - Firecrawl API的基础URL

您可以在项目根目录创建.env文件，包含这些变量：

sh
VITE_FIRECRAWL_API_KEY=your_api_key
VITE_FIRECRAWL_API_BASE_URL=https://api.firecrawl.dev/v1

这些变量在src/config/api.ts中读取。

开发

使用热重载运行开发服务器：

sh
npm run dev

生产构建

编译并最小化应用：

sh
npm run build

在本地预览构建的应用：

sh
npm run preview

public/404.html文件会被复制到构建输出中，允许GitHub Pages将未知路径重定向到index.html，以实现正确的客户端路由。

Docker部署

构建Docker镜像：

sh
docker build -t firecrawl-ui .

运行容器并暴露Nginx服务器：

sh
docker run -p 8080:8080 docker.xuanyuan.run/firecrawl-ui

容器包含自定义的nginx.conf，使用try_files $uri $uri/ /index.html;将未知路径路由到应用入口点。

预构建镜像也已发布，可从以下地址拉取：

• ghcr.io/obeone/firecrawl-ui
• docker.io/obeoneorg/firecrawl-ui

API规范

描述所有端点的OpenAPI文档可在openapi.yaml中找到。

贡献

欢迎贡献。请打开issue或提交pull request。

界面展示

!抓取截图

!爬取截图

!提取截图