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 了解自动化接入说明。