跳转到主要内容
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 年 11 月 17 日。可用性可能会随时间变化。
如果你需要上述列表以外地区的代理,请联系我们并告知你的需求。 如果你未指定代理或位置,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 模式文档