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、--toolkits <slugs>（最大 5 件）、--max-calls <n>、--require-approval、または --on-terms-required skip|ask のいずれかの Alexandria フラグを指定して開始する必要があります。スレッド上での後続のやり取りにも、これらの設定が引き継がれます。

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 ダッシュボードでプロバイダーの利用規約に同意した場合にのみ続行されます。ユーザーに https://www.firecrawl.dev/app/settings?tab=data-sources を案内してください。先に利用規約を確認したい場合は、firecrawl alexandria terms show <provider> を使用します。承認しても、利用規約への同意にはなりません。

ジョブ 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 を使用します。