跳转到主要内容
Firecrawl 提供多种代理类型，帮助你在应对不同强度的反爬虫时抓取网站。可通过 proxy 参数指定代理类型。
默认情况下，Firecrawl 会将所有请求经由代理转发，以提升可靠性与可访问性，即使你未指定代理类型或位置也同样生效。

​
基于位置的代理选择

Firecrawl 会根据你指定或自动检测到的位置，自动选择最合适的代理，从而优化抓取性能和可靠性。但目前并非所有地区都受支持。当前可用的地区如下：
Country CodeCountry NameStealth Mode Support
AE阿拉伯联合酋长国否
AU澳大利亚是
BR巴西否
CA加拿大否
CN中国否
CZ捷克否
DE德国否
ES西班牙否
FR法国否
GB英国否
GR希腊否
HU匈牙利否
ID印度尼西亚否
IL以色列否
IN印度否
IT意大利否
JP日本否
MY马来西亚否
NO挪威否
PL波兰否
PT葡萄牙否
QA卡塔尔否
SG新加坡否
TR土耳其否
US美国是
VN越南否
受支持的代理位置列表最后更新时间：2025 年 12 月 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 会自动改用 stealth 代理重试抓取。如果使用 stealth 重试成功，该次抓取将收取 5 点额度；如果第一次使用 basic 抓取就成功，则只会收取正常费用。
注意： 关于使用 stealth 代理的详细信息（包括额度消耗与重试策略），请参阅 Stealth 模式文档。