> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-docs-remove-capabilities-from-sidebar.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

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

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

<div id="installation">
  ## インストール
</div>

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

```bash theme={null}
npx -y firecrawl-cli@latest init --all --browser
```

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

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

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

```bash CLI theme={null}
# npm でグローバルにインストール
npm install -g firecrawl-cli
```

<div id="authentication">
  ## 認証
</div>

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

<Note>
  **一部のCLIコマンドはログインなしで利用できます。** APIキーが設定されていない場合、対応しているコマンドはAPIキー不要のFreeティアに自動的に切り替わります。無料で使えますが、IPごとにレート制限があります。現在のAPIキー不要コマンドの一覧と注意事項については、[Rate Limits](/ja/rate-limits#keyless-no-api-key)を参照してください。1,000 クレジットとより高い上限を利用するには、[無料のキーに登録](https://firecrawl.dev)してください。設定後は、CLI が自動的にそのキーを使用します。
</Note>

<div id="login">
  ### ログイン
</div>

```bash CLI theme={null}
# 対話型ログイン(ブラウザを開くか、APIキーの入力を求めます)
firecrawl login

# Login with browser authentication (recommended for agents)
firecrawl login --browser

# Login with API key directly
firecrawl login --api-key fc-YOUR-API-KEY

# Or set via environment variable
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```

<div id="view-configuration">
  ### 設定の表示
</div>

```bash CLI theme={null}
# 現在の設定と認証ステータスを表示
firecrawl view-config
```

<div id="logout">
  ### ログアウト
</div>

```bash CLI theme={null}
# 保存された認証情報をクリア
firecrawl logout
```

<div id="connect-the-cli-to-self-hosted-firecrawl">
  ### CLI をセルフホスト版 Firecrawl に接続する
</div>

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

```bash CLI theme={null}
# ローカルのFirecrawlインスタンスを使用(APIキー不要)
firecrawl --api-url http://localhost:3002 scrape https://example.com

# Or set via environment variable
export FIRECRAWL_API_URL=http://localhost:3002
firecrawl scrape https://example.com

# Configure and persist the custom API URL
firecrawl config --api-url http://localhost:3002
```

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

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

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

<div id="check-status">
  ### ステータスの確認
</div>

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

```bash CLI theme={null}
firecrawl --status
```

準備完了時の出力:

```
  🔥 firecrawl cli v1.16.2

  ● Authenticated via FIRECRAWL_API_KEY
  Concurrency: 0/100 jobs (parallel scrape limit)
  Credits: 500,000 remaining
```

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

<div id="commands">
  ## コマンド
</div>

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

<div id="scrape">
  ### スクレイピング
</div>

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

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

```bash CLI theme={null}
# Scrape a URL (default: markdown output)
firecrawl https://example.com

# Or use the explicit scrape command
firecrawl scrape https://example.com

# 推奨: ナビゲーションやフッターを除いたクリーンな出力には --only-main-content を使用
firecrawl https://example.com --only-main-content
```

<div id="output-formats">
  #### 出力フォーマット
</div>

```bash CLI theme={null}
# Get HTML output
firecrawl https://example.com --html

# Multiple formats (returns JSON)
firecrawl https://example.com --format markdown,links

# Get images from a page
firecrawl https://example.com --format images

# Get a summary of the page content
firecrawl https://example.com --format summary

# Track changes on a page
firecrawl https://example.com --format changeTracking

# 利用可能なフォーマット: markdown, html, rawHtml, links, screenshot, json, images, summary, changeTracking, attributes, branding, product
```

<div id="scrape-options">
  #### スクレイピングのオプション
</div>

```bash CLI theme={null}
# Extract only main content (removes navs, footers)
firecrawl https://example.com --only-main-content

# Wait for JavaScript rendering
firecrawl https://example.com --wait-for 3000

# Take a screenshot
firecrawl https://example.com --screenshot

# Extract structured JSON with a schema
firecrawl https://example.com --format json --schema '{"type":"object","properties":{"title":{"type":"string"}}}'

# Run lightweight scrape actions before extraction
firecrawl https://example.com --actions '[{"type":"wait","milliseconds":1000}]'

# Select proxy mode
firecrawl https://example.com --proxy basic

# 個人を特定できる情報を削除
firecrawl https://example.com --redact-pii

# Include/exclude specific HTML tags
firecrawl https://example.com --include-tags article,main
firecrawl https://example.com --exclude-tags nav,footer

# Save output to file
firecrawl https://example.com -o output.md

# Pretty print JSON output
firecrawl https://example.com --format markdown,links --pretty

# Force JSON output even with single format
firecrawl https://example.com --json

# Show request timing information
firecrawl https://example.com --timing
```

**利用可能なオプション:**

| 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` | | リクエストのタイミングやその他の有用な情報を表示 |

***

<div id="search">
  ### Search
</div>

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

```bash CLI theme={null}
# ウェブを検索する
firecrawl search "web scraping tutorials"

# 結果数を制限する
firecrawl search "AI news" --limit 10

# 結果を整形して表示する
firecrawl search "machine learning" --pretty
```

<div id="search-options">
  #### Searchオプション
</div>

```bash CLI theme={null}
# Search specific sources
firecrawl search "AI" --sources web,news,images

# Search with category filters
firecrawl search "react hooks" --categories developer
firecrawl search "machine learning" --categories research,pdf

# Time-based filtering
firecrawl search "tech news" --tbs qdr:h   # Last hour
firecrawl search "tech news" --tbs qdr:d   # Last day
firecrawl search "tech news" --tbs qdr:w   # Last week
firecrawl search "tech news" --tbs qdr:m   # 過去1ヶ月
firecrawl search "tech news" --tbs qdr:y   # Last year

# Location-based search
firecrawl search "restaurants" --location "Berlin,Germany" --country DE

# Search and scrape results
firecrawl search "documentation" --scrape --scrape-formats markdown

# Save to file
firecrawl search "firecrawl" --pretty -o results.json
```

**利用可能なオプション:**

| オプション | 説明 |
| - | - |
| `--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 出力を見やすく整形して表示 |

***

<div id="developer">
  ### Developer
</div>

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

```bash CLI theme={null}
firecrawl developer "how do I configure retries" --limit 10
```

**利用可能なオプション:**

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

***

<div id="map">
  ### Map
</div>

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

```bash CLI theme={null}
# ウェブサイト上のすべてのURLを検出
firecrawl map https://example.com

# Output as JSON
firecrawl map https://example.com --json

# Limit number of URLs
firecrawl map https://example.com --limit 500
```

<div id="map-options">
  #### Map オプション
</div>

```bash CLI theme={null}
# Filter URLs by search query
firecrawl map https://example.com --search "blog"

# Include subdomains
firecrawl map https://example.com --include-subdomains

# Control sitemap usage
firecrawl map https://example.com --sitemap include   # Use sitemap
firecrawl map https://example.com --sitemap skip      # Skip sitemap
firecrawl map https://example.com --sitemap only      # サイトマップのみを使用

# Ignore query parameters (dedupe URLs)
firecrawl map https://example.com --ignore-query-parameters

# Wait for map to complete with timeout
firecrawl map https://example.com --wait --timeout 60

# Save to file
firecrawl map https://example.com -o urls.txt
firecrawl map https://example.com --json --pretty -o urls.json
```

**利用可能なオプション:**

| オプション | 説明 |
| - | - |
| `--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 出力を整形して表示 |

***

<div id="interact">
  ### Interact
</div>

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

```bash CLI theme={null}
# 1. AmazonのホームページをスクレイピングするスクレイピングIDは自動的に保存されます）
firecrawl scrape https://www.amazon.com

# 2. 操作する — 商品を検索して価格を取得する
firecrawl interact "Search for iPhone 16 Pro Max"
firecrawl interact "Click on the first result and tell me the price"

# 3. セッションを停止する
firecrawl interact stop
```

**利用可能なオプション:**

| 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 形式で出力 |

***

<div id="crawl">
  ### クロール
</div>

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

```bash CLI theme={null}
# Start a crawl (returns job ID immediately)
firecrawl crawl https://example.com

# Wait for crawl to complete
firecrawl crawl https://example.com --wait

# 進行状況インジケーター付きで待機
firecrawl crawl https://example.com --wait --progress
```

<div id="check-crawl-status">
  #### クロールのステータスを確認する
</div>

```bash CLI theme={null}
# ジョブIDを使用してクロールステータスを確認
firecrawl crawl <job-id>

# 実際のジョブIDの例
firecrawl crawl 550e8400-e29b-41d4-a716-446655440000
```

<div id="crawl-options">
  #### クロールオプション
</div>

```bash CLI theme={null}
# Limit crawl depth and pages
firecrawl crawl https://example.com --limit 100 --max-depth 3 --wait

# Include only specific paths
firecrawl crawl https://example.com --include-paths /blog,/docs --wait

# Exclude specific paths
firecrawl crawl https://example.com --exclude-paths /admin,/login --wait

# Include subdomains
firecrawl crawl https://example.com --allow-subdomains --wait

# Crawl entire domain
firecrawl crawl https://example.com --crawl-entire-domain --wait

# Rate limiting
firecrawl crawl https://example.com --delay 1000 --max-concurrency 2 --wait

# クロールされた各ページにスクレイピングのオプションを渡す
firecrawl crawl https://example.com --scrape-options '{"formats":["markdown"],"onlyMainContent":true}'

# クロール完了イベントをwebhookに送信する
firecrawl crawl https://example.com --webhook '{"url":"https://example.com/webhook","events":["completed"]}'

# アクティブなクロールをキャンセルする
firecrawl crawl <job-id> --cancel

# カスタムポーリング間隔とタイムアウト
firecrawl crawl https://example.com --wait --poll-interval 10 --timeout 300

# Save results to file
firecrawl crawl https://example.com --wait --pretty -o results.json
```

**利用可能なオプション:**

| 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出力を整形して表示 |

***

<div id="monitor">
  ### 監視
</div>

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

```bash CLI theme={null}
firecrawl monitor create --name "Hacker News AI" \
  --schedule "every 30 minutes" \
  --goal "Alert when a new Hacker News story related to AI enters the top 10. Ignore changes to stories that are not about AI. Do not alert on changes outside the top 10." \
  --page https://news.ycombinator.com

firecrawl monitor run <monitorId>
firecrawl monitor checks <monitorId> --limit 10
firecrawl monitor check <monitorId> <checkId> --page-status changed
firecrawl monitor update <monitorId> \
  --goal "Alert when a new Hacker News story related to AI enters the top 10. Do not alert on changes outside the top 10."
firecrawl monitor delete <monitorId>
```

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 |

***

<div id="agent">
  ### エージェント
</div>

自然言語プロンプトを使用して、Web上からデータを検索・収集します。

```bash CLI theme={null}
# 基本的な使い方 - URLは省略可能
firecrawl agent "Find the top 5 AI startups and their funding amounts" --wait

# Focus on specific URLs
firecrawl agent "Compare pricing plans" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait

# Use a schema for structured output
firecrawl agent "Get company information" --urls https://example.com --schema '{"type":"object","properties":{"name":{"type":"string"},"founded":{"type":"number"}}}' --wait

# Use schema from a file
firecrawl agent "Get product details" --urls https://example.com --schema-file schema.json --wait
```

<div id="agent-options">
  #### エージェントオプション
</div>

```bash CLI theme={null}
# Spark 2がデフォルト — すべての実行はSpark 2上で行われます
firecrawl agent "Competitive analysis across multiple domains" --model spark-2 --wait

# 非推奨: Spark 1のモデル名も引き続き利用できますが、spark-2にルーティングされます。

# Set max credits to limit costs
firecrawl agent "Gather contact information from company websites" --max-credits 100 --wait

# Check status of an existing job
firecrawl agent <job-id> --status

# エージェントイベントをwebhookに送信
firecrawl agent "Extract product details" --urls https://example.com --webhook '{"url":"https://example.com/webhook","events":["completed","failed"]}'

# 実行中のエージェントジョブをキャンセル
firecrawl agent <job-id> --cancel

# Custom polling interval and timeout
firecrawl agent "Summarize recent blog posts" --wait --poll-interval 10 --timeout 300

# Save output to file
firecrawl agent "Find pricing information" --urls https://example.com --wait -o pricing.json --pretty
```

**利用可能なオプション:**

| 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形式で出力 |

***

<div id="credit-usage">
  ### クレジット使用状況
</div>

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

```bash CLI theme={null}
# クレジット使用量を確認
firecrawl credit-usage

# JSON形式で出力
firecrawl credit-usage --json --pretty
```

***

<div id="version">
  ### Version
</div>

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

```bash CLI theme={null}
firecrawl version
# または
firecrawl --version
```

<div id="global-options">
  ## グローバルオプション
</div>

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

| オプション | 短縮形 | 説明 |
| - | - | - |
| `--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` を参照してください。

<div id="output-handling">
  ## 出力の処理
</div>

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

```bash CLI theme={null}
# マークダウンを別のコマンドにパイプする
firecrawl https://example.com | head -50

# ファイルにリダイレクトする
firecrawl https://example.com > output.md

# 整形されたJSON形式で保存する
firecrawl https://example.com --format markdown,links --pretty -o data.json
```

<div id="format-behavior">
  ### フォーマットの挙動
</div>

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

```bash CLI theme={null}
# Raw markdown output
firecrawl https://example.com --format markdown

# 複数フォーマットを使用したJSON出力
firecrawl https://example.com --format markdown,links
```

<div id="examples">
  ## 使用例
</div>

<div id="quick-scrape">
  ### クイックスクレイプ
</div>

```bash CLI theme={null}
# URLからMarkdownコンテンツを取得(クリーンな出力には --only-main-content を使用)
firecrawl https://docs.firecrawl.dev --only-main-content

# Get HTML content
firecrawl https://example.com --html -o page.html
```

<div id="full-site-crawl">
  ### サイト全体クロール
</div>

```bash CLI theme={null}
# 制限付きでドキュメントサイトをクロールする
firecrawl crawl https://docs.example.com --limit 50 --max-depth 2 --wait --progress -o docs.json
```

<div id="site-discovery">
  ### サイトの発見
</div>

```bash CLI theme={null}
# すべてのブログ投稿を検索
firecrawl map https://example.com --search "blog" -o blog-urls.txt
```

<div id="research-workflow">
  ### 調査ワークフロー
</div>

```bash CLI theme={null}
# リサーチ用の検索とスクレイピング結果
firecrawl search "machine learning best practices 2024" --scrape --scrape-formats markdown --pretty
```

<div id="agent-2">
  ### エージェント
</div>

```bash CLI theme={null}
# URLs are optional
firecrawl agent "Find the top 5 AI startups and their funding amounts" --wait

# 特定のURLを対象にする
firecrawl agent "Compare pricing plans" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait
```

<div id="combine-with-other-tools">
  ### 他のツールとの連携
</div>

```bash CLI theme={null}
# Extract URLs from search results
jq -r '.data.web[].url' search-results.json

# Get titles from search results
jq -r '.data.web[] | "\(.title): \(.url)"' search-results.json

# リンクをJSONとして抽出し、1行につき1つのURLを出力
firecrawl https://example.com --format links --json | jq -r '.links[]'

# Count URLs from map
firecrawl map https://example.com | wc -l
```

<div id="telemetry">
  ## テレメトリー
</div>

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

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

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

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

```bash CLI theme={null}
export FIRECRAWL_NO_TELEMETRY=1
```

<div id="open-source">
  ## オープンソース
</div>

Firecrawl CLI と 3 つのスキル セグメントはすべてオープンソースで、GitHub で公開されています:

* [`firecrawl/cli`](https://github.com/firecrawl/cli) — CLI と CLI スキル (ライブの Web 作業)
* [`firecrawl/skills`](https://github.com/firecrawl/skills) — Build スキル (Firecrawl をアプリケーション コードに統合)
* [`firecrawl/firecrawl-workflows`](https://github.com/firecrawl/firecrawl-workflows) — workflow skills (リサーチブリーフ、SEO 監査、リードリスト、デザインクローンなどの再利用可能な成果物)

> Firecrawl API キーが必要な AI エージェントですか？ 自動オンボーディング手順については、[firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) を参照してください。