🚀 Firecrawl MCP 服務器

Firecrawl MCP 服務器是一款強大的工具，藉助 Firecrawl API，可實現網絡爬取、內容搜索、網站抓取以及數據提取等功能，為用戶提供全面的網絡數據處理解決方案。

✨ 主要特性

網頁抓取：能夠從任意網頁中提取內容，還支持一系列自定義選項。
- 可模擬移動設備進行網頁訪問。
- 能有效攔截廣告和彈出窗口，避免干擾。
- 支持內容過濾，精準獲取所需信息。
- 可提取結構化數據，方便後續處理。
- 提供多種輸出格式，滿足不同需求。
內容搜索：具備智能搜索功能。
- 支持多語言搜索，適應不同語言環境。
- 能基於位置提供搜索結果。
- 可自定義結果限制，靈活控制輸出。
- 採用結構化輸出格式，便於查看和分析。
網站抓取：擁有高級網絡爬取功能。
- 可對爬取深度進行控制。
- 支持路徑過濾，精準定位目標頁面。
- 能設置速率限制，避免對目標網站造成過大壓力。
- 可跟蹤爬取進度，即時瞭解工作狀態。
- 支持網站地圖集成，提高爬取效率。
網站映射：可生成網站結構圖。
- 支持子域名映射。
- 具備搜索過濾功能，快速定位所需信息。
- 可進行鏈接分析，瞭解網站結構。
- 提供可視化層次結構，直觀展示網站架構。
數據提取：可從多個 URL 中提取結構化數據。
- 支持架構驗證，確保數據質量。
- 可進行批處理，提高提取效率。
- 能增強網站搜索功能。
- 支持自定義提取提示，滿足個性化需求。

📦 安裝指南

# 全局安裝
npm install -g @modelcontextprotocol/mcp-server-firecrawl

# 項目本地安裝
npm install @modelcontextprotocol/mcp-server-firecrawl

🚀 快速開始

獲取 API 密鑰：訪問 Firecrawl 官方網站並註冊以獲取你的 API 密鑰。

設置環境變量：

export FIRECRAWL_API_KEY='your_api_key_here'

安裝並運行服務器：

npm install @modelcontextprotocol/mcp-server-firecrawl
node index.js

📚 詳細文檔

集成

Claude Desktop App 集成

在 config.json 文件中添加以下內容以集成 Firecrawl：

{
  "firecrawl": {
    "apiKey": "your_api_key_here",
    "baseUrl": "https://api.firecrawl.com"
  }
}

VSCode 擴展集成

在擴展的配置文件中添加以下代碼：

import { fireCrawlSettings } from '@modelcontextprotocol/mcp-server-firecrawl';
fireCrawlSettings.apiKey = 'your_api_key_here';

錯誤處理

該服務器實現了健壯的錯誤處理：

帶有指數級回退的速率限制
自動重試
詳細錯誤消息
調試日誌

安全

API 密鑰保護
請求驗證
允許列表
速率限制
安全錯誤消息

開發

# 安裝依賴項
npm install

# 構建
npm run build

# 運行測試
npm test

# 在開發模式下啟動
npm run dev

示例

查看 examples 目錄中的更多使用示例：

基本抓取：scrape.ts
爬取和映射：crawl-and-map.ts

貢獻

請參考 CONTRIBUTING.md 瞭解貢獻指南。

💻 使用示例

基礎用法

const fireCrawl = require('@modelcontextprotocol/mcp-server-firecrawl');

async function basicScrape() {
  try {
    const result = await fireCrawl.scrape('https://example.com');
    console.log(result);
  } catch (error) {
    console.error(error.message);
  }
}

basicScrape();

高級用法

const fireCrawl = require('@modelcontextprotocol/mcp-server-firecrawl');

async function crawlAndMap() {
  try {
    const crawlResult = await fireCrawl.crawl('https://example.com');
    const mapResult = await fireCrawl.map(crawlResult.urls);
    console.log(mapResult);
  } catch (error) {
    console.error(error.message);
  }
}

crawlAndMap();