工具 API

execute_task

Start an Octoparse cloud task from `templateName` + `parameters` (JSON object string keyed by `inputSchema[].field`). Preflight runs automatically and returns actionable input errors without creating a task when input is incomplete. Prefer a unique `taskName` for recovery via `search_tasks`. The call waits up to 45 seconds and returns the Octoparse task id (`taskId`), `lotNo`, `collectedRows`, and status `running`, `completed`, or `stopped`. collectedRows defaults to 0; use status to distinguish a running task with no rows yet from a terminal task with no rows. If a failure result includes `taskId`, call `get_task_status(taskId)`; do not call `execute_task` again. A `progressToken` adds progress notifications. Input/Dropdown=string; MultiInput/CheckboxList=string[].

devOAuth1 积分

调用信息

工具标识: bazhuayu.execute_task
服务提供方: 八爪鱼云采集
平均响应: 0 ms
近 7 天调用: 0

输入参数

templateName必填

Template name from search_templates. Prefer exact `template.templateName` or a high-`score` `templates[].templateName` from semantic results.

taskName

Optional unique friendly task name. Strongly recommended for long-running jobs because the same run can be recovered with search_tasks(keyword=taskName) if the client times out before you capture the returned Octoparse taskId.

parameters

Business parameters as a JSON object string. Use `inputSchema[].field` as keys. For source-backed fields, read root options from exact `search_templates` `sourceTree` and pass selected option `key` values. If a dependent selection is still required, execute_task returns input_required with the next sourceOptions; add that selection and call execute_task again. Input/Dropdown = string; MultiInput = string[]; CheckboxList = string[] even for one value. Example: "{"site":"United States","confirm_your_site":["https://www.amazon.com/"],"keywords":["wireless earbuds"],"number_of_pages_to_scrape":"1"}"