Browserbase Stagehand

Convex component enabling AI-powered browser automation with Stagehand for web scraping, testing, and UI interactions in serverless functions.

Installation

npm install @browserbasehq/convex-stagehand

About Browserbase Stagehand

AI-powered browser automation for Convex applications. Extract data, perform actions, and automate workflows using natural language - no Playwright knowledge required.

Features
Simple API - Describe what you want in plain English
Type-safe - Full TypeScript support with Zod schemas
Session management - Reuse browser sessions across multiple operations
Agent mode - Autonomous multi-step task execution
Powered by Stagehand - Uses the Stagehand REST API

Benefits

Automate complex browser workflows using natural language instructions in Convex functions
Run headless browser automation at scale without managing infrastructure or browser instances
Extract data from dynamic websites and SPAs that require JavaScript execution
Integrate browser automation directly into your Convex backend with type-safe APIs

Use cases

how to scrape dynamic websites in Convex functions

The convex-stagehand component allows you to scrape JavaScript-heavy websites directly from Convex functions using AI-powered browser automation. It handles dynamic content loading, user interactions, and data extraction through natural language instructions.

automated testing for web applications with Convex

You can use convex-stagehand to run end-to-end tests by automating user interactions like clicking buttons, filling forms, and navigating pages. The component provides AI-driven element selection and interaction capabilities within your Convex testing functions.

browser automation in serverless functions

The convex-stagehand component enables browser automation in Convex's serverless environment without managing browser infrastructure. It provides headless Chrome capabilities with Stagehand's AI-powered element detection and interaction APIs.

Frequently asked questions

What makes convex-stagehand different from other browser automation libraries?

The convex-stagehand component integrates Stagehand's AI-powered browser automation directly into Convex functions, eliminating the need to manage browser infrastructure. It uses natural language instructions for element selection and interactions, making automation scripts more maintainable than traditional CSS selector-based approaches.

Can I use convex-stagehand for production web scraping?

Yes, convex-stagehand is designed for production use within Convex's serverless environment. It handles browser lifecycle management and provides reliable automation capabilities for data extraction from dynamic websites that require JavaScript execution.

Does convex-stagehand work with single-page applications?

The convex-stagehand component fully supports SPAs by executing JavaScript and waiting for dynamic content to load. It can handle client-side routing, AJAX requests, and interactive elements that traditional scraping tools cannot process.

How do I handle authentication flows with convex-stagehand?

The convex-stagehand component can automate login flows by interacting with forms, handling redirects, and managing session cookies. It supports complex authentication scenarios including multi-factor authentication and OAuth flows through its AI-powered interaction capabilities.