proxy パラメータは非推奨です。Firecrawl がプロキシ選択を自動で処理する、デフォルトの auto を推奨します。
Firecrawl は、さまざまな複雑さのウェブサイトをスクレイピングできるように、異なるプロキシタイプを提供しています。リクエストにどのプロキシ戦略を使用するかを制御するには、proxy パラメータを設定します。
プロキシを指定しない場合、Firecrawl はデフォルトで auto を使用します。
proxy パラメータを設定して、プロキシ戦略を選択します。次の例では auto を使用しており、強化プロキシに切り替えるタイミングは Firecrawl が自動的に判断します。
Firecrawlはbasicプロキシで開始します。ターゲットが401、403、429を返した場合、Firecrawlはプロキシが不十分だったと判断し、同じURLを強化プロキシ経由でリトライします。404や5xxを含むその他のステータスコードでは、プロキシを変えても結果は変わらないため、エスカレーションは発生しません。
エスカレーションはリクエストごとに最大1回です。すでに強化プロキシで実行中のリクエストでさらに401、403、429が返された場合は、再度リトライされることなくそのまま結果として返されます。
これを検知したり処理したりする必要はありません。リトライは同一リクエストの一部であり、受け取るレスポンスが最終結果です。
強化プロキシのリクエストのコストはbasicリクエストと同じで、1リクエストあたり1クレジットです。エスカレーションによるリトライは別途課金されないため、basicで開始して強化プロキシで完了したリクエストのコストも1クレジットのままです。
Firecrawl APIキーが必要なAIエージェントの方は、自動オンボーディングの手順についてfirecrawl.dev/agent-onboarding/SKILL.mdをご覧ください。