MCP Firecrawl サーバー

これは、Firecrawl の API を使用して Web サイトをスクレイピングし、構造化データを抽出するためのツールを提供するシンプルな MCP サーバーです。

設定

依存関係をインストールします:

npm install

次の変数を含む.envファイルをルートディレクトリに作成します。

FIRECRAWL_API_TOKEN=your_token_here SENTRY_DSN=your_sentry_dsn_here

FIRECRAWL_API_TOKEN (必須): Firecrawl APIトークン
SENTRY_DSN (オプション): エラー追跡とパフォーマンス監視用の Sentry DSN

サーバーを起動します。

npm start

あるいは、サーバーの実行時に環境変数を直接設定することもできます。

FIRECRAWL_API_TOKEN=your_token_here npm start

Related MCP server: MCP Server Firecrawl

特徴

ウェブサイトスクレイピング：さまざまな形式でウェブサイトからコンテンツを抽出します
構造化データ抽出:カスタムスキーマに基づいて特定のデータポイントを抽出します
エラー追跡: エラー追跡とパフォーマンス監視のために Sentry と統合されています

使用法

サーバーは 2 つのツールを公開します。

scrape-website : 複数のフォーマットオプションを備えた基本的なウェブサイトスクレイピング
extract-data : プロンプトとスキーマに基づく構造化データ抽出

ツール: scrape-website

このツールは、Web サイトをスクレイピングし、要求された形式でそのコンテンツを返します。

パラメータ:

url (文字列、必須): スクレイピングするウェブサイトのURL
formats (文字列の配列、オプション): 希望する出力形式の配列。サポートされている形式は以下のとおりです。
- "markdown" （デフォルト）
- "html"
- "text"

MCP Inspector の使用例:

# Basic usage (defaults to markdown) mcp-inspector --tool scrape-website --args '{ "url": "https://example.com" }' # Multiple formats mcp-inspector --tool scrape-website --args '{ "url": "https://example.com", "formats": ["markdown", "html", "text"] }'

ツール: データ抽出

このツールは、提供されたプロンプトとスキーマに基づいて、Web サイトから構造化データを抽出します。

パラメータ:

urls （文字列の配列、必須）: データを抽出するURLの配列
prompt （文字列、必須）：抽出するデータを説明するプロンプト
schema (オブジェクト、必須): 抽出するデータのスキーマ定義

スキーマ定義は、キーがフィールド名、値が型であるオブジェクトである必要があります。サポートされる型は次のとおりです。

"string" : テキストフィールドの場合
"boolean" : true/falseフィールド用
"number" : 数値フィールドの場合
配列: ["type"]として指定されます。type は上記のいずれかです。
オブジェクト: 独自の型定義を持つネストされたオブジェクト

MCP Inspector の使用例:

# Basic example extracting company information 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" } }' # Complex example with nested data mcp-inspector --tool extract-data --args '{ "urls": ["https://example.com/products", "https://example.com/pricing"], "prompt": "Extract product information including name, price, and features.", "schema": { "products": [{ "name": "string", "price": "number", "features": ["string"] }] } }'

どちらのツールも、スクレイピングまたは抽出が失敗した場合に適切なエラーメッセージを返し、設定されている場合は自動的に Sentry にエラーを記録します。