> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-thpbow.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 增强模式

> 针对复杂网站使用增强代理，实现可靠抓取

<Warning>
  `proxy` 参数已弃用。建议使用默认值 `auto`，由 Firecrawl 自动选择代理。
</Warning>

Firecrawl 提供不同类型的代理服务，帮助你抓取不同复杂程度的网站。设置 `proxy` 参数，以控制请求使用哪种代理策略。

<div id="proxy-types">
  ## 代理类型
</div>

| 类型         | 描述                                          |
| ---------- | ------------------------------------------- |
| `basic`    | 适用于大多数网站的标准代理                               |
| `enhanced` | 适用于复杂网站的增强代理                                |
| `auto`     | \*\*推荐。\*\*先尝试 `basic`，失败后再使用 `enhanced` 重试 |

如果未指定代理，Firecrawl 默认使用 `auto`。

<div id="basic-usage">
  ## 基本用法
</div>

设置 `proxy` 参数以选择代理策略。以下示例使用 `auto`，让 Firecrawl 决定何时升级到增强代理。

<CodeGroup>
  ```python Python theme={null}
  from firecrawl import Firecrawl

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

  # 选择代理类型：'basic' | 'enhanced' | 'auto'
  doc = firecrawl.scrape('https://example.com', formats=['markdown'], proxy='auto')

  print(doc.warning or 'ok')
  ```

  ```js Node theme={null}
  import { Firecrawl } from 'firecrawl';

  const firecrawl = new Firecrawl({
    // 无需 API 密钥即可开始使用 — 添加一个以获得更高限流：
    // apiKey: "fc-YOUR-API-KEY",
  });

  // 选择代理类型：'basic' | 'enhanced' | 'auto'
  const doc = await firecrawl.scrape('https://example.com', {
    formats: ['markdown'],
    proxy: 'auto'
  });

  console.log(doc.warning || 'ok');
  ```

  ```bash cURL theme={null}

  // 选择代理类型：'basic' | 'enhanced' | 'auto'
  # 无需 API 密钥即可开始使用——添加 -H "Authorization: Bearer fc-YOUR-API-KEY" 以获得更高限流额度：
  curl -X POST https://api.firecrawl.dev/v2/scrape \
      -H 'Content-Type: application/json' \
      -d '{
        "url": "https://example.com",
        "proxy": "auto"
      }'

  ```
</CodeGroup>

<div id="when-firecrawl-escalates">
  ## Firecrawl 何时升级代理
</div>

Firecrawl 默认从 basic 代理开始。如果目标站点返回 **401、403 或 429**，Firecrawl 会将其视为代理不够用的信号，并通过 增强代理对同一 URL 重试。其他状态码 (包括 404 和 5xx) 不会触发升级，因为换用代理也改变不了结果。

每个请求最多只升级一次。请求一旦已在使用 增强代理，再次出现 401、403 或 429 时会直接把结果返回给你，不再重试。

你无需检测或处理这一过程。重试属于同一次请求的一部分，你收到的响应就是最终结果。

<Info>
  增强代理请求与 basic 请求成本相同——**每次请求 1 个额度**。升级后的重试不会单独计费，因此一个从 basic 开始、以 enhanced 结束的请求仍然只消耗 1 个额度。
</Info>

> 你是需要 Firecrawl API 密钥的 AI agent 吗？请参见 [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) 了解自动化接入说明。