利用可能なツール
1. Scrape ツール (firecrawl_scrape)
redactPIIを含めます。
2. Map ツール (firecrawl_map)
Map Tool のオプション:
url: マッピング対象の Web サイトのベース URLsearch: URL を絞り込むための任意の検索語sitemap: サイトマップの使用方法を指定 - “include”、“skip”、または “only”includeSubdomains: マッピングにサブドメインを含めるかどうかlimit: 返す URL の最大数ignoreQueryParameters: マッピング時にクエリパラメータを無視するかどうか
3. Search Tool (firecrawl_search)
Search Tool のオプション:
query: 検索クエリ文字列 (必須)limit: 返す検索結果の最大数location: 検索結果の地理的ロケーションtbs: 期間ベースの検索フィルター (例: 過去1日はqdr:d、過去1週間はqdr:w、過去1か月はqdr:m)filter: 追加の検索フィルターsources: 検索対象のソースタイプの配列 (web、images、news)scrapeOptions: 検索結果ページのスクレイピングオプションenterprise: エンタープライズオプションの配列 (default、anon、zdr)
4. Parse Tool (firecrawl_parse)
FIRECRAWL_API_URL を使用して Firecrawl API インスタンスに対し Firecrawl MCP をローカルで実行する場合、MCP Server は filePath を直接読み取り、ファイルのバイト列を /v2/parse に送信できます。
リモートのホスト型 MCP Server を使用する場合、ホスト型サーバーはお使いのマシン上のファイルを読み取れません。その場合、firecrawl_parse はリモートのキーなし URL でも機能する、2 段階の受け渡しを使用します。
filePathを指定してfirecrawl_parseを呼び出します。ツールは、あらかじめ入力されたアップロードコマンドと、uploadRefを含むnextToolCallを返します。- ファイルを読み取れるマシンでアップロードコマンドを実行し、返された
uploadRefを指定して再度firecrawl_parseを呼び出します。
Parse Tool のオプション:
filePath: 解析するファイルのローカルパスです。最初の呼び出しで使用します。uploadRef: 最初のホスト型 MCP 呼び出しで返される参照です。アップロード成功後の 2 回目の呼び出しで使用します。formats: 出力フォーマットです。デフォルトはmarkdownです。parsers: PDF 解析オプションなど、パーサーを制御します。contentType: 任意で指定できるファイルの MIME タイプのオーバーライドです。declaredSizeBytes: 任意のファイルサイズの目安です。ファイルサイズは 50 MB までです。
firecrawl_scrape を使用してください。URL 上のドキュメントを検出して解析します。
5. クロールツール (firecrawl_crawl)
6. クロールのステータスを確認 (firecrawl_check_crawl_status)
7. Extract Tool (firecrawl_extract)
Extract Tool のオプション:
urls: 情報を抽出する URL の配列prompt: LLM による抽出用のカスタムプロンプトschema: 構造化データ抽出用の JSON スキーマallowExternalLinks: 外部リンクからの抽出を許可enableWebSearch: 追加のコンテキストを得るためにウェブ検索を有効化includeSubdomains: 抽出対象にサブドメインを含める
8. エージェント Tool (firecrawl_agent)
firecrawl_agent_statusをポーリングします。
エージェント Tool のオプション:
prompt: 必要なデータを自然言語で記述します (必須、最大10,000文字)urls: エージェント が特定のページに集中できるようにする任意の URL 配列schema: 構造化された出力のための任意の JSON schema
firecrawl_agent_status を使用します。
9. エージェント Status の確認 (firecrawl_agent_status)
エージェント Status のオプション:
id:firecrawl_agentが返す エージェント job ID (必須)
processing: エージェント はまだリサーチ中です — ポーリングを続けてくださいcompleted: リサーチが完了しました — レスポンスに抽出データが含まれますfailed: エラーが発生しました
10. ページを操作する (firecrawl_interact)
urlを渡すと、1回のMCP呼び出しで新しいページを開いて操作できます。- 以前の
firecrawl_scrape呼び出しで取得したscrapeIdを渡すと、すでに読み込まれているページを再利用できます。
url と scrapeId を同時に渡さないでください。prompt または code のいずれかを指定してください。scrapeOptions は url モードでのみ使用できます。
URLモードの例:
Interact ツールのオプション:
url: 操作するページ。セッションを開きます。これまたはscrapeIdを使用します。scrapeId: 以前のfirecrawl_scrape呼び出しで取得したスクレイピングジョブ ID。これまたはurlを使用します。prompt: 実行する操作を説明する自然言語の指示。promptまたはcodeを指定します。code: ブラウザセッションで実行するコード。codeまたはpromptを指定します。language:bash、python、またはnode(任意。デフォルトはnode。codeでのみ使用) 。timeout: 実行タイムアウト (秒単位) 。1~300 (任意。デフォルトは30) 。scrapeOptions:urlモードでのみ使用する任意のスクレイピング制御。
11. Interact セッションを停止 (firecrawl_interact_stop)
Interact 停止オプション:
scrapeId: 停止するセッションのスクレイピング ID (必須)
ロギングシステム
- オペレーションのステータスと進行状況
- パフォーマンス指標
- クレジット使用量の監視
- レート制限の追跡
- エラー状態
エラーハンドリング
- 一時的なエラーの自動再試行
- バックオフによるレート制限への対応
- 詳細なエラーメッセージ
- クレジット使用量に関する警告
- ネットワーク障害への耐性

