> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 요청 한도

> 요청 한도를 이해하고 응답 헤더를 사용해 재시도 로직을 처리하는 방법을 알아보세요.

## 요청 한도

<Info>
  Octoparse MCP 서버는 OAuth 세션당 분당 최대 **300개 요청**을 허용합니다. 이 한도는 검색, 실행, 내보내기 및 작업 관리를 포함한 모든 MCP 도구 호출에 적용됩니다.
</Info>

### 한도를 초과하면 발생하는 일

<Warning>
  요청 한도를 초과하면 서버에서 HTTP `429 Too Many Requests`를 반환합니다.
</Warning>

고정된 대기 시간에 의존하지 말고 아래 응답 헤더를 사용해 재시도 시점을 결정하세요.

### 재시도 헤더

<table>
  <thead>
    <tr>
      <th style={{ width: "260px" }}>헤더</th>
      <th>설명</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code style={{ whiteSpace: "nowrap" }}>X-RateLimit-Limit</code></td>
      <td>현재 요청 한도 구간에서 허용되는 최대 요청 수입니다.</td>
    </tr>

    <tr>
      <td><code style={{ whiteSpace: "nowrap" }}>X-RateLimit-Remaining</code></td>
      <td>현재 구간에 남은 요청 수입니다.</td>
    </tr>

    <tr>
      <td><code style={{ whiteSpace: "nowrap" }}>X-RateLimit-Reset</code></td>
      <td>현재 구간이 재설정되는 시점을 나타내는 ISO 8601 타임스탬프입니다. 다음으로 안전하게 재시도할 시간을 결정할 때 사용하세요.</td>
    </tr>

    <tr>
      <td><code style={{ whiteSpace: "nowrap" }}>X-RateLimit-Window</code></td>
      <td>현재 요청 한도 구간의 길이(밀리초)입니다.</td>
    </tr>
  </tbody>
</table>

### 권장 처리 방법

<Steps>
  <Step title="상태 코드 확인">
    서버가 `429`를 반환하면 영구 실패가 아니라 요청 한도 적용으로 처리하세요.
  </Step>

  <Step title="재시도 헤더 확인">
    `X-RateLimit-Remaining`과 `X-RateLimit-Reset`을 확인하여 현재 구간이 소진되었는지와 재설정 시점을 파악하세요.
  </Step>

  <Step title="재설정 후 재시도">
    다음 요청을 보내기 전에 `X-RateLimit-Reset`에 표시된 시간까지 기다리세요.
  </Step>
</Steps>