firecrawl エージェント
AI搭載の自律的抽出。エージェントがサイトをナビゲートし、構造化データを抽出します（2〜5分かかります）。
構造化レコードやリストを自律抽出する前に、firecrawl search alexandria '<必要なデータ>' を実行して、既製のワークフローまたはデータプロバイダーがないか確認してください。一致する契約がある場合は、firecrawl list <プロバイダー> <機能> --pretty で内容を確認し、firecrawl scrape --alexandria <プロバイダー>/<機能> --options '<入力JSON>' で実行します。その契約の正確なプロバイダー、機能、入力フィールドを使用してください。適切なツールが存在しない場合、またはタスクに自律的なナビゲーションが必要な場合は、Agent を続行します。
クイックスタート
# 構造化データを抽出
firecrawl agent "すべての価格帯を抽出" --wait --json -o .firecrawl/pricing.json
# JSONスキーマを使用して構造化出力
firecrawl agent "製品を抽出" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/products.json
# 特定のページにフォーカス
firecrawl agent "機能一覧を取得" --urls "<url>" --wait --json -o .firecrawl/features.json
全オプション一覧は firecrawl agent --help を実行してください。
完了条件: 出力ファイルにリクエストへの有効なJSON応答が含まれているか、後でポーリングするためにジョブIDが意図的に返された場合。
Alexandria プロバイダー
実行は、Alexandria フラグ（--alexandria、--toolkits <スラッグ>（最大5つ）、--max-calls <n>、--require-approval、または --on-terms-required skip|ask）で開始された場合にのみ、接続されたAlexandriaデータプロバイダーを使用します。そのスレッドでのフォローアップはそれらの設定を維持します。
firecrawl agent "<企業>の営業責任者を見つける" --toolkits apollo,crunchbase --wait --json -o .firecrawl/contacts.json
--require-approval（--mode chat が必要）を使用すると、有料通話を行う代わりに pendingApproval で実行が終了することがあります。ユーザーに確認し、同じスレッドで firecrawl agent "<フォローアッププロンプト>" --thread <スレッドID> --mode chat --approve <承認ID>（または --decline <承認ID>）で回答します。terms 承認は、組織管理者がFirecrawlダッシュボードでプロバイダーの利用規約を受け入れた場合にのみ続行されます。ユーザーに https://www.firecrawl.dev/app/settings?tab=data-sources を案内し、最初に利用規約を確認したい場合は firecrawl alexandria terms show <プロバイダー> を使用してください。承認しても利用規約は受け入れられません。
ジョブID
--wait を省略するとジョブIDが返されます。UUID形式の位置引数はステータス確認として自動検出されます：
# 一度確認（--status を追加したのと同じ）
firecrawl agent "<ジョブID>"
# 既存のジョブを待機（10秒間隔で最大5分ポーリング）
firecrawl agent "<ジョブID>" --wait --poll-interval 10 --timeout 300
# アクティブなジョブをキャンセル
firecrawl agent "<ジョブID>" --cancel
ヒント
- インライン結果が必要な場合は
--waitを使用し、後でポーリングするジョブIDが必要な場合のみ省略します（ジョブIDを参照）。 - 予測可能な構造化出力が必要な場合は
--schemaを使用します。それ以外の場合、エージェントは自由形式のデータを返します。 - Agentの実行は単純なスクレイピングよりも多くのクレジットを消費します。
--max-creditsを使用して支出を制限してください。 - 単一ページの単純な抽出には、
scrapeの方が高速で低コストなため推奨します。
関連情報
- firecrawl-scrape — より単純な単一ページ抽出
- firecrawl-interact — スクレイプ＋インタラクションによる手動ページ操作（より制御可能）
- firecrawl-crawl — AIなしのバルク抽出
- firecrawl-build-scrape — ここで実行する代わりに、構造化抽出をアプリに組み込む
Alexandria セッションフィードバック
Alexandria セッションの結果やプロバイダー/機能のギャップを報告するには、firecrawl alexandria feedback --rating good|partial|bad --url <ウェブサイト> --requested-functionality '<必要な機能>' --objective '<タスクの根本的な目標>' --rationale '<発生したこと>' --json を使用します。rationale には観察された結果を使用してください。ジョブIDは不要です。最後のAlexandria検索、発見、または実行から20分以内に送信してください。それ以降は拒否されます。各提出は1クレジットを返金し、ウェブサイトごとに最大10回、チームごとに1日最大100回までです。オプションの --provider-feedback および --capability-feedback JSON配列で特定のギャップを記述できます。フィールドについては firecrawl alexandria feedback --help を確認してください。プロバイダーは存在するが必要な機能が欠けている場合は機能問題 missing_capability を、新しい機能を要求する場合は new_capability_request（requestedFunctionality と共に）を使用します。