Skip to main content

CLI

Firecrawl スキルは、Codex、Claude Code、Cursor、OpenCode などの AI エージェントが CLI 経由で Firecrawl を利用するための手軽な方法です。
6 min read

ターミナルから直接、検索、スクレイピング、Interact、クロール、マッピング、エージェントジョブの実行を行えます。Firecrawl CLIは単体でも動作し、Codex、Claude Code、Cursor、OpenCodeのようなAIコーディングエージェントが自動的に検出して利用できるスキルと組み合わせて使うこともできます。

インストール#

Codex、Claude Code、Cursor、OpenCode のような AI エージェントを使用している場合は、以下の Firecrawl スキル をインストールすると、エージェントがセットアップしてくれます。

  • --all はエージェントの選択をスキップし、検出されたすべてのエージェントを初期化します
  • --browser は Firecrawl の認証のためにブラウザを自動的に開きます
Note

スキル をインストールした後、新しい スキル を認識させるためにエージェントを再起動してください。

npm を使って Firecrawl CLI をグローバルに手動でインストールすることもできます。

CLI

認証#

CLIを使用する前に、Firecrawl APIキーで認証する必要があります。

Note

一部のCLIコマンドはログインなしで利用できます。 APIキーが設定されていない場合、対応しているコマンドはAPIキー不要のFreeティアに自動的に切り替わります。無料で使えますが、IPごとにレート制限があります。現在のAPIキー不要コマンドの一覧と注意事項については、Rate Limitsを参照してください。1,000 クレジットとより高い上限を利用するには、無料のキーに登録してください。設定後は、CLI が自動的にそのキーを使用します。

ログイン#

CLI

設定の表示#

CLI

ログアウト#

CLI

CLI をセルフホスト版 Firecrawl に接続する#

まず、セルフホスティングガイドに従って、スクレイピングが 1 回正常に実行できる状態にします。次に、--api-url または FIRECRAWL_API_URL で CLI の接続先 API を指定します。

CLI

https://api.firecrawl.dev ではなくカスタム API URL を使用すると、CLI は Firecrawl Cloud API キー認証をスキップします。これは、USE_DB_AUTHENTICATION=false を設定する信頼済みネットワーク向け Quickstart と同じ動作です。

Warning

認証なしの API は、信頼済みネットワーク上でのみ運用してください。認証 プロキシやその他のアクセス制御レイヤーを追加する場合は、この方法に依存する前に、 CLI がそのレイヤーで必要な認証情報を送信できることを確認してください。

CLI で呼び出せるのは、デプロイ環境で有効になっている機能のみです。Cloud 専用またはプロバイダー依存のコマンドを使用する前に、セルフホスト版の機能サポートを確認してください。

ステータスの確認#

インストールと認証が正しく行われているかを確認し、レート制限も確認します。

CLI

準備完了時の出力:

  • 同時実行数 (Concurrency): 並列に実行できるジョブの最大数。この上限付近まで並列処理を行ってもよいが、超えないようにする。
  • クレジット (Credits): 残りの API クレジット数。各 scrape/crawl はクレジットを消費する。

コマンド#

Note

隠し firecrawl browser コマンドは、エージェント ワークフローでは非推奨です。まず firecrawl scrape <url> を実行し、その後、得られたスクレイピングセッションで firecrawl interact ... を使用してください。

スクレイピング#

1つのURLをスクレイピングし、そのコンテンツをさまざまなフォーマットで抽出します。

Tip

--only-main-content を使用すると、ナビゲーション、フッター、広告を除いたクリーンな出力を取得できます。記事やメインページのコンテンツのみが必要なほとんどのユースケースで推奨されます。

CLI

出力フォーマット#

CLI

スクレイピングのオプション#

CLI

利用可能なオプション:

OptionShortDescription
--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 出力を強制
--prettyJSON 出力を整形して表示
--timingリクエストのタイミングやその他の有用な情報を表示

ウェブ検索を行い、必要に応じて結果をスクレイピングします。

CLI

Searchオプション#

CLI

利用可能なオプション:

オプション説明
--limit <number>最大結果数 (デフォルト: 5、最大: 100)
--sources <sources>Search対象のソース: webimagesnews (カンマ区切り)
--categories <categories>カテゴリで絞り込む: researchpdfdeveloper (カンマ区切り)
--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 を除外
--scrapeSearch結果をスクレイピング
--scrape-formats <formats>スクレイピングしたコンテンツのフォーマット (デフォルト: markdown)
--only-main-contentスクレイピング時にメインコンテンツのみを含める (デフォルト: true)
--jsonJSON として出力
--output <path>出力をファイルに保存
--prettyJSON 出力を見やすく整形して表示

Developer#

Developer Index で、公開コードリポジトリのissue、マージ済みのプルリクエスト、READMEに加え、厳選されたドキュメントサイトを検索できます。

CLI

利用可能なオプション:

オプション説明
--limit <number>返す結果数 (デフォルト: 10、最大: 100)
--skills-onlyインデックス化された agent-skill ファイルのみを検索 (デフォルト: false)
--jsonコンパクトな JSON 形式で出力
--output <path>出力をファイルに保存
--prettyJSON 出力を見やすく整形

Map#

ウェブサイト内のすべてのURLを迅速に検出します。

CLI

Map オプション#

CLI

利用可能なオプション:

オプション説明
--url <url>マッピング対象の URL (位置引数の代替)
--limit <number>検出する最大 URL 数
--search <query>検索クエリで URL を絞り込み
--sitemap <mode>サイトマップの処理モード: include, skip, only
--include-subdomainsサブドメインを含める
--ignore-query-parametersクエリパラメータが異なる URL を同一として扱う
--waitマップ処理の完了を待機
--timeout <seconds>タイムアウト時間 (秒)
--jsonJSON 形式で出力
--output <path>出力をファイルに保存
--prettyJSON 出力を整形して表示

Interact#

ページをスクレイピングした後、自然言語またはコードで操作できます。Interact は既定で最新のスクレイピング結果を使用しますが、特定のスクレイプ ID を指定することもできます。

CLI

利用可能なオプション:

OptionDescription
-p, --prompt <text>AI プロンプト (位置引数の代わりに指定)
-c, --code <code>ライブページセッションで実行するコード
-s, --scrape-id <id>スクレイプジョブ ID (既定: 最新のスクレイピング)
--pythonPython/Playwright としてコードを実行
--nodeNode.js/Playwright としてコードを実行 (既定)
--bashBash としてコードを実行
--timeout <seconds>タイムアウト (秒、1~300、既定: 30)
--output <path>出力をファイルに保存
--jsonJSON 形式で出力

クロール#

指定した URL を起点に、ウェブサイト全体をクロールします。

CLI

クロールのステータスを確認する#

CLI

クロールオプション#

CLI

利用可能なオプション:

OptionDescription
--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>サイトマップの処理モード: includeskiponly
--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>出力をファイルに保存
--prettyJSON出力を整形して表示

監視#

定期的に実行されるスクレイピングまたはクロールを作成し、各実行結果を前回のスナップショットとの差分として比較します。変更されたページのうち、どれが自分のユースケースにとって意味のあるものかを Firecrawl に判断させたい場合は、goal を追加します。

CLI

Monitor の目標は、短く、ユーザーの意図に忠実であるべきです。何をアラートの発生条件にするかを述べ、指定された対象範囲を言い換えて明記し、除外事項は明らかな場合または明示的に求められた場合にのみ含めてください。ユーザーが "any change" を求めている場合は、目標は広く保ってください。

利用可能なオプション:

OptionDescription
--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上からデータを検索・収集します。

CLI

エージェントオプション#

CLI

利用可能なオプション:

OptionDescription
--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>出力をファイルに保存
--jsonJSON形式で出力

クレジット使用状況#

チームのクレジット残高と利用状況を確認できます。

CLI

Version#

CLIのバージョンを表示します。

CLI

グローバルオプション#

これらのオプションはすべてのコマンドで利用できます。

オプション短縮形説明
--statusバージョン、認証情報、同時実行数、クレジット残高を表示する
--api-key <key>-kこのコマンドで使用する API キーを、保存されているキーより優先して指定する
--api-url <url>カスタム API URL を使用する (セルフホスト環境/ローカル開発向け)
--help-hコマンドのヘルプを表示する
--version-VCLI のバージョン情報を表示する

init では --skip-auth--skip-install--skip-skills--agent <name> も指定できます。firecrawl init --help を参照してください。

出力の処理#

CLI はデフォルトで標準出力 (stdout) に出力するため、パイプやリダイレクトが容易です。

CLI

フォーマットの挙動#

  • 単一フォーマット: 生のコンテンツを出力します (markdown テキスト、HTML など)
  • 複数フォーマット: 要求されたすべてのデータを含む JSON を出力します
CLI

使用例#

クイックスクレイプ#

CLI

サイト全体クロール#

CLI

サイトの発見#

CLI

調査ワークフロー#

CLI

エージェント#

CLI

他のツールとの連携#

CLI

テレメトリー#

CLI は、製品の改善のために認証時に匿名の利用状況データを収集します:

  • CLI バージョン、OS、Node.js バージョン
  • 開発ツールの検出 (例:Cursor、VS Code、Claude Code)

CLI を通じてコマンド内容、URL、ファイル内容が収集されることは一切ありません。

テレメトリーを無効にするには、次の環境変数を設定します:

CLI

オープンソース#

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 を参照してください。