Atlas / MCP servers / octoparse / octoparse

octoparseSAFE

mcp/octoparse/octoparse-mcp

Official Octoparse MCP server for AI-powered web scraping workflows.

Verdict
SAFE
Grade
B
Trust score
89 /100
Exposed tools
14 13r · 1w · 0d
Transport
streamable-http
License
MIT
Stars
1
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

[](https://www.octoparse.com/) [](https://openapi.octoparse.com/octoparse-mcp-guide.html)

English | 日本語

Octoparse MCP Server connects MCP-compatible AI clients to Octoparse so users can discover scraping templates, create cloud tasks from Octoparse preset templates, manage existing tasks, and export structured data.

Hosted Server

Use the hosted Streamable HTTP endpoint:

https://mcp.octoparse.com

Configure this as an MCP server endpoint, not as a REST API tool.

Authentication

The hosted server officially supports both OAuth and API key authentication:

  • OAuth: the default option when the MCP client can open a browser authorization flow.
  • API key: an optional authentication method for clients that can send custom HTTP headers.

For API key mode, send the key in the x-api-key header. Do not place real keys in source control, issue reports, screenshots, or shared logs.

Quick Start

Generic HTTP MCP configuration:

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

Claude OAuth / default authentication:

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

Claude with API key:

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

Codex CLI:

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

Gemini CLI example configuration:

{
"mcpServers": {
"octoparse": {
"httpUrl": "https://mcp.octoparse.com",
"oauth": {
"clientId": "Octoparse",
"enabled": true
}
}
}
}

After adding the server, complete authorization in the browser if your client pro

Read from source at commit 365d21c26528OBSERVED · 2026-10-10
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add mcp-web-widget --env EXECUTION_TASK_CREDENTIAL_HANDLE_TTL_SECONDS=${EXECUTION_TASK_CREDENTIAL_HANDLE_TTL_SECONDS} --env REDIS_KEY_PREFIX=${REDIS_KEY_PREFIX} --env REDIS_PASSWORD=${REDIS_PASSWORD} -- npx -y @octoparse/[email protected]
claude-desktop
{
  "mcpServers": {
    "mcp-web-widget": {
      "command": "npx",
      "args": [
        "-y",
        "@octoparse/[email protected]"
      ],
      "env": {
        "EXECUTION_TASK_CREDENTIAL_HANDLE_TTL_SECONDS": "${EXECUTION_TASK_CREDENTIAL_HANDLE_TTL_SECONDS}",
        "REDIS_KEY_PREFIX": "${REDIS_KEY_PREFIX}",
        "REDIS_PASSWORD": "${REDIS_PASSWORD}"
      }
    }
  }
}
03

Exposed tools (14)

13 read · 1 write · 0 destructive.

ToolRiskDescription
auth_task_toolreadRequires auth
demo_logging_toolreadReturns a demo payload
direct_logging_failure_toolreadFails through the direct execution path
execute_taskwriteExecutes task
export_datareadLogs through request context
failing_logging_toolreadThrows a demo error
no_sink_toolreadExecutes without explicit logging configuration
result_task_toolreadReturns result through task wrapper
search_templatesreadSearches templates
standard_toolreadRegular registration path
status_task_toolreadReads task status through wrapper
task_toolreadTask registration path
validated_task_toolreadUses SDK task input validation
widget_toolreadReturns a widget result
04

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codePASS
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (4 observation(s))
Network
declared (2 observation(s))
Shell
none-observed
Dependencies
not all pinned
Secrets in source
none-found

Findings (11)

LOWInsecure crypto · crypto.weak_hash · CWE-327, CWE-338
src/middleware/request-logger.ts:15
return createHash('sha1').update(fullKey, 'utf8').digest('hex');
LOWInsecure crypto · crypto.weak_hash · CWE-327, CWE-338
src/utils/api-key-utils.ts:11
return createHash('sha1').update(apiKey, 'utf8').digest('hex');
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/api/clients/http-client-factory.ts:4
import { AppConfig } from '../../config/app-config.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/api/clients/http-client-factory.ts:5
import { Logger } from '../../utils/logger.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/widget-adapter/presenters/search-tasks.presenter.ts:2
import messages from '../../config/messages.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/widget-adapter/presenters/search-templates.presenter.ts:2
import messages from '../../config/messages.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
tests/integration/export-data-workflow.test.mjs:7
const { exportDataTool } = await import('../../dist/tools/export-data-tool.js');
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@types/cors, @types/express, axios, cors, csv-writer, dotenv, exceljs, express
Why it matters. 24 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
web/package.json
react, react-dom, @types/react, @types/react-dom, @vitejs/plugin-react, typescript, vite
Why it matters. 7 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
docs/Troubleshooting.md:78
Reconnect the MCP server in your client. If the client supports session recovery, it still needs to send fresh credentials with the new request.
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
INFOPrompt injection · prompt.credential_read · CWE-94, CWE-1427
SECURITY.md:5
Please do not open public issues for vulnerabilities or credential exposure. Contact Octoparse support through the Help Center or the published support channel, and include a concise, sanitized descri
Why it matters. asks the agent to read credentials

Gates applied: no_behavioural_pass.

Audited 2026-10-10 · audit v0.4.1 · source sha 365d21c26528full audit observations/trust-audit/mcp-server/octoparse__octoparse-mcp.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-10365d21c26528SAFEB89first audit
06

Questions

What is the octoparse MCP server?

Official Octoparse MCP server for AI-powered web scraping workflows.

What tools does octoparse expose?

14 in total: 13 read-only, 1 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is octoparse safe to connect to an agent?

The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.

What credentials does octoparse need?

It reads EXECUTION_TASK_CREDENTIAL_HANDLE_TTL_SECONDS, REDIS_KEY_PREFIX and REDIS_PASSWORD from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does octoparse run?

It speaks streamable-http, so it runs as a service you connect to over the network. It is published on npm as @octoparse/mcp-web-widget at 0.1.0.

How current is this page?

The grade is for one exact copy of the source (365d21c26528), read on 2026-10-10. The repository is watched and re-audited when it changes.

Advertisement