Octoparse MCP Server

✅ Can do

Search pre-built scraping templates
Create a new cloud task from a preset template and run it
Trigger and monitor cloud-supported task runs
Export collected data (JSON / CSV)
List and search existing tasks
Start or stop a running task
Redeem a coupon code

❌ Cannot do

Run local-only tasks (desktop client required)
Create fully custom tasks or edit task configuration details such as fields, pagination, loops, or browser workflow
Upload custom scraping templates
Access account settings or billing
Scrape without a preset template

MCP can create and run new cloud tasks from Octoparse preset templates. It cannot create fully custom scraping workflows or edit custom task configuration details. If you need a custom workflow, create it in Octoparse first, then use MCP to run, monitor, stop, or export it.

Quick start

Server URL

https://mcp.octoparse.com

Authentication methods

Path A: OAuth 2.1

Browser-based login. Recommended for most users. No API key needed — just sign in to Octoparse when prompted.

Path B: API key

Direct API key authentication. Best for automated or headless environments like Claude Code, Codex CLI, VS Code, TRAE, and OpenClaw.Get your key from your Octoparse account center.

Supported clients

ChatGPT

Open Customization settings

Click your profile avatar and choose Customize ChatGPT.

Enable Developer Mode

Go to Apps → Advanced Settings and turn on Developer Mode (Beta).

Create the Octoparse app

Click Create app. Set Name to Octoparse, MCP URL to https://mcp.octoparse.com, leave OAuth Client ID and Secret blank, confirm the acknowledgement, then create the app.

Authorize via OAuth

ChatGPT redirects to Octoparse. Sign in and click Allow.

See full setup guide

Codex

Codex CLI and the Codex IDE extension share the same MCP configuration (~/.codex/config.toml). Set it up once and it works in both.

Path A: OAuth

Add the server

codex mcp add octoparse --url https://mcp.octoparse.com

Authorize via OAuth

codex mcp login octoparse

A browser window opens. Sign in to Octoparse and click Allow.

Path B: API KeyAdd to ~/.codex/config.toml:

    [mcp_servers.octoparse]
    url = "https://mcp.octoparse.com"
    http_headers = { "x-api-key" = "YOUR_API_KEY" }

Claude

Path A: OAuth

Open Settings → Connectors

In the Claude sidebar, go to Settings → Connectors.

Add the server URL

Click Add Connector and enter https://mcp.octoparse.com.

Authorize via OAuth

Click Connect. A browser window opens. Sign in and click Allow.

See full setup guide

Claude Code

Servers added with claude mcp add are shared across the Claude Code CLI, desktop app, and IDE extensions (VS Code / JetBrains). Set it up once and it works everywhere.

Path A: OAuth

Add the server

claude mcp add --transport http octoparse https://mcp.octoparse.com

Authorize via OAuth

Start Claude Code and run /mcp, then select octoparse to authenticate. A browser window opens — sign in to Octoparse and click Allow.

Path B: API Key

claude mcp add --transport http octoparse https://mcp.octoparse.com --header "x-api-key: YOUR_API_KEY"

OpenClaw

Path A: OAuth

Install OpenClaw

Install OpenClaw, then run the onboard command.

Set the Octoparse MCP server and verify the configuration.

Restart the Gateway

Restart the Gateway to apply the configuration.

Authorize via OAuth

Your first Octoparse tool call opens a browser for OAuth. Sign in and click Allow.

Path B: API Key

    mcporter config add octoparse https://mcp.octoparse.com
    mcporter config set octoparse header.x-api-key "YOUR_API_KEY"

Then add to OpenClaw config:

    {
      "mcp": {
        "servers": {
          "octoparse": {
            "command": "mcporter",
            "args": ["run", "stdio", "--server", "octoparse"]
          }
        }
      }
    }

Cursor

Path A: OAuth

Open Cursor Settings

Open Cursor and click the settings icon in the top-right corner.

Go to Tools & MCP

In the left sidebar, select Tools & MCP.

Add a custom MCP server

Click Add Custom MCP. Cursor opens the MCP configuration file. Add https://mcp.octoparse.com and save.

See full setup guide

Path B: API KeyAdd to ~/.cursor/mcp.json:

    {
      "mcpServers": {
        "octoparse": {
          "type": "http",
          "url": "https://mcp.octoparse.com",
          "headers": {
            "x-api-key": "YOUR_API_KEY"
          }
        }
      }
    }

VS Code

Requires an active GitHub Copilot subscription.

Path A: OAuthAdd to .vscode/mcp.json:

    {
      "servers": {
        "octoparse": {
          "type": "http",
          "url": "https://mcp.octoparse.com"
        }
      }
    }

See full setup guide

Path B: API Key

    {
      "servers": {
        "octoparse": {
          "type": "http",
          "url": "https://mcp.octoparse.com",
          "headers": {
            "x-api-key": "YOUR_API_KEY"
          }
        }
      }
    }

Antigravity

The Antigravity IDE and Antigravity CLI share the same MCP configuration (~/.gemini/config/mcp_config.json). Set it up once and it works in both. In the IDE, you can also open it from the agent panel: MCP Servers → View raw config.

Path A: OAuthAdd to ~/.gemini/config/mcp_config.json:

    {
      "mcpServers": {
        "octoparse": {
          "serverUrl": "https://mcp.octoparse.com"
        }
      }
    }

Refresh the MCP server list. Your first Octoparse tool call opens a browser for OAuth — sign in and click Allow.

Path B: API Key

    {
      "mcpServers": {
        "octoparse": {
          "serverUrl": "https://mcp.octoparse.com",
          "headers": {
            "x-api-key": "YOUR_API_KEY"
          }
        }
      }
    }

GET STARTED

TOOL REFERENCE

Prerequisites

Scope & limitations

✅ Can do

❌ Cannot do

Quick start

Server URL

Authentication methods

Path A: OAuth 2.1

Path B: API key

Supported clients

​Prerequisites

​Scope & limitations

✅ Can do

❌ Cannot do

​Quick start

​Server URL

​Authentication methods

Path A: OAuth 2.1

Path B: API key

​Supported clients

Prerequisites

Scope & limitations

Quick start

Server URL

Authentication methods

Supported clients