Firecrawl は、ボット対策の強度が異なるウェブサイトのスクレイピングを支援するために、複数のプロキシタイプを提供しています。プロキシタイプは proxy パラメータで指定できます。
既定では、プロキシタイプやロケーションを指定しなくても、信頼性とアクセス性を確保するために、Firecrawl はすべてのリクエストをプロキシ経由でルーティングします。

ロケーションベースのプロキシ選択

Firecrawl は、指定または自動検出されたロケーションに基づいて最適なプロキシを自動で選択します。これにより、スクレイピングのパフォーマンスと信頼性を向上できます。ただし、現時点ですべてのロケーションがサポートされているわけではありません。利用可能なロケーションは次のとおりです:
Country CodeCountry NameStealth Mode Support
AEUnited Arab EmiratesNo
AUAustraliaYes
BRBrazilYes
CACanadaNo
CNChinaNo
CZCzechiaNo
DEGermanyYes
FRFranceYes
GBUnited KingdomNo
ILIsraelNo
INIndiaNo
ITItalyNo
JPJapanNo
PLPolandNo
PTPortugalNo
QAQatarNo
TRTurkeyNo
USUnited StatesYes
VNVietnamNo
サポート対象のプロキシロケーション一覧は 2025年9月12日に最終更新されました。提供状況は今後変更される可能性があります。
上記にないロケーションでプロキシが必要な場合は、contact us まで要件をご連絡ください。 プロキシまたはロケーションを指定しない場合、Firecrawl は対象サイトとリクエストに基づいて最適なオプションを自動選択します。

プロキシのロケーション指定方法

リクエストで location.country パラメータを設定すると、特定のプロキシロケーションを指定できます。たとえば、ブラジルのプロキシを使う場合は location.countryBR を指定します。 詳細は APIリファレンスの location.country を参照してください。
from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

doc = firecrawl.scrape('https://example.com',
    formats=['markdown'],
    location={
        'country': 'US',
        'languages': ['en']
    }
)

print(doc)
プロキシが利用できない国を指定した場合、Firecrawl は利用可能な最寄りのリージョン(EU または US)を使用し、ブラウザのロケーションは指定した国に設定します。

プロキシタイプ

Firecrawl は 3 種類のプロキシをサポートします:
  • basic: ボット対策がない〜基本的な対策のみのサイト向けプロキシ。高速で、通常は問題なく動作します。
  • stealth: 高度なボット対策があるサイトや、通常のプロキシをブロックするサイト向けのステルスプロキシ。速度は低下しますが、特定のサイトではより安定して動作します。 ステルスモードの詳細 →
  • auto: basic プロキシが失敗した場合、Firecrawl が自動的にステルスプロキシでスクレイピングを再試行します。ステルスでの再試行が成功した場合は、そのスクレイプに 5 クレジットが請求されます。最初の basic で成功した場合は、通常のコストのみが請求されます。

注: クレジット消費や再試行戦略など、ステルスプロキシの詳細は ステルスモードのドキュメントをご覧ください。