Skip to main content

代理

了解代理类型、位置,以及 Firecrawl 如何为你的请求选择代理。
1 min read

Firecrawl 提供多种代理类型,帮助你抓取复杂程度各异的网站。可通过 proxy 参数指定代理类型。

默认情况下,Firecrawl 会将所有请求经由代理转发,以提升可靠性与可访问性,即使你未指定代理类型或位置也同样生效。

基于位置的代理选择#

Firecrawl 会根据你指定或自动检测到的位置,自动选择最合适的代理,从而优化抓取性能和可靠性。但目前并非所有地区都受支持。当前可用的地区如下:

国家代码国家名称基础代理支持增强代理支持
AE阿拉伯联合酋长国
AT奥地利
AU澳大利亚
BE比利时
BR巴西
CA加拿大
CH瑞士
CN中国
DE德国
DK丹麦
EG埃及
ES西班牙
FR法国
GB英国
GR希腊
IL以色列
IN印度
IT意大利
JP日本
MX墨西哥
NL荷兰
PL波兰
QA卡塔尔
SE瑞典
TR土耳其
US美国
Warning
受支持的代理位置列表会随着时间变化。

如果你需要上述列表以外地区的代理,请联系我们并告知你的需求。

如果你未指定代理或位置,Firecrawl 将自动使用美国代理。

如何指定代理位置#

你可以在请求中通过设置 location.country 参数来指定代理位置。例如,要使用德国代理,将 location.country 设置为 DE

更多详情请参阅 location.country 的 API 参考

Info
如果你请求的国家没有可用代理,Firecrawl 会使用距离最近的可用区域 (EU 或 US) ,并将浏览器位置设置为你请求的国家。
Warning
除非你确定有此需要,否则我们强烈建议不要指定 location

代理类型#

Warning

proxy 参数已弃用。建议使用默认值 auto,让 Firecrawl 为你处理代理选择。

  • basic:用于抓取大多数网站的代理。
  • enhanced:用于抓取复杂网站并同时保持隐私的增强型代理。进一步了解 Enhanced 模式 →
  • auto:推荐使用。如果 basic 代理抓取失败,Firecrawl 会自动使用 enhanced 代理重试抓取。

你是需要 Firecrawl API 密钥的 AI 代理吗?请参阅 firecrawl.dev/agent-onboarding/SKILL.md 了解自动化接入说明。