Firecrawl MCP サーバー
Firecrawl API を使用して Web スクレイピング、コンテンツ検索、サイト クロール、およびデータ抽出を行うための Model Context Protocol (MCP) サーバー。
特徴
- Webスクレイピング: カスタマイズ可能なオプションを使用して、任意のWebページからコンテンツを抽出します
- モバイルデバイスのエミュレーション
- 広告とポップアップのブロック
- コンテンツフィルタリング
- 構造化データ抽出
- 複数の出力形式
- コンテンツ検索：インテリジェントな検索機能
- 多言語サポート
- 位置情報に基づく結果
- カスタマイズ可能な結果制限
- 構造化された出力形式
- サイトクロール：高度なウェブクロール機能
- 深度制御
- パスフィルタリング
- レート制限
- 進捗状況の追跡
- サイトマップの統合
- サイトマッピング: サイト構造マップを生成する
- サブドメインのサポート
- 検索フィルタリング
- リンク分析
- 視覚的な階層
- データ抽出: 複数の URL から構造化データを抽出します
- スキーマ検証
- バッチ処理
- ウェブ検索の強化
- カスタム抽出プロンプト
インストール
# Global installation
npm install -g @modelcontextprotocol/mcp-server-firecrawl
# Local project installation
npm install @modelcontextprotocol/mcp-server-firecrawl
クイックスタート
- 開発者ポータルからFirecrawl APIキーを取得します
- API キーを設定します:Unix/Linux/macOS (bash/zsh):
export FIRECRAWL_API_KEY=your-api-key
set FIRECRAWL_API_KEY=your-api-key
$env:FIRECRAWL_API_KEY = "your-api-key"
# Install dotenv
npm install dotenv
# Create .env file
echo "FIRECRAWL_API_KEY=your-api-key" > .env
import dotenv from 'dotenv';
dotenv.config();
- サーバーを実行します。
統合
クロードデスクトップアプリ
MCP 設定に追加:
{
"firecrawl": {
"command": "mcp-server-firecrawl",
"env": {
"FIRECRAWL_API_KEY": "your-api-key"
}
}
}
クロード VSCode 拡張機能
MCP 構成に追加:
{
"mcpServers": {
"firecrawl": {
"command": "mcp-server-firecrawl",
"env": {
"FIRECRAWL_API_KEY": "your-api-key"
}
}
}
}
使用例
ウェブスクレイピング
// Basic scraping
{
name: "scrape_url",
arguments: {
url: "https://example.com",
formats: ["markdown"],
onlyMainContent: true
}
}
// Advanced extraction
{
name: "scrape_url",
arguments: {
url: "https://example.com/blog",
jsonOptions: {
prompt: "Extract article content",
schema: {
title: "string",
content: "string"
}
},
mobile: true,
blockAds: true
}
}
サイトクロール
// Basic crawling
{
name: "crawl",
arguments: {
url: "https://example.com",
maxDepth: 2,
limit: 100
}
}
// Advanced crawling
{
name: "crawl",
arguments: {
url: "https://example.com",
maxDepth: 3,
includePaths: ["/blog", "/products"],
excludePaths: ["/admin"],
ignoreQueryParameters: true
}
}
サイトマッピング
// Generate site map
{
name: "map",
arguments: {
url: "https://example.com",
includeSubdomains: true,
limit: 1000
}
}
データ抽出
// Extract structured data
{
name: "extract",
arguments: {
urls: ["https://example.com/product1", "https://example.com/product2"],
prompt: "Extract product details",
schema: {
name: "string",
price: "number",
description: "string"
}
}
}
構成
詳細なセットアップ オプションについては、構成ガイドを参照してください。
APIドキュメント
エンドポイントの詳細な仕様については、 API ドキュメントを参照してください。
発達
# Install dependencies
npm install
# Build
npm run build
# Run tests
npm test
# Start in development mode
npm run dev
例
さらなる使用例については、例のディレクトリを確認してください。
エラー処理
サーバーは堅牢なエラー処理を実装しています。
- 指数バックオフによるレート制限
- 自動再試行
- 詳細なエラーメッセージ
- デバッグログ
安全
- APIキーの保護
- リクエストの検証
- ドメイン許可リスト
- レート制限
- 安全なエラーメッセージ
貢献
貢献ガイドラインについてはCONTRIBUTING.md を参照してください。
ライセンス
MIT ライセンス - 詳細についてはライセンスを参照してください。