代理

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

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

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

| 国家代码 | 国家名称 | 基础代理支持 | 增强代理支持 | | ---- | -------- | ------ | ------ | | AE | 阿拉伯联合酋长国 | 是 | 否 | | AU | 澳大利亚 | 是 | 否 | | BR | 巴西 | 是 | 否 | | CA | 加拿大 | 是 | 否 | | CN | 中国 | 是 | 否 | | DE | 德国 | 是 | 否 | | DK | 丹麦 | 是 | 否 | | EE | 爱沙尼亚 | 是 | 否 | | EG | 埃及 | 是 | 否 | | ES | 西班牙 | 是 | 否 | | FR | 法国 | 是 | 否 | | GB | 英国 | 是 | 否 | | GR | 希腊 | 是 | 否 | | IL | 以色列 | 是 | 否 | | IN | 印度 | 是 | 否 | | IT | 意大利 | 是 | 否 | | JP | 日本 | 是 | 否 | | NL | 荷兰 | 是 | 是 | | PT | 葡萄牙 | 是 | 否 | | QA | 卡塔尔 | 是 | 否 | | TR | 土耳其 | 是 | 否 | | US | 美国 | 是 | 是 |

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

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

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

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

from firecrawl import Firecrawl

firecrawl = Firecrawl(
  # 无需 API 密钥即可开始使用 — 添加一个以获得更高的限流上限：
  # api_key="fc-YOUR-API-KEY",
)

doc = firecrawl.scrape('https://example.com',
    formats=['markdown'],
    location={
        'country': 'US',
        'languages': ['en']
    }
)

print(doc)

Firecrawl 支持三种类型的代理：

• basic：用于抓取大多数网站的代理。速度快，通常能正常工作。
• enhanced：用于抓取复杂网站并同时保持隐私的增强型代理。速度较慢，但在某些网站上更可靠。进一步了解 Enhanced 模式 →
• auto：如果 basic 代理抓取失败，Firecrawl 会自动使用 enhanced 代理重试抓取。如果使用 enhanced 重试成功，该次抓取将收取 5 点额度；如果第一次使用 basic 抓取就成功，则只会收取正常费用。

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

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