代理

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

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

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

​

基于位置的代理选择

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

国家代码	国家名称	基础代理支持	增强代理支持
AE	阿拉伯联合酋长国	是	否
AU	澳大利亚	是	是
BR	巴西	是	否
CA	加拿大	是	否
CN	中国	是	否
CZ	捷克	是	否
DE	德国	是	否
EG	埃及	是	否
ES	西班牙	是	否
FR	法国	是	否
GB	英国	是	否
GR	希腊	是	否
HU	匈牙利	是	否
ID	印度尼西亚	是	否
IL	以色列	是	否
IN	印度	是	否
IT	意大利	是	否
JP	日本	是	否
MY	马来西亚	是	否
NO	挪威	是	否
PL	波兰	是	否
PT	葡萄牙	是	否
QA	卡塔尔	是	否
SG	新加坡	是	否
TR	土耳其	是	否
US	美国	是	是
VN	越南	是	否

受支持的代理位置列表会随着时间变化。

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

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

​

如何指定代理位置

你可以在请求中通过设置 location.country 参数来指定代理位置。例如，要使用巴西代理，将 location.country 设置为 BR。

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

Python

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：用于抓取大多数网站的代理。速度快，通常能正常工作。
• enhanced：用于抓取具有高级反爬虫方案的网站，或会屏蔽普通代理的网站的增强型代理。速度较慢，但在某些网站上更可靠。进一步了解 Enhanced 模式 →
• auto：如果 basic 代理抓取失败，Firecrawl 会自动改用 enhanced 代理重试抓取。如果使用 enhanced 重试成功，该次抓取将收取 5 点额度；如果第一次使用 basic 抓取就成功，则只会收取正常费用。

---

注意： 关于使用 enhanced 代理的详细信息（包括额度消耗与重试策略），请参阅 Enhanced 模式文档。