Skip to main content

How to Integrate Octoparse with Cursor via MCP (Step-by-Step)

Cursor supports MCP, so you can connect Octoparse and use natural language to search templates, run supported tasks, and export scraped data.

Updated today

Before You Begin

Please review the following before getting started:

  • ✅ Cursor supports MCP servers, which let the AI assistant use external tools inside the editor.

  • ✅ You need access to Cursor on desktop.

  • ✅ You need an Octoparse account.

  • ✅ You need the Octoparse MCP server URL and any required authentication details before setup.

  • ✅ Depending on your setup, you may need to authorize Octoparse access in a browser during the connection process.

What This Integration Enables

Once Octoparse is connected to Cursor, you can manage scraping workflows in natural language, including:

  • Search Octoparse scraping templates

  • Create scraping tasks from templates

  • Start and stop cloud tasks

  • Check task execution status

  • Export data in CSV or JSON

  • View Octoparse account information


Octoparse MCP Server Information

Octoparse provides an MCP server that Claude can connect to through Claude’s custom connector framework.

Server URL

https://mcp.octoparse.com

This server securely exposes Octoparse capabilities—such as templates, tasks, and exports—to Claude through the MCP standard.


Step-by-step configuration

Follow these steps to connect Octoparse with Cursor.

Step 1: Open Cursor Settings

  1. Open Cursor on your computer.

  2. Click the Cursor Settings icon in the top-right corner of the app.

  3. Then navigate to the MCP section, where you can manage MCP servers and tool connections.

Step 2: Go to Tools & MCP

In the left sidebar of Cursor Settings, click Tools & MCP.

This is where Cursor lets you manage installed MCP servers.

Step 3: Add a Custom MCP Server

Under Installed MCP Servers, click Add Custom MCP.

Cursor will open the MCP configuration file.

Step 4: Add the Octoparse MCP Server URL

In the mcp.json file, add the Octoparse MCP server configuration like this:

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

Make sure the format is valid JSON, then save the file.

Step 5: Return to Tools & MCP

Go back to Cursor Settings > Tools & MCP.

After saving the configuration, Cursor will detect the Octoparse MCP server automatically.

At first, the server may show the status Needs authentication.

Step 6: Connect the Server

Click Connect next to octoparse.

Cursor will begin the authentication flow for the Octoparse MCP server.

Step 7: Authorize Access

A browser window or permission screen will open.

Review the requested permissions, then click Yes, Allow to authorize Cursor to access Octoparse through MCP.

You can also keep Remember My Decision checked if you do not want to approve this again next time.

Step 8: Finish Setup

Once authorization is complete, return to Cursor.

The Octoparse MCP server should now be connected and available for use inside Cursor.


Authentication

When you connect Octoparse in Cursor for the first time:

  • Cursor detects the MCP server from mcp.json

  • The server appears in Tools & MCP

  • Cursor shows Needs authentication

  • You click Connect

  • Cursor opens the permission screen

  • You approve access

  • The Octoparse server becomes available in Cursor


Example Cursor Prompts (After Integration)

Template & Task Creation

Find a template for scraping Amazon product listings. Create a task using that template and start it in the cloud.

Monitoring & Export

Check the status of my latest Octoparse cloud task and export the results as CSV.

Data Retrieval

Show me all available export options for this Octoparse task and download the latest dataset in JSON format.

Did this answer your question?