Skip to content

stagehandvsplaywright

MIT 183 14 22,012
2.8 million (month) Oct 29 2024 3.2.1(2026-04-10 21:10:37 ago)
14,506 5 82 Apache-2.0
Feb 24 2021 53.2 million (month) 1.58.0(2026-01-30 15:09:24 ago)

Stagehand is an AI-powered browser automation framework for JavaScript and TypeScript, built by Browserbase. It provides a simple API for controlling browsers using natural language instructions, powered by large language models.

Stagehand offers three core primitives:

  • act() Performs actions on the page described in natural language. For example, page.act("click the login button") will find and click the appropriate element.
  • extract() Extracts structured data from the page based on a natural language description and an optional schema definition.
  • observe() Analyzes the current page state and returns actionable elements and their descriptions, useful for understanding what actions are available on a page.

Key features include:

  • TypeScript-first Built with full TypeScript support and type-safe extraction using Zod schemas.
  • Multiple LLM providers Works with OpenAI, Anthropic, and other LLM providers for powering the AI.
  • Vision and DOM analysis Combines visual screenshot analysis with DOM inspection for robust element identification.
  • Playwright integration Uses Playwright as the browser automation backend, giving access to the full Playwright API alongside AI-powered actions.
  • Browserbase cloud Optionally integrates with Browserbase cloud for managed browser infrastructure.

Stagehand is particularly suited for automating complex web workflows where traditional selectors would be fragile, such as interacting with frequently changing UIs or scraping sites with dynamic layouts.

playwright is a Python package that allows developers to automate web browsers for end-to-end testing, web scraping, and web performance analysis. It is built on top of WebKit, Mozilla's Gecko, and Microsoft's EdgeHTML, and it is designed to be fast, reliable, and easy to use.

playwright is similar to Selenium, but it provides a more modern and powerful API, with features such as automatic waiting for elements, automatic retries, and built-in support for browser contexts, which allow you to open multiple pages in a single browser instance.

Playwright also provides an asynchronous client which makes scaling playwright-powered web scrapers easier than alternatives (like Selenium)

Highlights


ai-powerednatural-languagetypescript

Example Use


```javascript import { Stagehand } from '@browserbasehq/stagehand'; import { z } from 'zod'; const stagehand = new Stagehand({ env: 'LOCAL', // or 'BROWSERBASE' for cloud browsers modelName: 'gpt-4o', }); await stagehand.init(); const page = stagehand.page; // Navigate to a page await page.goto('https://news.ycombinator.com'); // Use natural language to interact await page.act('click on the "new" link in the navigation'); // Extract structured data with a schema const stories = await page.extract({ instruction: 'Extract the top 5 story titles and their point counts', schema: z.object({ stories: z.array(z.object({ title: z.string(), points: z.number(), })), }), }); console.log(stories); // Observe available actions on the page const actions = await page.observe('What actions can I take on this page?'); console.log(actions); await stagehand.close(); ```
```python from playwright import sync_playwright # Start Playwright with sync_playwright() as playwright: # Launch a browser instance browser = playwright.chromium.launch() # Open a new context (tab) context = browser.new_context() # Create a new page in the context page = context.new_page() # Navigate to a website page.goto("https://www.example.com") # Find an element by its id element = page.get_by_id("example-id") # Interact with the element element.click() # Fill an input form page.get_by_name("example-name").fill("example text") # Find and click a button page.get_by_xpath("//button[text()='Search']").click() # Wait for the page to load page.wait_for_selector("#results") # Get the page title print(page.title) # Close the browser browser.close() ```

Alternatives / Similar


Was this page helpful?