Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
87ed25b
Bump h11 in /examples/integrations/crewai/crewai-tutorial (#3)
dependabot[bot] May 27, 2025
394103b
Initial commit (#4)
ajmcquilkin May 27, 2025
95dacdf
added braintrust and agentkit readmes (#1)
Kylejeong2 Jun 1, 2025
c9f11c0
add mongodb integration (#2)
Kylejeong2 Jun 1, 2025
f433080
added langchain and crew ai stagehand integrations (#5)
Kylejeong2 Jun 1, 2025
b10516b
[Integration]: add agno to integrations (#6)
Kylejeong2 Jun 1, 2025
a22ccc6
adding mastra integration + docs (#10)
Kylejeong2 Jun 3, 2025
c697290
portia integration (#8)
Kylejeong2 Jun 3, 2025
d94cfd0
[Fix]: Fix CVEs (#9)
Kylejeong2 Jun 7, 2025
49e7435
Initial commit (#13)
ajmcquilkin Jun 9, 2025
0abe572
add node and python readmes for stripe (#14)
Kylejeong2 Jun 17, 2025
bfacbf1
trigger.dev integration (#15)
Kylejeong2 Jun 18, 2025
7a1c13b
[Fix]: Fix Next and Python CVEs (#17)
Kylejeong2 Jun 20, 2025
94b2b3e
browser-use deps + env example (#18)
Kylejeong2 Jul 9, 2025
c6bbf5b
fix stagehand crew ai example code + add requirements file (#19)
Kylejeong2 Jul 10, 2025
efc0215
[Integration]: Temporal x Stagehand (#11)
Kylejeong2 Jul 20, 2025
02a6a3a
working with the latest version of browser-use (#21)
Kylejeong2 Jul 21, 2025
8a1ee8f
[GRO-257] flags for advanced stealth and proxies, set default model (…
Kylejeong2 Aug 15, 2025
182c187
chore(deps):(deps-dev): bump globals from 15.15.0 to 16.3.0 (#30)
dependabot[bot] Sep 4, 2025
b2d2145
chore(deps):(deps-dev): bump @types/node from 22.18.1 to 24.3.1 (#31)
dependabot[bot] Sep 4, 2025
c65d1d5
chore: Add Claude Code GitHub Workflow (#32)
Kylejeong2 Sep 5, 2025
1d52b33
chore(deps):(deps-dev): bump eslint-config-prettier from 9.1.2 to 10.…
dependabot[bot] Sep 5, 2025
3fd45e5
[GRO-227]: add python version of integration to mongodb (#22)
Kylejeong2 Sep 7, 2025
f195788
fix: update mastra integration tools and versioning (#36)
Kylejeong2 Oct 16, 2025
520ef62
chore(deps):(deps-dev): bump vitest from 2.1.9 to 4.0.6 (#38)
dependabot[bot] Nov 3, 2025
176acc0
[integration]: first version of cartesia line form fill integration (…
Kylejeong2 Nov 8, 2025
dec034f
chore(deps):(deps-dev): bump @types/node from 24.10.9 to 25.0.9 (#43)
dependabot[bot] Jan 23, 2026
656531a
[Integration]: adding n8n Node (#12)
Kylejeong2 Jan 28, 2026
2019236
chore(deps):(deps-dev): bump typescript from 5.9.3 to 6.0.2 (#55)
dependabot[bot] Mar 24, 2026
d3fa71b
chore(deps):(deps-dev): bump eslint from 9.39.4 to 10.1.0 (#54)
dependabot[bot] Mar 24, 2026
7aeb8f5
chore: adding n8n node repo as a submodule (#56)
Kylejeong2 Apr 2, 2026
5d16f40
feat(vercel-puppeteer): migrate form API to Stagehand v3 (#65)
Kylejeong2 Apr 2, 2026
220e632
feat(mastra): align Stagehand tools with v3 API (#60)
Kylejeong2 Apr 2, 2026
bed9df0
chore: remove portia integration example (#57)
Kylejeong2 Apr 2, 2026
4893d85
fix(trigger): await async react-email render in HN summary (#64)
Kylejeong2 Apr 2, 2026
78cb2bf
feat(mongodb): migrate TypeScript scraper to Stagehand v3 (#62)
Kylejeong2 Apr 2, 2026
2a6053c
feat(browse-gpt): upgrade BrowseGPT to AI SDK 6 (#63)
Kylejeong2 Apr 2, 2026
c46d9ba
feat(stripe): migrate Stagehand payment example to v3 (#61)
Kylejeong2 Apr 2, 2026
8bfc198
feat(browser-use): simplify Agent and Browser session wiring (#59)
Kylejeong2 Apr 2, 2026
035e48e
feat(agentkit): migrate Stagehand example to v3 API (#58)
Kylejeong2 Apr 2, 2026
ee62be3
chore: remove claude code review, add PR template and codeowners (#66)
Kylejeong2 Apr 2, 2026
f69b4d4
chore(readme): update readme to reflect latest version of the integra…
Kylejeong2 Apr 5, 2026
1a8089d
chore(deps):(deps-dev): bump globals from 16.5.0 to 17.5.0 (#68)
dependabot[bot] Apr 18, 2026
36208f5
feat: Add LangChain Deep Agents Browserbase example (#70)
Kylejeong2 Apr 30, 2026
646d1ce
feat(examples): add 2 LangChain Deep Agents cookbooks
charlypoly May 14, 2026
d18a06a
feat(langchain): remove md file
charlypoly May 27, 2026
8014ec9
feat(langchain): remove md file
charlypoly May 27, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
* @browserbase/gtm
14 changes: 14 additions & 0 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
## Summary

<!-- Provide a brief description of what this PR does and why -->

## Type of Change

<!-- Mark relevant option with an "x" -->

- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] Documentation update
- [ ] Performance improvement
- [ ] Refactoring (no functional changes)
11 changes: 11 additions & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
version: 2
updates:
# Enable version updates for npm
- package-ecosystem: "npm"
directory: "/"
schedule:
interval: "weekly"
open-pull-requests-limit: 5
commit-message:
prefix: "chore(deps):"
include: "scope"
20 changes: 19 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -123,4 +123,22 @@ temp/

# Test artifacts
test-results/
playwright-report/
playwright-report/

# Claude Code
.claude/

# venv
venv/
.venv/

# Python
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
*.egg-info/
.pytest_cache/
.mypy_cache/
.ruff_cache/
126 changes: 41 additions & 85 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,121 +1,77 @@
# Browserbase Integrations

**A comprehensive monorepo of production-ready integrations for Browserbase - the headless browser infrastructure for AI agents and web automation.**
**Production-ready integrations for Browserbase -- the complete platform to build and deploy agents that browse and interact with the web like humans.**

Browserbase provides scalable, reliable browser infrastructure that powers the next generation of AI applications. This repository contains officially maintained integrations with popular frameworks, libraries, and platforms to help you build powerful web automation and AI agent solutions.
Browserbase provides the infrastructure and developer primitives to power the next generation of browser agents. This repository contains officially maintained integrations with popular frameworks, libraries, and platforms.

## 🚀 What is Browserbase?
## What is Browserbase?

Browserbase is headless browser infrastructure designed specifically for AI agents and web automation at scale. It provides:
Browserbase is the browser agent platform -- one API key, everything your agent needs to browse the web:

- **Browser sessions** that scale automatically
- **Anti-detection capabilities** to bypass bot protection
- **Visual debugging** with session recordings and screenshots
- **Global infrastructure** for low-latency access worldwide
- **Stealth technology** to ensure reliable web interaction
- **Headless Browsers**: programmatic access to fleets of headless browsers at scale with globally distributed infrastructure, isolated sessions, and rich observability
- **Fetch and Search APIs**: agents can quickly search and fetch LLM context from the web for fast, token-efficient decisions
- **Agent Identity**: enable agents to access any website through strategic partnerships and a dedicated research team
- **Functions**: deploy and run agents on Browserbase for faster, more secure execution
- **Model Gateway**: access major models via Stagehand with unified billing under your Browserbase API key
- **Stagehand**: the AI SDK for browser agents -- replaces rigid selectors with natural language browser interactions that self-heal when pages change

## 📦 Available Integrations

Our integrations are organized by platform and use case, each with comprehensive documentation and examples:

### 🤖 AI Agent Frameworks

#### [**CrewAI Integration**](./examples/integrations/crewai/README.md)
Enable your CrewAI agents to browse the web like humans with the `BrowserbaseLoadTool`. Perfect for creating intelligent agent crews that need to gather real-time web data, extract content from complex pages, and interact with modern web applications.

**Key Features:**
- Extract text from JavaScript-heavy websites
- Capture screenshots and visual content
- Bypass anti-bot mechanisms
- Seamless integration with CrewAI's tool ecosystem

#### [**AgentKit Integration**](./examples/integrations/agentkit/)
Powerful integrations for AgentKit workflows with both Browserbase and Stagehand implementations:

- **[Browserbase Implementation](./examples/integrations/agentkit/browserbase/README.md)** - Direct Browserbase integration for AgentKit
- **[Stagehand Implementation](./examples/integrations/agentkit/stagehand/README.md)** - AI-powered web automation using Stagehand

#### [**LangChain Integration**](./examples/integrations/langchain/README.md)
Integrate Browserbase with LangChain's ecosystem for advanced AI applications. Build chains that can browse, extract, and interact with web content as part of larger AI workflows.

#### [**Browser-Use Integration**](./examples/integrations/browser-use/README.md)
Streamlined browser automation for AI applications with a focus on simplicity and reliability.

### 🏗️ Development & Deployment Platforms

#### [**Vercel AI Integration**](./examples/integrations/vercel/README.md)
Enhance your Vercel applications with web-browsing capabilities. Build Generative User Interfaces that can access real-time web data and create dynamic, AI-powered experiences.

**Examples Include:**
- **BrowseGPT** - A chat interface with real-time web search capabilities
- **Vercel + Puppeteer** - Server-side browser automation on Fluid Compute

### 💳 E-commerce & Payments

#### [**Stripe Integration**](./examples/integrations/stripe/README.md)
**Agentic Credit Card Automation** - Create virtual cards with Stripe Issuing and automate online purchases with Browserbase. Perfect for programmatic commerce, testing payment flows, and building AI shopping agents.

**Capabilities:**
- Create virtual cards with spending controls
- Automate secure online purchases
- Available in Node.js, Python, and Stagehand implementations
- Production-ready with comprehensive examples

### 📊 Evaluation & Testing

#### [**Braintrust Integration**](./examples/integrations/braintrust/)
Integrate Browserbase with Braintrust for evaluation and testing of AI agent performance in web environments. Monitor, measure, and improve your browser automation workflows.

## 🏗️ Monorepo Structure
## Monorepo Structure

```
integrations/
├── examples/
| |
│ └── community/ # WIP
│ ├── community/ # Community-contributed examples
│ └── integrations/
│ ├── crewai/ # CrewAI framework integration
│ ├── vercel/ # Vercel AI SDK integration
│ ├── stripe/ # Stripe Issuing + automation
│ ├── langchain/ # LangChain framework integration
│ ├── browser-use/ # Simplified browser automation
│ ├── braintrust/ # Evaluation and testing tools
│ └── agentkit/ # AgentKit implementations
└── README.md # This file
│ ├── agentkit/ # AgentKit implementations
│ ├── agno/ # Agno agent framework integration
│ ├── braintrust/ # Evaluation and testing tools
│ ├── browser-use/ # Browser Use automation
│ ├── cartesia/ # Cartesia integration
│ ├── cloudflare/ # Cloudflare integration
│ ├── crewai/ # CrewAI framework integration
│ ├── langchain/ # LangChain framework integration
│ ├── logs/ # Logging utilities
│ ├── mastra/ # Mastra AI agent integration
│ ├── mongodb/ # MongoDB data extraction & storage
│ ├── stripe/ # Stripe Issuing + automation
│ ├── temporal/ # Temporal workflow orchestration
│ ├── trigger/ # Trigger.dev background jobs & automation
│ └── vercel/ # Vercel integrations
└── README.md
```

## 🚀 Getting Started
## Getting Started

1. **Choose your integration** based on your framework or use case
2. **Navigate to the specific integration directory** for detailed setup instructions
3. **Follow the README** in each integration for environment setup and examples
4. **Review the code samples** to understand implementation patterns

Each integration includes:
- Complete setup instructions
- Environment configuration guides
- Working code examples
- Best practices and tips
- Troubleshooting guides
- Complete setup instructions
- Environment configuration guides
- Working code examples
- Best practices and tips
- Troubleshooting guides

## 🔧 Prerequisites
## Prerequisites

Most integrations require:
- A [Browserbase account](https://browserbase.com) and API key
- Node.js 18+ or Python 3.8+ (depending on implementation)
- Framework-specific dependencies (detailed in each integration)

## 📖 Documentation
## Documentation

For comprehensive documentation, tutorials, and API references, visit:

**🔗 [Official Browserbase Documentation](https://docs.browserbase.com)**
[Official Browserbase Documentation](https://docs.browserbase.com)

## 🤝 Community & Support
## Community & Support

### Get Help
- **📧 Email Support**: [support@browserbase.com](mailto:support@browserbase.com)
- **📚 Documentation**: [docs.browserbase.com](https://docs.browserbase.com)
- **Email Support**: [support@browserbase.com](mailto:support@browserbase.com)
- **Documentation**: [docs.browserbase.com](https://docs.browserbase.com)

### Contributing
We welcome contributions! Each integration has its own contribution guidelines. Feel free to:
Expand All @@ -124,7 +80,7 @@ We welcome contributions! Each integration has its own contribution guidelines.
- Share your own integration examples
- Help improve documentation

## 📄 License
## License

This project is licensed under the MIT License. See individual integration directories for any additional licensing information.

Expand Down
39 changes: 39 additions & 0 deletions examples/integrations/agentkit/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# AgentKit

## Using AgentKit with Browserbase

Develop AI Agents that can browse the web autonomously using Browserbase and AgentKit (by inngest).

## Overview

By the end of this guide, you'll have an AI agent built with AgentKit that can browse the web using Browserbase.

### You'll learn how to:

- Create AgentKit tools that leverage Browserbase's managed headless browsers
- Build autonomous web browsing agents that can search, extract data, and interact with websites
- Use Stagehand, Browserbase's AI-powered browser automation library, to create resilient web agents

### This integration is useful for:

- Building AI agents that can fetch real-time information from the web
- Creating autonomous browsing capabilities within your agents
- Developing resilient web scraping and interaction systems
- Enabling your agents to perform complex web-based tasks

### Integration Approaches

There are two approaches to using Browserbase with AgentKit:

1. **Create custom Browserbase tools**: Ideal for simple actions on webpages with manual browser control
2. **Use Stagehand library as tools**: Better for autonomous browsing and resilient web scraping

### Prerequisites

Before you start, make sure you have:

- AgentKit installed
- Browserbase Project ID & API key
- (Optional) LLM API key of your choice to use with Stagehand

Next, let's dive into building web browsing agents with AgentKit and Browserbase.
Loading