Stagehand
Web automation and data extraction
Integrate Stagehand into the workflow. Can extract structured data from webpages or run an autonomous agent to perform tasks.
| Parameter | Type | Required | Description |
|---|
url | string | Yes | No description |
instruction | string | Yes | No description |
provider | string | No | No description |
apiKey | string | Yes | No description |
schema | json | Yes | No description |
| Parameter | Type | Description |
|---|
data | object | Extracted structured data matching the provided schema |
| Parameter | Type | Required | Description |
|---|
startUrl | string | Yes | No description |
task | string | Yes | No description |
variables | json | No | Optional variables to substitute in the task (format: {key: value}). Reference in task using %key% |
provider | string | No | No description |
apiKey | string | Yes | No description |
outputSchema | json | No | No description |
| Parameter | Type | Description |
|---|
agentResult | object | Result from the Stagehand agent execution |
↳ success | boolean | Whether the agent task completed successfully without errors |
↳ completed | boolean | Whether the agent finished executing (may be false if max steps reached) |
↳ message | string | Final status message or result summary from the agent |
↳ actions | array | List of all actions performed by the agent during task execution |
↳ type | string | Type of action performed (e.g., "act", "observe", "ariaTree", "close", "wait", "navigate") |
↳ reasoning | string | AI reasoning for why this action was taken |
↳ taskCompleted | boolean | Whether the task was completed after this action |
↳ action | string | Description of the action taken (e.g., "click the submit button") |
↳ instruction | string | Instruction that triggered this action |
↳ pageUrl | string | URL of the page when this action was performed |
↳ pageText | string | Page text content (for ariaTree actions) |
↳ timestamp | number | Unix timestamp when the action was performed |
↳ timeMs | number | Time in milliseconds (for wait actions) |
structuredOutput | object | Extracted data matching the provided output schema |
