Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "3.19.3"
".": "3.20.0"
}
6 changes: 3 additions & 3 deletions .stats.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
configured_endpoints: 8
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-dbbff1a35360850898f7d60588e257faeac145a73cfcae634cfeb1b70109b6af.yml
openapi_spec_hash: 28c4b734a5309067c39bb4c4b709b9ab
config_hash: a962ae71493deb11a1c903256fb25386
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-6f6bfb81d092f30a5e2005328c97d61b9ea36132bb19e9e79e55294b9534ce20.yml
openapi_spec_hash: f3fc1e3688a38dc2c28f7178f7d534e5
config_hash: 1fb12ae9b478488bc1e56bfbdc210b01
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,15 @@
# Changelog

## 3.20.0 (2026-05-06)

Full Changelog: [v3.19.3...v3.20.0](https://github.com/browserbase/stagehand-net/compare/v3.19.3...v3.20.0)

### Features

* [feat]: add `ignoreSelectors` to `extract()` ([a9b327f](https://github.com/browserbase/stagehand-net/commit/a9b327f17942b28a16800c3dd93b569bb1bac6dc))
* [STG-1808] Deprecate Browserbase project ID ([1571286](https://github.com/browserbase/stagehand-net/commit/15712866df03d50e920ab9f71e24e30d7b17e455))
* remove experimental requirement on agent variables ([#2079](https://github.com/browserbase/stagehand-net/issues/2079)) ([1c3a03c](https://github.com/browserbase/stagehand-net/commit/1c3a03c6961d3c4fab99e2852ce0ea4dc4778444))

## 3.19.3 (2026-05-05)

Full Changelog: [v3.18.0...v3.19.3](https://github.com/browserbase/stagehand-net/compare/v3.18.0...v3.19.3)
Expand Down
13 changes: 6 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ namespace Stagehand.Examples
static async Task Main(string[] args)
{
Env.Load();
// Uses environment variables: STAGEHAND_API_URL, BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY
// Uses environment variables: BROWSERBASE_API_KEY and MODEL_API_KEY
StagehandClient client = new();

// Start a new remote Browserbase session (Playwright-backed)
Expand Down Expand Up @@ -325,10 +325,8 @@ namespace Stagehand.Examples

Set your environment variables (from `examples/.env.example`):

- `STAGEHAND_API_URL`
- `MODEL_API_KEY`
- `BROWSERBASE_API_KEY`
- `BROWSERBASE_PROJECT_ID`

```bash
cp examples/.env.example examples/.env
Expand Down Expand Up @@ -373,7 +371,7 @@ Configure the client using environment variables:
```csharp
using Stagehand;

// Configured using the BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY and STAGEHAND_API_URL environment variables
// Configured using BROWSERBASE_API_KEY, MODEL_API_KEY, and STAGEHAND_API_URL, with STAGEHAND_BASE_URL as a fallback
StagehandClient client = new();
```

Expand All @@ -385,7 +383,6 @@ using Stagehand;
StagehandClient client = new()
{
BrowserbaseApiKey = "My Browserbase API Key",
BrowserbaseProjectID = "My Browserbase Project ID",
ModelApiKey = "My Model API Key",
};
```
Expand All @@ -397,9 +394,11 @@ See this table for the available options:
| Property | Environment variable | Required | Default value |
| ---------------------- | ------------------------ | -------- | ----------------------------------------- |
| `BrowserbaseApiKey` | `BROWSERBASE_API_KEY` | true | - |
| `BrowserbaseProjectID` | `BROWSERBASE_PROJECT_ID` | true | - |
| `BrowserbaseProjectID` | - | false | - |
| `ModelApiKey` | `MODEL_API_KEY` | true | - |
| `BaseUrl` | `STAGEHAND_API_URL` | true | `"https://api.stagehand.browserbase.com"` |
| `BaseUrl` | `STAGEHAND_API_URL` | false | `"https://api.stagehand.browserbase.com"` |

`BrowserbaseProjectID` is deprecated, accepted for backwards compatibility, and ignored. `STAGEHAND_BASE_URL` remains supported as a deprecated fallback when `STAGEHAND_API_URL` is unset.

### Modifying configuration

Expand Down
2 changes: 0 additions & 2 deletions examples/.env.example
Original file line number Diff line number Diff line change
@@ -1,4 +1,2 @@
STAGEHAND_API_URL=https://api.stagehand.browserbase.com
MODEL_API_KEY=sk-proj-your-llm-api-key-here
BROWSERBASE_API_KEY=bb_live_your_api_key_here
BROWSERBASE_PROJECT_ID=your-bb-project-uuid-here
8 changes: 1 addition & 7 deletions examples/Env.cs
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,7 @@ namespace Stagehand.Examples
{
internal static class Env
{
private static readonly string[] RequiredKeys =
[
"STAGEHAND_API_URL",
"MODEL_API_KEY",
"BROWSERBASE_API_KEY",
"BROWSERBASE_PROJECT_ID",
];
private static readonly string[] RequiredKeys = ["MODEL_API_KEY", "BROWSERBASE_API_KEY"];

public static void Load()
{
Expand Down
2 changes: 1 addition & 1 deletion examples/local_browser_playwright_example.cs
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ public static async Task RunAsync()
{
Env.Load();
// Uses environment variables: MODEL_API_KEY
// In local mode, BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID can be any value.
// In local mode, BROWSERBASE_API_KEY can be any value.
StagehandClient client = new();

// Start a new local session
Expand Down
4 changes: 2 additions & 2 deletions examples/local_server_multiregion_browser_example.cs
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ internal static class LocalServerMultiregionBrowserExample
public static async Task RunAsync()
{
Env.Load();
// Uses environment variables: BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY
// STAGEHAND_API_URL should point to the local Stagehand server.
// Uses environment variables: BROWSERBASE_API_KEY and MODEL_API_KEY
// STAGEHAND_API_URL should point to the local Stagehand server; STAGEHAND_BASE_URL is a fallback.
StagehandClient client = new();

var startResponse = await client.Sessions.Start(
Expand Down
2 changes: 1 addition & 1 deletion examples/remote_browser_playwright_example.cs
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ internal static class RemoteBrowserPlaywrightExample
public static async Task RunAsync()
{
Env.Load();
// Uses environment variables: BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY
// Uses environment variables: BROWSERBASE_API_KEY and MODEL_API_KEY
StagehandClient client = new();

// Start a new remote Browserbase session (Playwright-backed)
Expand Down
Loading
Loading