ターミナルから直接、検索、スクレイピング、Interact、クロール、マッピング、エージェントジョブの実行を行えます。Firecrawl CLIは単体でも動作し、Codex、Claude Code、Cursor、OpenCodeのようなAIコーディングエージェントが自動的に検出して利用できるスキルと組み合わせて使うこともできます。
インストール#
Codex、Claude Code、Cursor、OpenCode のような AI エージェントを使用している場合は、以下の Firecrawl スキル をインストールすると、エージェントがセットアップしてくれます。
--allはエージェントの選択をスキップし、検出されたすべてのエージェントを初期化します--browserは Firecrawl の認証のためにブラウザを自動的に開きます
スキル をインストールした後、新しい スキル を認識させるためにエージェントを再起動してください。
npm を使って Firecrawl CLI をグローバルに手動でインストールすることもできます。
認証#
CLIを使用する前に、Firecrawl APIキーで認証する必要があります。
一部のCLIコマンドはログインなしで利用できます。 APIキーが設定されていない場合、対応しているコマンドはAPIキー不要のFreeティアに自動的に切り替わります。無料で使えますが、IPごとにレート制限があります。現在のAPIキー不要コマンドの一覧と注意事項については、Rate Limitsを参照してください。1,000 クレジットとより高い上限を利用するには、無料のキーに登録してください。設定後は、CLI が自動的にそのキーを使用します。
ログイン#
設定の表示#
ログアウト#
CLI をセルフホスト版 Firecrawl に接続する#
まず、セルフホスティングガイドに従って、スクレイピングが 1 回正常に実行できる状態にします。次に、--api-url または FIRECRAWL_API_URL で CLI の接続先 API を指定します。
https://api.firecrawl.dev ではなくカスタム API URL を使用すると、CLI は Firecrawl Cloud API キー認証をスキップします。これは、USE_DB_AUTHENTICATION=false を設定する信頼済みネットワーク向け Quickstart と同じ動作です。
認証なしの API は、信頼済みネットワーク上でのみ運用してください。認証 プロキシやその他のアクセス制御レイヤーを追加する場合は、この方法に依存する前に、 CLI がそのレイヤーで必要な認証情報を送信できることを確認してください。
CLI で呼び出せるのは、デプロイ環境で有効になっている機能のみです。Cloud 専用またはプロバイダー依存のコマンドを使用する前に、セルフホスト版の機能サポートを確認してください。
ステータスの確認#
インストールと認証が正しく行われているかを確認し、レート制限も確認します。
準備完了時の出力:
- 同時実行数 (Concurrency): 並列に実行できるジョブの最大数。この上限付近まで並列処理を行ってもよいが、超えないようにする。
- クレジット (Credits): 残りの API クレジット数。各
scrape/crawlはクレジットを消費する。
コマンド#
隠し firecrawl browser コマンドは、エージェント ワークフローでは非推奨です。まず firecrawl scrape <url> を実行し、その後、得られたスクレイピングセッションで firecrawl interact ... を使用してください。
スクレイピング#
1つのURLをスクレイピングし、そのコンテンツをさまざまなフォーマットで抽出します。
--only-main-content を使用すると、ナビゲーション、フッター、広告を除いたクリーンな出力を取得できます。記事やメインページのコンテンツのみが必要なほとんどのユースケースで推奨されます。
出力フォーマット#
スクレイピングのオプション#
利用可能なオプション:
| Option | Short | Description |
|---|---|---|
--url <url> | -u | スクレイピングする URL (位置引数の代わり) |
--format <formats> | -f | 出力フォーマット (カンマ区切り) :markdown, html, rawHtml, links, screenshot, json, images, summary, changeTracking, attributes, branding |
--html | -H | --format html のショートカット |
--only-main-content | メインのコンテンツのみを抽出 | |
--wait-for <ms> | JS のレンダリングを待機する時間 (ミリ秒) | |
--screenshot | スクリーンショットを撮影 | |
--full-page-screenshot | ページ全体のスクリーンショットを撮影 | |
--include-tags <tags> | 含める HTML タグ (カンマ区切り) | |
--exclude-tags <tags> | 除外する HTML タグ (カンマ区切り) | |
--schema <json> | 構造化抽出用の JSONスキーマ | |
--schema-file <path> | JSONスキーマ ファイルのパス | |
--actions <json> | スクレイピング中に実行する JSON アクションの配列 | |
--actions-file <path> | JSON アクションファイルのパス | |
--proxy <proxy> | スクレイピング用のプロキシモード (例: auto または basic) | |
--redact-pii | 返されるコンテンツから個人を特定できる情報を伏せ字にする | |
--output <path> | -o | 出力をファイルに保存 |
--json | 単一のフォーマット指定でも JSON 出力を強制 | |
--pretty | JSON 出力を整形して表示 | |
--timing | リクエストのタイミングやその他の有用な情報を表示 |
Search#
ウェブ検索を行い、必要に応じて結果をスクレイピングします。
Searchオプション#
利用可能なオプション:
| オプション | 説明 |
|---|---|
--limit <number> | 最大結果数 (デフォルト: 5、最大: 100) |
--sources <sources> | Search対象のソース: web、images、news (カンマ区切り) |
--categories <categories> | カテゴリで絞り込む: research、pdf、developer (カンマ区切り) |
--tbs <value> | 時間で絞り込む: qdr:h (時間) 、qdr:d (日) 、qdr:w (週) 、qdr:m (月) 、qdr:y (年) |
--location <location> | ジオターゲティング (例: "Berlin,Germany") |
--country <code> | ISO 国コード (デフォルト: US) |
--timeout <ms> | タイムアウト (ミリ秒単位、デフォルト: 60000) |
--ignore-invalid-urls | 他の Firecrawl エンドポイントで利用できない URL を除外 |
--scrape | Search結果をスクレイピング |
--scrape-formats <formats> | スクレイピングしたコンテンツのフォーマット (デフォルト: markdown) |
--only-main-content | スクレイピング時にメインコンテンツのみを含める (デフォルト: true) |
--json | JSON として出力 |
--output <path> | 出力をファイルに保存 |
--pretty | JSON 出力を見やすく整形して表示 |
Developer#
Developer Index で、公開コードリポジトリのissue、マージ済みのプルリクエスト、READMEに加え、厳選されたドキュメントサイトを検索できます。
利用可能なオプション:
| オプション | 説明 |
|---|---|
--limit <number> | 返す結果数 (デフォルト: 10、最大: 100) |
--skills-only | インデックス化された agent-skill ファイルのみを検索 (デフォルト: false) |
--json | コンパクトな JSON 形式で出力 |
--output <path> | 出力をファイルに保存 |
--pretty | JSON 出力を見やすく整形 |
Map#
ウェブサイト内のすべてのURLを迅速に検出します。
Map オプション#
利用可能なオプション:
| オプション | 説明 |
|---|---|
--url <url> | マッピング対象の URL (位置引数の代替) |
--limit <number> | 検出する最大 URL 数 |
--search <query> | 検索クエリで URL を絞り込み |
--sitemap <mode> | サイトマップの処理モード: include, skip, only |
--include-subdomains | サブドメインを含める |
--ignore-query-parameters | クエリパラメータが異なる URL を同一として扱う |
--wait | マップ処理の完了を待機 |
--timeout <seconds> | タイムアウト時間 (秒) |
--json | JSON 形式で出力 |
--output <path> | 出力をファイルに保存 |
--pretty | JSON 出力を整形して表示 |
Interact#
ページをスクレイピングした後、自然言語またはコードで操作できます。Interact は既定で最新のスクレイピング結果を使用しますが、特定のスクレイプ ID を指定することもできます。
利用可能なオプション:
| Option | Description |
|---|---|
-p, --prompt <text> | AI プロンプト (位置引数の代わりに指定) |
-c, --code <code> | ライブページセッションで実行するコード |
-s, --scrape-id <id> | スクレイプジョブ ID (既定: 最新のスクレイピング) |
--python | Python/Playwright としてコードを実行 |
--node | Node.js/Playwright としてコードを実行 (既定) |
--bash | Bash としてコードを実行 |
--timeout <seconds> | タイムアウト (秒、1~300、既定: 30) |
--output <path> | 出力をファイルに保存 |
--json | JSON 形式で出力 |
クロール#
指定した URL を起点に、ウェブサイト全体をクロールします。
クロールのステータスを確認する#
クロールオプション#
利用可能なオプション:
| Option | Description |
|---|---|
--url <url> | クロールするURL (位置引数の代わり) |
--wait | クロールの完了を待機 |
--progress | 待機中に進行状況インジケーターを表示 |
--poll-interval <seconds> | ポーリング間隔 (デフォルト: 5) |
--timeout <seconds> | 待機時のタイムアウト時間 |
--status | 既存のクロールジョブのステータスを確認 |
--limit <number> | クロールする最大ページ数 |
--max-depth <number> | クロールの最大深さ |
--include-paths <paths> | 含めるパス (カンマ区切り) |
--exclude-paths <paths> | 除外するパス (カンマ区切り) |
--sitemap <mode> | サイトマップの処理モード: include、skip、only |
--allow-subdomains | サブドメインも対象に含める |
--allow-external-links | 外部リンクをたどる |
--crawl-entire-domain | ドメイン全体をクロール |
--ignore-query-parameters | クエリパラメーターが異なるURLを同一として扱う |
--delay <ms> | リクエスト間の遅延時間 |
--max-concurrency <n> | 最大同時リクエスト数 |
--scrape-options <json> | 各ページに渡すスクレイピングのオプションのJSON |
--scrape-options-file <path> | スクレイピングのオプションのJSONファイルへのパス |
--webhook <url-or-json> | webhook のURLまたは設定 |
--cancel | ジョブIDを指定してアクティブなクロールジョブをキャンセル |
--output <path> | 出力をファイルに保存 |
--pretty | JSON出力を整形して表示 |
監視#
定期的に実行されるスクレイピングまたはクロールを作成し、各実行結果を前回のスナップショットとの差分として比較します。変更されたページのうち、どれが自分のユースケースにとって意味のあるものかを Firecrawl に判断させたい場合は、goal を追加します。
Monitor の目標は、短く、ユーザーの意図に忠実であるべきです。何をアラートの発生条件にするかを述べ、指定された対象範囲を言い換えて明記し、除外事項は明らかな場合または明示的に求められた場合にのみ含めてください。ユーザーが "any change" を求めている場合は、目標は広く保ってください。
利用可能なオプション:
| Option | Description |
|---|---|
--name <name> | Monitor 名 |
--goal <goal> | 意味のある変更を判定するための目標 |
--cron <expression> | Cron スケジュール (例: */30 * * * *) |
--schedule <text> | 自然言語のスケジュール (例: hourly) |
--timezone <tz> | スケジュールのタイムゾーン (既定値: UTC) |
--page <url> | 各チェック時にスクレイピングする単一ページの URL |
--scrape-urls <list> | 各チェック時にスクレイピングするページ URL のカンマ区切りリスト |
--crawl-url <url> | クロール対象のルート URL |
--webhook-url <url> | webhook の送信先 |
--webhook-events <list> | Monitor イベントのカンマ区切りリスト |
--email <list> | メール受信者のカンマ区切りリスト |
--retention-days <n> | スナップショットの保持期間 |
--page-status <state> | monitor check でページを絞り込むための条件 |
--state <state> | monitor update で Monitor の状態を設定: active/paused |
エージェント#
自然言語プロンプトを使用して、Web上からデータを検索・収集します。
エージェントオプション#
利用可能なオプション:
| Option | Description |
|---|---|
--urls <urls> | エージェントが対象とするURLの任意のリスト (カンマ区切り) |
--model <model> | 使用するモデル。デフォルトは、すべての実行で使用されるモデルであるspark-2です。Spark 1モデルは非推奨であり、spark-2にルーティングされます |
--schema <json> | 構造化出力用のJSONスキーマ (インラインJSON文字列) |
--schema-file <path> | 構造化出力用のJSONスキーマファイルへのパス |
--max-credits <number> | 消費するクレジットの上限 (上限に達するとジョブは失敗) |
--webhook <url-or-json> | webhook URLまたは設定 |
--status | 既存のエージェントジョブのステータスを確認 |
--cancel | ジョブ ID を指定して実行中のエージェントジョブをキャンセル |
--wait | 結果を返す前にエージェントの完了を待つ |
--poll-interval <seconds> | 待機中のポーリング間隔 (デフォルト: 5) |
--timeout <seconds> | 待機時のタイムアウト (デフォルト: タイムアウトなし) |
--output <path> | 出力をファイルに保存 |
--json | JSON形式で出力 |
クレジット使用状況#
チームのクレジット残高と利用状況を確認できます。
Version#
CLIのバージョンを表示します。
グローバルオプション#
これらのオプションはすべてのコマンドで利用できます。
| オプション | 短縮形 | 説明 |
|---|---|---|
--status | バージョン、認証情報、同時実行数、クレジット残高を表示する | |
--api-key <key> | -k | このコマンドで使用する API キーを、保存されているキーより優先して指定する |
--api-url <url> | カスタム API URL を使用する (セルフホスト環境/ローカル開発向け) | |
--help | -h | コマンドのヘルプを表示する |
--version | -V | CLI のバージョン情報を表示する |
init では --skip-auth、--skip-install、--skip-skills、--agent <name> も指定できます。firecrawl init --help を参照してください。
出力の処理#
CLI はデフォルトで標準出力 (stdout) に出力するため、パイプやリダイレクトが容易です。
フォーマットの挙動#
- 単一フォーマット: 生のコンテンツを出力します (markdown テキスト、HTML など)
- 複数フォーマット: 要求されたすべてのデータを含む JSON を出力します
使用例#
クイックスクレイプ#
サイト全体クロール#
サイトの発見#
調査ワークフロー#
エージェント#
他のツールとの連携#
テレメトリー#
CLI は、製品の改善のために認証時に匿名の利用状況データを収集します:
- CLI バージョン、OS、Node.js バージョン
- 開発ツールの検出 (例:Cursor、VS Code、Claude Code)
CLI を通じてコマンド内容、URL、ファイル内容が収集されることは一切ありません。
テレメトリーを無効にするには、次の環境変数を設定します:
オープンソース#
Firecrawl CLI と 3 つのスキル セグメントはすべてオープンソースで、GitHub で公開されています:
firecrawl/cli— CLI と CLI スキル (ライブの Web 作業)firecrawl/skills— Build スキル (Firecrawl をアプリケーション コードに統合)firecrawl/firecrawl-workflows— workflow skills (リサーチブリーフ、SEO 監査、リードリスト、デザインクローンなどの再利用可能な成果物)
Firecrawl API キーが必要な AI エージェントですか? 自動オンボーディング手順については、firecrawl.dev/agent-onboarding/SKILL.md を参照してください。

