Stagehand can be integrated into Langchain JS by wrapping Stagehand’s browser automation functionality with the StagehandToolkit.

This toolkit provides specialized tools such as navigate, act, extract, and observe, all powered by Stagehand’s underlying capabilities.

For more details on this integration and how to work with Langchain, see the official Langchain documentation.

Below is a high-level overview to get started:

​
Installation

Install the necessary packages:

npm install @langchain/langgraph @langchain/community @langchain/core @browserbasehq/stagehand

​
Create a Stagehand instance

const stagehand = new Stagehand({
env: "LOCAL",
headless: false,
verbose: 2,
debugDom: true,
enableCaching: false,
});

​
Generate a Stagehand Toolkit object

const stagehandToolkit = await StagehandToolkit.fromStagehand(stagehand);

​
Use the tools

  • stagehand_navigate: Navigate to a specific URL.
  • stagehand_act: Perform browser automation tasks like clicking buttons and typing in fields.
  • stagehand_extract: Extract structured data from pages using Zod schemas.
  • stagehand_observe: Investigate the DOM for possible actions or relevant elements.

Example standalone usage:

// Find the relevant tool
const navigateTool = stagehandToolkit.tools.find(
(t) => t.name === "stagehand_navigate");

// Invoke it
await navigateTool.invoke("https://www.google.com");

// Suppose you want to act on the page
const actionTool = stagehandToolkit.tools.find(
(t) => t.name === "stagehand_act");

await actionTool.invoke('Search for "OpenAI"');

// Observe the current page
const observeTool = stagehandToolkit.tools.find(
(t) => t.name === "stagehand_observe");

const result = await observeTool.invoke(
"What actions can be performed on the current page?");

console.log(JSON.parse(result));

// Verification
const currentUrl = stagehand.page.url();
// e.g., ensure it contains "google.com/search"

​
Remote Browsers (Browserbase)

Instead of env: “LOCAL”, specify env: “BROWSERBASE” and pass in your Browserbase credentials through environment variables: BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID

​
Using LangGraph Agents

The StagehandToolkit can also be plugged into LangGraph’s existing agent system. This lets you orchestrate more complex flows by combining Stagehand’s tools with other Langchain tools.

With the StagehandToolkit, you can quickly integrate natural-language-driven browser automation into workflows supported by Langchain. This enables use cases such as:

  • Searching, extracting, and summarizing data from websites
  • Automating login flows
  • Navigating or clicking through forms based on instructions from a larger chain of agents

Consult Stagehand’s and Langchain’s official references for troubleshooting and advanced integrations or reach out to us on Slack.

MCP Server