Stagehand runs browser automation using Browserbase and an LLM. Use Extract to retrieve page data matching a schema. Use Agent for a task that requires multiple browser interactions, such as navigating and filling out a form. Configure the Browserbase and model credentials required by the selected operation.

Use the block

Extract structured data from webpages or run an autonomous agent to perform tasks.

Actions

Stagehand Extract

Extract structured data from a webpage using Stagehand

Input

Output

Stagehand Agent

Run an autonomous web agent to complete tasks and extract structured data

Inputs and outputs

Input

Parameter	Type	Required	Description
startUrl	string	Yes	URL of the webpage to start the agent on
task	string	Yes	The task to complete or goal to achieve on the website
variables	json	No	Optional variables to substitute in the task (format: {key: value}). Reference in task using %key%
provider	string	No	AI provider to use: openai or anthropic
apiKey	string	Yes	API key for the selected provider
outputSchema	json	No	Optional JSON schema defining the structure of data the agent should return
mode	string	No	Agent tool mode: dom (default), hybrid, or cua
maxSteps	number	No	Maximum agent steps (default 20, max 200)

Output

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
liveViewUrl	string	Embeddable Browserbase live view URL (active only while the session is running)
sessionId	string	Browserbase session identifier