io.github.jojo-labs/web-task-api
OfficialWeb Task
Browser tasks, sessions, and recipes for MCP and HTTP automation.
Browser automation server for tasks, sessions, and recipes via MCP and HTTP.
README not available yet.
Install
Configuration
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_TOKENsecretOptional 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.
claude_desktop_config.json
{
"mcpServers": {
"web-task-api": {
"command": "npx",
"args": [
"-y",
"web-task-api@0.10.1"
],
"env": {
"WEB_TASK_API_DATA_DIR": "<YOUR_WEB_TASK_API_DATA_DIR>",
"WEB_TASK_API_RECIPES_DIR": "<YOUR_WEB_TASK_API_RECIPES_DIR>",
"WEB_TASK_API_TEMP_DIR": "<YOUR_WEB_TASK_API_TEMP_DIR>",
"WEB_TASK_API_MODEL": "<YOUR_WEB_TASK_API_MODEL>",
"WEB_TASK_API_VARIANT": "<YOUR_WEB_TASK_API_VARIANT>",
"WEB_TASK_API_PI_URL": "<YOUR_WEB_TASK_API_PI_URL>",
"WEB_TASK_API_PI_MODEL": "<YOUR_WEB_TASK_API_PI_MODEL>",
"WEB_TASK_API_PI_VARIANT": "<YOUR_WEB_TASK_API_PI_VARIANT>",
"CLIPROXY_BASE_URL": "<YOUR_CLIPROXY_BASE_URL>",
"CLIPROXY_AUTH_TOKEN": "<YOUR_CLIPROXY_AUTH_TOKEN>",
"CLIPROXY_MODEL": "<YOUR_CLIPROXY_MODEL>",
"OPENCODE_BASE_URL": "<YOUR_OPENCODE_BASE_URL>",
"OPENCODE_MODEL": "<YOUR_OPENCODE_MODEL>",
"BROWSER_USER_DATA_DIR": "<YOUR_BROWSER_USER_DATA_DIR>",
"BROWSER_CHANNEL": "<YOUR_BROWSER_CHANNEL>",
"HEADLESS": "<YOUR_HEADLESS>"
}
}
}
}