Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

wide mode for docs

Magnus Müllerfab4ad5833b5
diff --git a/docs/cloud/v1/authentication.mdx b/docs/cloud/v1/authentication.mdx
index cadd7ef14..3e468bee0 100644
--- a/docs/cloud/v1/authentication.mdx
+++ b/docs/cloud/v1/authentication.mdx
@@ -2,6 +2,7 @@
title: "Authentication"
description: "Learn how to authenticate with the Browser Use Cloud API"
icon: "lock"
+mode: "wide"
---
The Browser Use Cloud API uses API keys to authenticate requests. You can obtain an API key from your [Browser Use Cloud dashboard](https://cloud.browser-use.com/settings/api-keys).
diff --git a/docs/cloud/v1/custom-sdk.mdx b/docs/cloud/v1/custom-sdk.mdx
index 9b9473e9e..b52a992fe 100644
--- a/docs/cloud/v1/custom-sdk.mdx
+++ b/docs/cloud/v1/custom-sdk.mdx
@@ -2,6 +2,7 @@
title: "Cloud SDK"
description: "Learn how to set up your own Browser Use Cloud SDK"
icon: "code"
+mode: "wide"
---
This guide walks you through setting up your own Browser Use Cloud SDK.
diff --git a/docs/cloud/v1/implementation.mdx b/docs/cloud/v1/implementation.mdx
index 2d80250f1..37dc68d9e 100644
--- a/docs/cloud/v1/implementation.mdx
+++ b/docs/cloud/v1/implementation.mdx
@@ -2,6 +2,7 @@
title: "V1 Implementation"
description: "Learn how to implement the Browser Use API in Python"
icon: "code"
+mode: "wide"
---
This guide shows how to implement common API patterns using Python. We'll create a complete example that creates and monitors a browser automation task.
diff --git a/docs/cloud/v1/n8n-browser-use-integration.mdx b/docs/cloud/v1/n8n-browser-use-integration.mdx
index b18641a8b..84a749f0f 100644
--- a/docs/cloud/v1/n8n-browser-use-integration.mdx
+++ b/docs/cloud/v1/n8n-browser-use-integration.mdx
@@ -2,6 +2,7 @@
title: "N8N + Browser Use Cloud"
description: "Learn how to integrate Browser Use Cloud API with n8n using a practical workflow example (competitor research)."
icon: "plug"
+mode: "wide"
---
> **TL;DR** – In **3 minutes** you can have an n8n workflow that:
diff --git a/docs/cloud/v1/pricing.mdx b/docs/cloud/v1/pricing.mdx
index 85eff0116..98a954672 100644
--- a/docs/cloud/v1/pricing.mdx
+++ b/docs/cloud/v1/pricing.mdx
@@ -2,6 +2,7 @@
title: "Pricing"
description: "Browser Use Cloud API pricing structure and cost breakdown"
icon: "dollar-sign"
+mode: "wide"
---
The Browser Use Cloud API pricing consists of two components:
diff --git a/docs/cloud/v1/quickstart.mdx b/docs/cloud/v1/quickstart.mdx
index 0027968a6..34129e2fc 100644
--- a/docs/cloud/v1/quickstart.mdx
+++ b/docs/cloud/v1/quickstart.mdx
@@ -2,6 +2,7 @@
title: "Quickstart"
description: "Learn how to get started with the Browser Use Cloud API"
icon: "cloud"
+mode: "wide"
---
<img
diff --git a/docs/cloud/v1/search.mdx b/docs/cloud/v1/search.mdx
index 297861480..bad44386b 100644
--- a/docs/cloud/v1/search.mdx
+++ b/docs/cloud/v1/search.mdx
@@ -2,6 +2,7 @@
title: "Search API"
description: "Get started with Browser Use's search endpoints to extract content from websites"
icon: "magnifying-glass"
+mode: "wide"
---
<Warning>
diff --git a/docs/cloud/v1/webhooks.mdx b/docs/cloud/v1/webhooks.mdx
index 8e97c0cfa..833233c85 100644
--- a/docs/cloud/v1/webhooks.mdx
+++ b/docs/cloud/v1/webhooks.mdx
@@ -2,6 +2,7 @@
title: "Webhooks"
description: "Learn how to integrate webhooks with Browser Use Cloud API"
icon: "code"
+mode: "wide"
---
Webhooks allow you to receive real-time notifications about events in your Browser Use tasks. This guide will show you how to set up and verify webhook endpoints.
diff --git a/docs/cloud/v2/node-quickstart.mdx b/docs/cloud/v2/node-quickstart.mdx
index 603f7c931..13fd38c25 100644
--- a/docs/cloud/v2/node-quickstart.mdx
+++ b/docs/cloud/v2/node-quickstart.mdx
@@ -2,6 +2,7 @@
title: "Node.js"
description: "Get started with Browser Use Cloud API using Node.js"
icon: "node-js"
+mode: "wide"
---
<img src="/images/cloud-banner-js.png" alt="Browser Use Node.js" width="full" />
diff --git a/docs/cloud/v2/python-quickstart.mdx b/docs/cloud/v2/python-quickstart.mdx
index a23636235..2a749700e 100644
--- a/docs/cloud/v2/python-quickstart.mdx
+++ b/docs/cloud/v2/python-quickstart.mdx
@@ -2,6 +2,7 @@
title: "Python"
description: "Get started with Browser Use Cloud API using Python"
icon: "python"
+mode: "wide"
---
<img
diff --git a/docs/cloud/v2/quickstart.mdx b/docs/cloud/v2/quickstart.mdx
index 9a46bc1a6..1f522cc5b 100644
--- a/docs/cloud/v2/quickstart.mdx
+++ b/docs/cloud/v2/quickstart.mdx
@@ -2,6 +2,7 @@
title: "Quickstart"
description: "Skip the setup with Browser Use Cloud"
icon: "cloud"
+mode: "wide"
---
<img
diff --git a/docs/customize/agent-settings.mdx b/docs/customize/agent-settings.mdx
index 78f8f5511..a1c417631 100644
--- a/docs/customize/agent-settings.mdx
+++ b/docs/customize/agent-settings.mdx
@@ -2,6 +2,7 @@
title: "Agent Settings"
description: "Learn how to configure the agent"
icon: "gear"
+mode: "wide"
---
## Overview
diff --git a/docs/customize/browser-settings.mdx b/docs/customize/browser-settings.mdx
index a3c9d2e11..a6ce50ba7 100644
--- a/docs/customize/browser-settings.mdx
+++ b/docs/customize/browser-settings.mdx
@@ -2,6 +2,7 @@
title: "Browser Settings"
description: "Launch or connect to an existing browser and configure it to your needs."
icon: "globe"
+mode: "wide"
---
Browser Use uses [playwright](https://playwright.dev/python/docs/api/class-browsertype#browser-type-launch-persistent-context) (or [patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright)) to manage its connection with a real browser.
diff --git a/docs/customize/custom-functions.mdx b/docs/customize/custom-functions.mdx
index fa030a6fe..87bad6a6a 100644
--- a/docs/customize/custom-functions.mdx
+++ b/docs/customize/custom-functions.mdx
@@ -2,6 +2,7 @@
title: "Custom Functions"
description: "Extend default agent and write custom action functions to do certain tasks"
icon: "function"
+mode: "wide"
---
Custom actions are functions *you* provide, that are added to our [default actions](https://github.com/browser-use/browser-use/blob/main/browser_use/controller/service.py) the agent can use to accomplish tasks.
diff --git a/docs/customize/hooks.mdx b/docs/customize/hooks.mdx
index 8761cc281..d4f47d02b 100644
--- a/docs/customize/hooks.mdx
+++ b/docs/customize/hooks.mdx
@@ -3,6 +3,7 @@ title: "Lifecycle Hooks"
description: "Customize agent behavior with lifecycle hooks"
icon: "Wrench"
author: "Carlos A. Planchón"
+mode: "wide"
---
Browser-Use provides lifecycle hooks that allow you to execute custom code at specific points during the agent's execution.
diff --git a/docs/customize/mcp-client.mdx b/docs/customize/mcp-client.mdx
index 09ab71af2..976ec1df7 100644
--- a/docs/customize/mcp-client.mdx
+++ b/docs/customize/mcp-client.mdx
@@ -2,6 +2,7 @@
title: "MCP Client"
description: "Connect external MCP servers to extend browser-use with additional tools and integrations"
icon: "plug"
+mode: "wide"
---
The MCP (Model Context Protocol) client allows browser-use agents to connect to external MCP servers, automatically exposing their tools as actions.
diff --git a/docs/customize/mcp-server.mdx b/docs/customize/mcp-server.mdx
index ebfe9c9bf..06eb13385 100644
--- a/docs/customize/mcp-server.mdx
+++ b/docs/customize/mcp-server.mdx
@@ -2,6 +2,7 @@
title: "MCP Server"
description: "Expose browser-use capabilities as an MCP server for AI assistants like Claude Desktop"
icon: "server"
+mode: "wide"
---
The MCP server exposes browser-use's browser automation capabilities as tools that can be used by AI assistants like Claude Desktop. This allows external MCP clients to control browsers, navigate websites, extract content, and perform automated tasks.
diff --git a/docs/customize/output-format.mdx b/docs/customize/output-format.mdx
index f306af184..434dcf06f 100644
--- a/docs/customize/output-format.mdx
+++ b/docs/customize/output-format.mdx
@@ -2,6 +2,7 @@
title: "Output Format"
description: "The default is text. But you can define a structured output format to make post-processing easier."
icon: "code"
+mode: "wide"
---
## Custom output format
diff --git a/docs/customize/real-browser.mdx b/docs/customize/real-browser.mdx
index 7101b4735..1ae852882 100644
--- a/docs/customize/real-browser.mdx
+++ b/docs/customize/real-browser.mdx
@@ -2,6 +2,7 @@
title: "Connect to your Browser"
description: "Connect to a remote browser or launch a new local browser."
icon: "computer"
+mode: "wide"
---
## Overview
diff --git a/docs/customize/sensitive-data.mdx b/docs/customize/sensitive-data.mdx
index c536f8bd6..68a194c19 100644
--- a/docs/customize/sensitive-data.mdx
+++ b/docs/customize/sensitive-data.mdx
@@ -2,6 +2,7 @@
title: "Sensitive Data"
description: "Handle sensitive information securely and avoid sending PII & passwords to the LLM."
icon: "shield"
+mode: "wide"
---
## Handling Sensitive Data
diff --git a/docs/customize/supported-models.mdx b/docs/customize/supported-models.mdx
index 3a17f3371..b1755e9b9 100644
--- a/docs/customize/supported-models.mdx
+++ b/docs/customize/supported-models.mdx
@@ -2,6 +2,7 @@
title: "Supported Models"
description: "Choose your favorite LLM"
icon: "robot"
+mode: "wide"
---
### Recommendations
diff --git a/docs/customize/system-prompt.mdx b/docs/customize/system-prompt.mdx
index 98df732ae..23c72654a 100644
--- a/docs/customize/system-prompt.mdx
+++ b/docs/customize/system-prompt.mdx
@@ -2,6 +2,7 @@
title: "System Prompt"
description: "Customize the system prompt to control agent behavior and capabilities"
icon: "message"
+mode: "wide"
---
## Overview
diff --git a/docs/development.mdx b/docs/development.mdx
index 61b85ee42..18b7c432f 100644
--- a/docs/development.mdx
+++ b/docs/development.mdx
@@ -1,6 +1,7 @@
---
title: 'Development'
description: 'Preview changes locally to update your docs'
+mode: "wide"
---
<Info>
diff --git a/docs/development/contribution-guide.mdx b/docs/development/contribution-guide.mdx
index ccec248eb..4fb182bf9 100644
--- a/docs/development/contribution-guide.mdx
+++ b/docs/development/contribution-guide.mdx
@@ -2,6 +2,7 @@
title: "Contribution Guide"
description: "Learn how to contribute to Browser Use"
icon: "github"
+mode: "wide"
---
# Join the Browser Use Community!
diff --git a/docs/development/evaluations.mdx b/docs/development/evaluations.mdx
index 1a98ca8ae..917862c92 100644
--- a/docs/development/evaluations.mdx
+++ b/docs/development/evaluations.mdx
@@ -2,6 +2,7 @@
title: "Evaluations"
description: "Test the Browser Use agent on standardized benchmarks"
icon: "chart-bar"
+mode: "wide"
---
## Prerequisites
diff --git a/docs/development/local-setup.mdx b/docs/development/local-setup.mdx
index d4442782a..44827401e 100644
--- a/docs/development/local-setup.mdx
+++ b/docs/development/local-setup.mdx
@@ -2,6 +2,7 @@
title: "Local Setup"
description: "Set up Browser Use development environment locally"
icon: "laptop-code"
+mode: "wide"
---
# Welcome to Browser Use Development!
diff --git a/docs/development/n8n-integration.mdx b/docs/development/n8n-integration.mdx
index 2a6fd29b5..70e165792 100644
--- a/docs/development/n8n-integration.mdx
+++ b/docs/development/n8n-integration.mdx
@@ -1,6 +1,7 @@
---
title: 'n8n Integration'
description: 'Learn how to integrate Browser Use with n8n workflows'
+mode: "wide"
---
# Browser Use n8n Integration
diff --git a/docs/development/observability.mdx b/docs/development/observability.mdx
index 2064533ee..dd1a12a45 100644
--- a/docs/development/observability.mdx
+++ b/docs/development/observability.mdx
@@ -2,6 +2,7 @@
title: "Observability"
description: "Trace Browser Use's agent execution steps and browser sessions"
icon: "eye"
+mode: "wide"
---
## Overview
diff --git a/docs/development/roadmap.mdx b/docs/development/roadmap.mdx
index 34f05f5a4..4ff49e8bc 100644
--- a/docs/development/roadmap.mdx
+++ b/docs/development/roadmap.mdx
@@ -2,6 +2,7 @@
title: "Roadmap"
description: "Future plans and upcoming features for Browser Use"
icon: "road"
+mode: "wide"
---
Big things coming soon!
diff --git a/docs/development/telemetry.mdx b/docs/development/telemetry.mdx
index fe4f7cb54..c2ef35758 100644
--- a/docs/development/telemetry.mdx
+++ b/docs/development/telemetry.mdx
@@ -2,6 +2,7 @@
title: "Telemetry"
description: "Understanding Browser Use's telemetry and privacy settings"
icon: "chart-mixed"
+mode: "wide"
---
## Overview
diff --git a/docs/docs.json b/docs/docs.json
index 695cf3e80..1cb2191e0 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -31,8 +31,14 @@
"group": "Get Started",
"pages": [
"introduction",
- "quickstart",
- "quickstart_llm"
+ {
+ "group": "Quickstart",
+ "icon": "rocket",
+ "pages": [
+ "quickstart",
+ "quickstart_llm"
+ ]
+ }
]
},
{
diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx
index 961a63833..3c5f4b2f8 100644
--- a/docs/quickstart.mdx
+++ b/docs/quickstart.mdx
@@ -1,7 +1,7 @@
---
title: "Quickstart for humans"
description: ""
-icon: "rocket"
+icon: "person"
---
diff --git a/docs/quickstart_llm.mdx b/docs/quickstart_llm.mdx
index d96d54cc8..99d9e2315 100644
--- a/docs/quickstart_llm.mdx
+++ b/docs/quickstart_llm.mdx
@@ -5,10 +5,10 @@ icon: "robot"
---
<Info>
-**Copy our entire documentation into your coding agent**
-1. Click the [link](https://docs.browser-use.com/llms-full.txt)
-2. Copy all content (~40k tokens)
-3. Paste it to Cursor, Claude or ChatGPT
+
+
+1. Copy all content [from here](https://docs.browser-use.com/llms-full.txt) (~40k tokens)
+2. Paste it into your favorite coding agent (Cursor, Claude, ChatGPT, ...).
</Info>
**🔗 [Our docs for LLMs](https://docs.browser-use.com/llms-full.txt)**