> ## 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.

# Octoparse MCP Server

> Octoparse MCP 서버 개요와 빠른 시작 가이드입니다.

Octoparse 웹 스크래핑 플랫폼을 MCP 호환 AI 에이전트에 연결하세요. 자연어만으로 템플릿을 검색하고 클라우드 작업을 실행하며 데이터를 가져올 수 있습니다.

사전 제작된 Octoparse 템플릿 및 클라우드 지원 작업과 함께 사용할 수 있습니다.

## 사전 요구 사항

<Steps>
  <Step title="Octoparse 계정">
    모든 Octoparse 계정에서 연결할 수 있습니다. 무료 및 Basic 사용자는 MCP 추출용 레코드 2,000개를 매주 무료로 받으므로 시작을 위해 업그레이드할 필요가 없습니다.
  </Step>

  <Step title="MCP 호환 클라이언트">
    ChatGPT, Codex, Claude, Claude Code, OpenClaw, Cursor, VS Code(GitHub Copilot), Antigravity 등을 사용할 수 있습니다.
  </Step>
</Steps>

***

## 범위 및 제한 사항

<Columns cols={2}>
  <Card title="✅ 가능한 작업">
    * 사전 제작된 스크래핑 템플릿 검색
    * 사전 설정된 템플릿에서 새 클라우드 작업을 생성해 실행
    * 클라우드 지원 작업 실행 시작 및 모니터링
    * 수집된 데이터 내보내기(JSON/CSV)
    * 기존 작업 목록 조회 및 검색
    * 실행 중인 작업 시작 또는 중지
    * 쿠폰 코드 사용
  </Card>

  <Card title="❌ 불가능한 작업">
    * 로컬 전용 작업 실행(데스크톱 클라이언트 필요)
    * 완전한 사용자 지정 작업 생성 또는 필드, 페이지 넘기기, 루프, 브라우저 워크플로 같은 작업 구성 세부 정보 편집
    * 사용자 지정 스크래핑 템플릿 업로드
    * 계정 설정 또는 청구 정보 접근
    * 사전 설정된 템플릿 없이 스크래핑
  </Card>
</Columns>

<Note>
  MCP는 Octoparse 사전 설정 템플릿에서 새 클라우드 작업을 생성하고 실행할 수 있습니다. 완전한 사용자 지정 스크래핑 워크플로를 만들거나 사용자 지정 작업 구성 세부 정보를 편집할 수는 없습니다. 사용자 지정 워크플로가 필요하면 먼저 Octoparse에서 만든 뒤 MCP로 실행, 모니터링, 중지 또는 내보내기하세요.
</Note>

***

## 빠른 시작

### 서버 URL

```text Server URL theme={null}
https://mcp.octoparse.com
```

### 인증 방법

<Columns cols={2}>
  <Card title="경로 A: OAuth 2.1" icon="lock-keyhole">
    브라우저 기반 로그인 방식이며 대부분의 사용자에게 권장됩니다. API 키 없이 메시지가 표시될 때 Octoparse에 로그인하면 됩니다.
  </Card>

  <Card title="경로 B: API 키" icon="key">
    API 키로 직접 인증합니다. Claude Code, Codex CLI, VS Code, TRAE, OpenClaw 같은 자동화 또는 헤드리스 환경에 적합합니다.

    [Octoparse 계정 센터](https://www.octoparse.kr/console/account-center/api-keys)에서 키를 발급하세요.
  </Card>
</Columns>

## 지원 클라이언트

아래에서 MCP 클라이언트를 선택하고 설정 단계를 따르세요.

<div className="mb-8 grid grid-cols-2 gap-2 sm:grid-cols-4">
  <a href="#chatgpt" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/chatgpt.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>ChatGPT</span>
  </a>

  <a href="#codex" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/codex.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=56e3220fb8fd0f8dd7aa931b0836e0cf" alt="" className="h-6 w-6 shrink-0" width="36" height="36" data-path="images/mcp/codex.svg" />

    <span>Codex</span>
  </a>

  <a href="#claude" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/claude.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>Claude</span>
  </a>

  <a href="#claude-code" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/claude-code.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=41a82256b2cd0af12c8c70542c817228" alt="" className="h-6 w-6 shrink-0" width="36" height="36" data-path="images/mcp/claude-code.svg" />

    <span>Claude Code</span>
  </a>

  <a href="#openclaw" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/openclaw.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>OpenClaw</span>
  </a>

  <a href="#cursor" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/cursor.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>Cursor</span>
  </a>

  <a href="#vs-code" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/vscode.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>VS Code</span>
  </a>

  <a href="#antigravity" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/antigravity.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=fabe46bcd843c81a23b16f27bc031b23" alt="" className="h-6 w-6 shrink-0" width="36" height="36" data-path="images/mcp/antigravity.svg" />

    <span>Antigravity</span>
  </a>
</div>

<AccordionGroup>
  <Accordion id="chatgpt" title="ChatGPT">
    <Steps>
      <Step title="사용자 지정 설정 열기">
        프로필 아바타를 클릭하고 **Customize ChatGPT**를 선택합니다.
      </Step>

      <Step title="개발자 모드 활성화">
        **Apps → Advanced Settings**로 이동해 \*\*Developer Mode (Beta)\*\*를 켭니다.
      </Step>

      <Step title="Octoparse 앱 생성">
        **Create app**을 클릭합니다. 이름을 `Octoparse`, MCP URL을 `https://mcp.octoparse.com`으로 설정하고 OAuth Client ID와 Secret은 비워 둡니다. 확인 사항에 동의한 뒤 앱을 생성합니다.
      </Step>

      <Step title="OAuth로 승인">
        ChatGPT가 Octoparse로 리디렉션합니다. 로그인한 뒤 **Allow**를 클릭합니다.
      </Step>
    </Steps>

    [전체 설정 가이드 보기](https://helpcenter.octoparse.com/ko/articles/13444709-how-to-integrate-octoparse-with-chatgpt-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="codex" title="Codex">
    <Note>Codex CLI와 Codex IDE 확장 프로그램은 동일한 MCP 구성(`~/.codex/config.toml`)을 공유합니다. 한 번 설정하면 두 환경에서 모두 작동합니다.</Note>

    **경로 A: OAuth**

    <Steps>
      <Step title="서버 추가">
        ```bash theme={null}
        codex mcp add octoparse --url https://mcp.octoparse.com
        ```
      </Step>

      <Step title="OAuth로 승인">
        ```bash theme={null}
        codex mcp login octoparse
        ```

        브라우저 창이 열립니다. Octoparse에 로그인하고 **Allow**를 클릭합니다.
      </Step>
    </Steps>

    ***

    **경로 B: API 키**

    `~/.codex/config.toml`에 다음을 추가합니다.

    ```toml theme={null}
        [mcp_servers.octoparse]
        url = "https://mcp.octoparse.com"
        http_headers = { "x-api-key" = "YOUR_API_KEY" }
    ```
  </Accordion>

  <Accordion id="claude" title="Claude">
    **경로 A: OAuth**

    <Steps>
      <Step title="Settings → Connectors 열기">
        Claude 사이드바에서 **Settings → Connectors**로 이동합니다.
      </Step>

      <Step title="서버 URL 추가">
        **Add Connector**를 클릭하고 `https://mcp.octoparse.com`을 입력합니다.
      </Step>

      <Step title="OAuth로 승인">
        **Connect**를 클릭합니다. 브라우저 창이 열리면 로그인하고 **Allow**를 클릭합니다.
      </Step>
    </Steps>

    [전체 설정 가이드 보기](https://helpcenter.octoparse.com/ko/articles/14001844-how-to-integrate-octoparse-with-claude-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="claude-code" title="Claude Code">
    <Note>`claude mcp add`로 추가한 서버는 Claude Code CLI, 데스크톱 앱 및 IDE 확장 프로그램(VS Code/JetBrains)에서 공유됩니다. 한 번 설정하면 모든 환경에서 작동합니다.</Note>

    **경로 A: OAuth**

    <Steps>
      <Step title="서버 추가">
        ```bash theme={null}
        claude mcp add --transport http octoparse https://mcp.octoparse.com
        ```
      </Step>

      <Step title="OAuth로 승인">
        Claude Code를 시작하고 `/mcp`를 실행한 뒤 **octoparse**를 선택해 인증합니다. 브라우저 창이 열리면 Octoparse에 로그인하고 **Allow**를 클릭합니다.
      </Step>
    </Steps>

    ***

    **경로 B: API 키**

    ```bash theme={null}
    claude mcp add --transport http octoparse https://mcp.octoparse.com --header "x-api-key: YOUR_API_KEY"
    ```
  </Accordion>

  <Accordion id="openclaw" title="OpenClaw">
    **경로 A: OAuth**

    <Steps>
      <Step title="OpenClaw 설치">
        OpenClaw를 설치한 뒤 온보딩 명령어를 실행합니다.
      </Step>

      <Step title="MCP 서버 등록">
        Octoparse MCP 서버를 설정하고 구성을 확인합니다.
      </Step>

      <Step title="Gateway 다시 시작">
        구성을 적용하려면 Gateway를 다시 시작합니다.
      </Step>

      <Step title="OAuth로 승인">
        첫 Octoparse 도구 호출 시 OAuth용 브라우저가 열립니다. 로그인하고 **Allow**를 클릭합니다.
      </Step>
    </Steps>

    ***

    **경로 B: API 키**

    ```bash theme={null}
        mcporter config add octoparse https://mcp.octoparse.com
        mcporter config set octoparse header.x-api-key "YOUR_API_KEY"
    ```

    그런 다음 OpenClaw 구성에 추가합니다.

    ```json theme={null}
        {
          "mcp": {
            "servers": {
              "octoparse": {
                "command": "mcporter",
                "args": ["run", "stdio", "--server", "octoparse"]
              }
            }
          }
        }
    ```
  </Accordion>

  <Accordion id="cursor" title="Cursor">
    **경로 A: OAuth**

    <Steps>
      <Step title="Cursor Settings 열기">
        Cursor를 열고 오른쪽 위의 설정 아이콘을 클릭합니다.
      </Step>

      <Step title="Tools & MCP로 이동">
        왼쪽 사이드바에서 **Tools & MCP**를 선택합니다.
      </Step>

      <Step title="사용자 지정 MCP 서버 추가">
        **Add Custom MCP**를 클릭합니다. Cursor가 MCP 구성 파일을 열면 `https://mcp.octoparse.com`을 추가하고 저장합니다.
      </Step>
    </Steps>

    [전체 설정 가이드 보기](https://helpcenter.octoparse.com/ko/articles/14013893-how-to-integrate-octoparse-with-cursor-via-mcp-step-by-step)

    ***

    **경로 B: API 키**

    `~/.cursor/mcp.json`에 다음을 추가합니다.

    ```json theme={null}
        {
          "mcpServers": {
            "octoparse": {
              "type": "http",
              "url": "https://mcp.octoparse.com",
              "headers": {
                "x-api-key": "YOUR_API_KEY"
              }
            }
          }
        }
    ```
  </Accordion>

  <Accordion id="vs-code" title="VS Code">
    <Info>활성 **GitHub Copilot** 구독이 필요합니다.</Info>

    **경로 A: OAuth**

    `.vscode/mcp.json`에 다음을 추가합니다.

    ```json theme={null}
        {
          "servers": {
            "octoparse": {
              "type": "http",
              "url": "https://mcp.octoparse.com"
            }
          }
        }
    ```

    [전체 설정 가이드 보기](https://helpcenter.octoparse.com/ko/articles/14004033-how-to-integrate-octoparse-with-vs-code-via-mcp-step-by-step)

    ***

    **경로 B: API 키**

    ```json theme={null}
        {
          "servers": {
            "octoparse": {
              "type": "http",
              "url": "https://mcp.octoparse.com",
              "headers": {
                "x-api-key": "YOUR_API_KEY"
              }
            }
          }
        }
    ```
  </Accordion>

  <Accordion id="antigravity" title="Antigravity">
    <Note>Antigravity IDE와 Antigravity CLI는 동일한 MCP 구성(`~/.gemini/config/mcp_config.json`)을 공유합니다. 한 번 설정하면 두 환경에서 모두 작동합니다. IDE에서는 에이전트 패널의 **MCP Servers → View raw config**에서도 열 수 있습니다.</Note>

    **경로 A: OAuth**

    `~/.gemini/config/mcp_config.json`에 다음을 추가합니다.

    ```json theme={null}
        {
          "mcpServers": {
            "octoparse": {
              "serverUrl": "https://mcp.octoparse.com"
            }
          }
        }
    ```

    MCP 서버 목록을 새로 고칩니다. 첫 Octoparse 도구 호출 시 OAuth용 브라우저가 열리면 로그인하고 **Allow**를 클릭합니다.

    ***

    **경로 B: API 키**

    ```json theme={null}
        {
          "mcpServers": {
            "octoparse": {
              "serverUrl": "https://mcp.octoparse.com",
              "headers": {
                "x-api-key": "YOUR_API_KEY"
              }
            }
          }
        }
    ```
  </Accordion>
</AccordionGroup>