Web Task

io.github.jojo-labs/web-task-api·v0.9.0·Browser Automation

Quality Score

/100

Browser tasks, sessions, and recipes for MCP and HTTP automation.

Repository →

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "web-task-api": {
      "command": "npx",
      "args": [
        "-y",
        "web-task-api"
      ],
      "env": {
        "WEB_TASK_API_DATA_DIR": "<web_task_api_data_dir>",
        "WEB_TASK_API_RECIPES_DIR": "<web_task_api_recipes_dir>",
        "WEB_TASK_API_TEMP_DIR": "<web_task_api_temp_dir>",
        "WEB_TASK_API_MODEL": "<web_task_api_model>",
        "WEB_TASK_API_VARIANT": "<web_task_api_variant>",
        "WEB_TASK_API_PI_URL": "<web_task_api_pi_url>",
        "WEB_TASK_API_PI_MODEL": "<web_task_api_pi_model>",
        "WEB_TASK_API_PI_VARIANT": "<web_task_api_pi_variant>",
        "CLIPROXY_BASE_URL": "<cliproxy_base_url>",
        "CLIPROXY_AUTH_TOKEN": "<your-cliproxy_auth_token>",
        "CLIPROXY_MODEL": "<cliproxy_model>",
        "OPENCODE_BASE_URL": "<opencode_base_url>",
        "OPENCODE_MODEL": "<opencode_model>",
        "BROWSER_USER_DATA_DIR": "<browser_user_data_dir>",
        "BROWSER_CHANNEL": "<browser_channel>",
        "HEADLESS": "<headless>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "web-task-api": {
      "command": "npx",
      "args": [
        "-y",
        "web-task-api"
      ],
      "env": {
        "WEB_TASK_API_DATA_DIR": "<web_task_api_data_dir>",
        "WEB_TASK_API_RECIPES_DIR": "<web_task_api_recipes_dir>",
        "WEB_TASK_API_TEMP_DIR": "<web_task_api_temp_dir>",
        "WEB_TASK_API_MODEL": "<web_task_api_model>",
        "WEB_TASK_API_VARIANT": "<web_task_api_variant>",
        "WEB_TASK_API_PI_URL": "<web_task_api_pi_url>",
        "WEB_TASK_API_PI_MODEL": "<web_task_api_pi_model>",
        "WEB_TASK_API_PI_VARIANT": "<web_task_api_pi_variant>",
        "CLIPROXY_BASE_URL": "<cliproxy_base_url>",
        "CLIPROXY_AUTH_TOKEN": "<your-cliproxy_auth_token>",
        "CLIPROXY_MODEL": "<cliproxy_model>",
        "OPENCODE_BASE_URL": "<opencode_base_url>",
        "OPENCODE_MODEL": "<opencode_model>",
        "BROWSER_USER_DATA_DIR": "<browser_user_data_dir>",
        "BROWSER_CHANNEL": "<browser_channel>",
        "HEADLESS": "<headless>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y web-task-api

§02 Environment variables

WEB_TASK_API_DATA_DIR

Optional mutable data root for web-task-api runs, sessions, profiles, and temp state. When omitted, the runtime uses a platform user-data directory instead of the ambient cwd.

WEB_TASK_API_RECIPES_DIR

Optional recipes directory override. When omitted, web-task-api reads bundled recipes from the installed package.

WEB_TASK_API_TEMP_DIR

Optional temp root override used when incoming temp env variables point at your home directory or working directory.

WEB_TASK_API_MODEL

Optional shared default planner model for catalog-backed PI and OpenCode selections. Defaults to openai/gpt-5.3-codex-spark.

WEB_TASK_API_VARIANT

Optional shared default planner thinking variant for catalog-backed PI and OpenCode selections. Defaults to high.

WEB_TASK_API_PI_URL

Optional PI engine base URL for the preferred planner backend. Defaults to http://127.0.0.1:8793.

WEB_TASK_API_PI_MODEL

Optional PI-specific planner model override. Defaults to WEB_TASK_API_MODEL when omitted.

WEB_TASK_API_PI_VARIANT

Optional PI-specific thinking variant override. Defaults to WEB_TASK_API_VARIANT when omitted.

CLIPROXY_BASE_URL

Optional CLIProxy base URL for the legacy fallback planner backend.

CLIPROXY_AUTH_TOKEN

secret

Optional CLIProxy auth token for the legacy fallback planner backend.

CLIPROXY_MODEL

Optional CLIProxy model alias for the legacy fallback planner backend.

OPENCODE_BASE_URL

Optional OpenCode base URL for the compatibility planner backend.

OPENCODE_MODEL

Optional OpenCode model name for the compatibility planner backend. Defaults to WEB_TASK_API_MODEL when omitted.

BROWSER_USER_DATA_DIR

Optional existing Chromium/Chrome user-data directory for warmed browser state reuse.

BROWSER_CHANNEL

Optional Playwright browser channel override, for example `chrome`.

HEADLESS

Optional browser headless toggle. Set `false` to prefer a visible browser.

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Browser Automation

ai.smithery/ImRonAI-mcp-server-browserbase

Automate cloud browsers to navigate websites, interact with elements, and extract structured data.…

ai.smithery/browserbasehq-mcp-browserbase

Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to i…

com.onkernel/kernel-mcp-server

Access Kernel's cloud-based browsers and app actions via MCP (remote HTTP + OAuth).