</picture>
</a>

<a href="https://docs.stagehand.dev">Read the Docs</a>

</picture>

</picture>

Stagehand Go SDK

What is Stagehand?

Stagehand is the SDK for browser agents. Playwright was built for testing, Stagehand is built for agents. Use familiar APIs, self-healing actions, and network-level security across TypeScript, Python, and Go.

Why Stagehand?

Stagehand gives browser agents an interface built for how they actually work. It combines familiar Playwright-style APIs with self-healing actions, agent-optimized page context, and native support for complex DOM structures like out-of-process iframes and closed Shadow DOMs.

Agents use fewer tokens, recover when websites change, and complete tasks more reliably. With a complete browser driver across TypeScript, Python, and Go, Stagehand delivers the flexibility of AI without sacrificing the speed, control, determinism, reliability, and observability required in production.

For the full overview, examples, and contributing guide, see the main README.

Navigation

Navigation methods return the main-document response when the browser performs a network request:

response, err := page.Goto(ctx, "https://example.com", nil)
if err != nil {
	return err
}
if response != nil {
	body, err := response.Body(ctx)
	if err != nil {
		return err
	}
	fmt.Println(response.Status(), string(body))
}

Reload, GoBack, and GoForward use the same (*Response, error) pattern. A successful navigation without a main-document network response returns (nil, nil). Response bodies and complete headers are retrieved lazily while the Stagehand session remains open.

Extraction

Define the output as a Go type and call the package-level generic function. Stagehand derives the JSON Schema from the type and returns decoded data with the usual result metadata:

type story struct {
	Title  string `json:"title"`
	Points int    `json:"points"`
}

type stories struct {
	Stories []story `json:"stories"`
}

result, err := stagehand.Extract[stories](ctx, sh, "Extract the top 5 stories", nil)
if err != nil {
	return err
}
fmt.Println(result.Data.Stories)

Fields omitted with json:",omitempty" are optional in the generated schema. Add constraints such as jsonschema:"format=uri" or jsonschema:"description=the displayed price" when the Go type alone is not specific enough.

Examples

Run the flat examples directly from the repository:

go -C packages/sdk-go run examples/act.go
go -C packages/sdk-go run examples/extract.go