firecrawl-agent

firecrawl agent

AI を活用した自律型の抽出機能です。エージェントがサイトを巡回し、構造化データを抽出します（2～5 分かかります）。

構造化されたレコードやリストを自律的に抽出する前に、firecrawl search alexandria '<data you need>' を実行して、すぐに使えるワークフローやデータプロバイダーがないか確認してください。一致する契約が見つかったら、firecrawl list <provider> <capability> --pretty で内容を確認し、タスクに対応している場合は firecrawl scrape --alexandria <provider>/<capability> --options '<input JSON>' で実行してください。その契約に記載されたプロバイダー、機能、入力フィールドをそのまま使用してください。適切なツールがない場合や、自律的な巡回が必要な場合は Agent を使用してください。

クイックスタート

# Extract structured data
firecrawl agent "extract all pricing tiers" --wait --json -o .firecrawl/pricing.json

# With a JSON schema for structured output
firecrawl agent "extract products" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/products.json

# Focus on specific pages
firecrawl agent "get feature list" --urls "<url>" --wait --json -o .firecrawl/features.json

すべてのオプションを確認するには、firecrawl agent --help を実行してください。

完了条件： 出力ファイルにリクエストに応じた有効な JSON が含まれているか、後でポーリングするためのジョブ ID が意図的に返されていること。

Alexandria プロバイダー

実行時に Alexandria データプロバイダーが接続されるのは、Alexandria フラグ（--alexandria、--toolkits <slugs>（最大 5 個）、--max-calls <n>、--require-approval、または --on-terms-required skip|ask）を指定して開始した場合のみです。同じスレッドでの後続のリクエストにも、これらの設定が引き継がれます。

firecrawl agent "find the head of sales at <company>" --toolkits apollo,crunchbase --wait --json -o .firecrawl/contacts.json

--require-approval（--mode chat が必要）を指定すると、有料の呼び出しを実行せずに、実行が pendingApproval の状態で終了することがあります。ユーザーに確認してから、同じスレッドで firecrawl agent "<follow-up prompt>" --thread <threadId> --mode chat --approve <approvalId>（または --decline <approvalId>）を実行して応答してください。terms の承認の場合、プロバイダーの利用規約が組織で承認されるまで続行されません。承認はダッシュボードで行うか、ユーザーに firecrawl alexandria terms show <provider> を提示し、明示的な同意を得た後にのみ、返されたバージョンとダイジェストを指定して firecrawl alexandria terms accept <provider> --terms-version <version> --digest <digest> --confirm を実行してください。承認操作を行っても、利用規約への同意にはなりません。

ジョブ ID

--wait を省略すると、ジョブ ID が返されます。位置引数に UUID を指定すると、ステータス確認として自動検出されます。

# Check once (equivalent to adding --status)
firecrawl agent "<job-id>"

# Wait on an existing job, polling every 10 seconds for up to 5 minutes
firecrawl agent "<job-id>" --wait --poll-interval 10 --timeout 300

# Cancel an active job
firecrawl agent "<job-id>" --cancel

ヒント

• 結果をその場で取得するには --wait を使用してください。後でポーリングするためのジョブ ID が必要な場合に限り、省略してください（ジョブ ID を参照）。
• 予測可能な構造化出力には --schema を使用してください。指定しない場合、エージェントは自由形式のデータを返します。
• Agent の実行では、単純なスクレイプより多くのクレジットを消費します。支出を制限するには --max-credits を使用してください。
• 単一ページの簡単な抽出には、より高速で低コストな scrape を優先してください。

関連項目

• firecrawl-scrape — より簡単な単一ページの抽出
• firecrawl-interact — 手動でページを操作するための scrape + interact（より細かく制御できます）
• firecrawl-crawl — AI を使わない一括抽出
• firecrawl-build-scrape — ここで実行するのではなく、アプリに構造化抽出機能を組み込む方法

Alexandria セッションのフィードバック

Alexandria セッションの結果や、プロバイダー／機能の不足を報告するには、firecrawl alexandria feedback --rating good|partial|bad --url <website> --requested-functionality '<what was needed>' --objective '<the underlying goal of the task>' --rationale '<what happened>' --json を使用してください。理由には実際に確認した結果を記載してください。ジョブ ID は不要です。Alexandria の検索、発見、または実行から 20 分以内に送信してください。それを過ぎると受け付けられません。各送信につき 1 クレジットが返金されます。上限は、1 つの Web サイトにつき 10 クレジット、UTC の 1 日あたりチームごとに 100 クレジットです。任意の --provider-feedback および --capability-feedback JSON 配列を使って、具体的な不足を説明できます。フィールドを確認するには、firecrawl alexandria feedback --help を参照してください。プロバイダーは存在するものの必要な機能がない場合は、機能の問題として missing_capability を使用してください。機能の追加を依頼するには、requestedFunctionality を指定して new_capability_request を使用してください。