Web Task

Name: Web Task
Author: jojo-labs

本地服务

github.com/jojo-labs浏览器自动化

代码仓库

关于 Web Task

面向 MCP 和 HTTP 自动化的浏览器任务、会话和配方

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "jojo-labs-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": "<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>"
      }
    }
  }
}

启动命令npx -y web-task-api

需要配置的环境变量

WEB_TASK_API_DATA_DIROptional 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_DIROptional recipes directory override. When omitted, web-task-api reads bundled recipes from the installed package.

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

WEB_TASK_API_MODELOptional shared default planner model for catalog-backed PI and OpenCode selections. Defaults to deepseek/deepseek-v4-flash.

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

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

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

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

CLIPROXY_BASE_URLOptional CLIProxy base URL for the legacy fallback planner backend.

CLIPROXY_AUTH_TOKEN密钥Optional CLIProxy auth token for the legacy fallback planner backend.

CLIPROXY_MODELOptional CLIProxy model alias for the legacy fallback planner backend.

OPENCODE_BASE_URLOptional OpenCode base URL for the compatibility planner backend.

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

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

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

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

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmweb-task-api0.10.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
goal	string	是	浏览器任务此刻应完成的目标。
mode	enum	否	任务模式：read 用于提取或研究，act 用于交互式更改。read \| act
input	object	否	配方或规划器可引用的结构化任务输入。
profile	string	否	可选的命名浏览器配置文件，用于已通过身份验证或已预热的浏览器状态。
headless	boolean	否	是否优先为本次运行启用无头浏览器模式。
max_steps	integer	否	运行停止前允许的最大浏览器步骤数。
recipe_id	string	否	当你想使用已知流程而非完全自由形式的运行时，可选的入门配方 ID。
start_url	string	否	已知任务起始位置时的可选起始 URL。
agent_kind	enum	否	本次运行使用的规划器后端。auto \| pi \| cliproxy \| opencode \| mock
session_id	string	否	当任务需要继续之前的浏览器状态或上下文时，可选的要复用的已保存会话。
timeout_ms	integer	否	整个运行的超时时间，单位为毫秒。
agent_model	string	否	本次运行可选的规划器模型覆盖项。设置后，Auto、PI 和 OpenCode 使用基于目录的选择。默认值为 deepseek/deepseek-v4-flash。
agent_variant	string	否	本次运行可选的规划器思考变体覆盖项。对于基于目录的规划器，默认值为 high。
output_schema	object	否	用于验证最终结构化结果的可选类 JSON Schema 对象。