> ## 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 Serverの概要とクイックスタート。

OctoparseのWebスクレイピングプラットフォームを、MCP対応のAIエージェントに接続できます。テンプレートの検索、クラウドタスクの実行、データの取得を、すべて自然言語で操作できます。

Octoparseが提供するテンプレートと、クラウド実行に対応したタスクを利用できます。

## 前提条件

<Steps>
  <Step title="Octoparseアカウント">
    どのOctoparseアカウントでも接続できます。フリーおよびベーシックプランでは、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>

***

## クイックスタート

### サーバーURL

```text サーバー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など、自動化された環境やヘッドレス環境に適しています。

    APIキーは[Octoparseアカウントセンター](https://www.octoparse.com/console/account-center/api-keys)で取得できます。
  </Card>
</Columns>

## 対応クライアント

<Columns cols={2}>
  <Card title="ChatGPT" icon="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/chatgpt.svg" />

  <Card title="Codex" icon="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/codex.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=56e3220fb8fd0f8dd7aa931b0836e0cf" width="36" height="36" data-path="images/mcp/codex.svg" />

  <Card title="Claude" icon="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/claude.svg" />

  <Card title="Claude Code" icon="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/claude-code.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=41a82256b2cd0af12c8c70542c817228" width="36" height="36" data-path="images/mcp/claude-code.svg" />

  <Card title="OpenClaw" icon="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/openclaw.svg" />

  <Card title="Cursor" icon="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/cursor.svg" />

  <Card title="VS Code" icon="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/vscode.svg" />

  <Card title="Antigravity" icon="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/antigravity.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=fabe46bcd843c81a23b16f27bc031b23" width="36" height="36" data-path="images/mcp/antigravity.svg" />
</Columns>

<AccordionGroup>
  <Accordion title="ChatGPT">
    <Steps>
      <Step title="カスタマイズ設定を開く">
        プロフィール画像をクリックし、**Customize ChatGPT**を選択します。
      </Step>

      <Step title="Developer Modeを有効にする">
        **Apps → Advanced Settings**に移動し、<strong>Developer Mode (Beta)</strong>をオンにします。
      </Step>

      <Step title="Octoparseアプリを作成する">
        **Create app**をクリックします。**Name**に`Octoparse`、**MCP URL**に`https://mcp.octoparse.com`を入力します。OAuth Client IDとSecretは空欄のままにし、確認事項に同意してアプリを作成します。
      </Step>

      <Step title="OAuthで認可する">
        ChatGPTからOctoparseにリダイレクトされます。サインインして**Allow**をクリックします。
      </Step>
    </Steps>

    [セットアップガイドを見る](https://helpcenter.octoparse.com/ja/articles/13444709-mcp%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%A6octoparse%E3%81%A8chatgpt%E3%82%92%E9%80%A3%E6%90%BA%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95-%E3%82%B9%E3%83%86%E3%83%83%E3%83%97%E3%81%94%E3%81%A8%E3%81%AB%E8%A7%A3%E8%AA%AC)
  </Accordion>

  <Accordion 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 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/ja/articles/14001844-mcp%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%A6octoparse%E3%81%A8claude%E3%82%92%E9%80%A3%E6%90%BA%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95-%E3%82%B9%E3%83%86%E3%83%83%E3%83%97%E3%81%94%E3%81%A8%E3%81%AB%E8%A7%A3%E8%AA%AC)
  </Accordion>

  <Accordion 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 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ツールを初めて呼び出すとブラウザが開きます。サインインして**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の設定で`mcp.servers`の下に以下を追加します。

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

  <Accordion 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/ja/articles/14013893-mcp%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%A6octoparse%E3%81%A8cursor%E3%82%92%E9%80%A3%E6%90%BA%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95-%E3%82%B9%E3%83%86%E3%83%83%E3%83%97%E3%81%94%E3%81%A8%E3%81%AB%E8%A7%A3%E8%AA%AC)

    ***

    **認証方法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 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/ja/articles/14004033-mcp%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%A6octoparse%E3%81%A8vs-code%E3%82%92%E9%80%A3%E6%90%BA%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95-%E3%82%B9%E3%83%86%E3%83%83%E3%83%97%E3%81%94%E3%81%A8%E3%81%AB%E8%A7%A3%E8%AA%AC)

    ***

    **認証方法B：APIキー**

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

  <Accordion title="Antigravity">
    <Note>
      Antigravityでは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ツールを初めて呼び出すとブラウザが開くので、サインインして**Allow**をクリックします。

    ***

    **認証方法B：APIキー**

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