Firecrawl

🚀 MCP Firecrawl 服務器

MCP Firecrawl 服務器是一個簡單的MCP服務器，提供使用Firecrawl API進行網站抓取和結構化數據提取的工具，能幫助用戶高效地從網站獲取所需內容和數據。

🚀 快速開始

本服務器提供了便捷的使用方式，您可以按照以下步驟快速啟動並使用。

📦 安裝指南

1. 安裝依賴：

npm install

2. 在根目錄下創建一個.env文件，並添加以下變量：

FIRECRAWL_API_TOKEN=your_token_here
SENTRY_DSN=your_sentry_dsn_here

• FIRECRAWL_API_TOKEN（必需）：您的Firecrawl API令牌
• SENTRY_DSN（可選）：Sentry DSN用於錯誤跟蹤和性能監控

3. 啟動服務器：

npm start

或者直接通過命令行設置環境變量啟動服務器：

FIRECRAWL_API_TOKEN=your_token_here npm start

✨ 主要特性

• 網站抓取：從網站提取內容，支持多種格式
• 結構化數據提取：根據自定義模式提取特定數據點
• 錯誤跟蹤：集成Sentry進行錯誤跟蹤和性能監控

💻 使用示例

基礎用法

服務器提供了兩個工具：

1. scrape-website：基本網站抓取，支持多種輸出格式
2. extract-data：基於提示和模式的結構化數據提取

工具：scrape-website

此工具抓取網站並返回所需格式的內容。

參數：

• url（字符串，必需）：要抓取的網站URL
• formats（字符串數組，可選）：所需輸出格式的數組。支持格式包括：
  • "markdown"（默認）
  • "html"
  • "text"

示例使用MCP Inspector：

# 基本用法（默認為Markdown）
mcp-inspector --tool scrape-website --args '{
  "url": "https://example.com"
}'

# 多種格式
mcp-inspector --tool scrape-website --args '{
  "url": "https://example.com",
  "formats": ["markdown", "html", "text"]
}'

工具：extract-data

此工具根據提供的提示和模式，從網站中提取結構化數據。

參數：

• urls（字符串數組，必需）：要提取數據的URL列表
• prompt（字符串，必需）：描述要提取的數據的提示
• schema（對象，必需）：定義要提取的數據模式

模式定義是一個對象，鍵為字段名稱，值為類型。支持的類型包括：

• "string"：文本字段
• "boolean"：布爾值（true/false）
• "number"：數字
• 數組：指定為 ["type"]，其中 type 是上述任一類型
• 對象：嵌套對象，具有自己的類型定義

示例使用MCP Inspector：

# 基本示例提取公司信息
mcp-inspector --tool extract-data --args '{
  "urls": ["https://example.com"],
  "prompt": "Extract the company mission, whether it supports SSO, and whether it is open source.",
  "schema": {
    "company_mission": "string",
    "supports_sso": "boolean",
    "is_open_source": "boolean"
  }
}'

# 複雜示例提取嵌套數據
mcp-inspector --tool extract-data --args '{
  "urls": ["https://example.com"],
  "prompt": "Extract detailed user information including name, age, and address.",
  "schema": {
    "user": {
      "name": "string",
      "age": "number",
      "address": {
        "street": "string",
        "city": "string",
        "country": "string"
      }
    }
  }
}'

📚 詳細文檔

故障排除

1. 確保已正確設置API令牌和Sentry DSN（如果使用）。
2. 檢查網絡連接，確保可以訪問目標網站。
3. 查看控制檯輸出或日誌文件以獲取更多錯誤信息。