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 日。可用性可能会随时间变化。
如果你需要上述列表未包含位置的代理，请联系我们并告知你的需求。 如果你未指定代理或位置，Firecrawl 将根据目标站点和你的请求自动选择最优选项。

​
如何指定代理位置

你可以在请求中通过设置 location.country 参数来指定代理位置。例如，要使用巴西代理，将 location.country 设置为 BR。 更多详情请参阅 location.country 的 API 参考。 
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 支持三种代理类型：
  • basic：适用于抓取无反爬或仅有基础反爬的网站。速度快，通常可行。
  • stealth：适用于抓取具有高级反爬机制或会屏蔽常规代理的网站的隐身代理。速度较慢，但在某些网站上更可靠。了解 Stealth 模式 →
  • auto：若 basic 代理失败，Firecrawl 会自动改用隐身代理重试抓取。若隐身重试成功，该次抓取将计费 5 个积分；若首次使用 basic 成功，则仅按常规费用计费。
注意： 关于隐身代理的使用详情（包括积分消耗与重试策略），请参阅 Stealth 模式文档。