@darbotlabs/darbot-browser-mcp 0.1.1 → 1.3.0

package/README.md

@@ -2,34 +2,39 @@
 
 ![Darbot Banner](./assets/darbot_logo_icon_pack/darbot-horizontal-banner-1500x500.png)
 
-**🤖 Your Autonomous Browser Companion - Powered by AI**
+**Your Autonomous Browser Companion**
 
-A Model Context Protocol (MCP) server that provides intelligent autonomous browser capabilities. This server enables AI models to interact with web pages through structured accessibility snapshots, delivering autonomous browsing without requiring vision models. Optimized for Microsoft Edge with comprehensive work profile support.
+Darbot Browser is a framework for autonomous web automation. This tool enables AI models to interact with UI through structured accessibility snapshots, delivering autonomous browsing without requiring vision models. Optimized for Microsoft Edge with comprehensive session state support.
 
 [![NPM Version](https://img.shields.io/npm/v/@darbotlabs/darbot-browser-mcp?style=flat-square&color=0098FF)](https://www.npmjs.com/package/@darbotlabs/darbot-browser-mcp)
 [![Downloads](https://img.shields.io/npm/dm/@darbotlabs/darbot-browser-mcp?style=flat-square&color=0098FF)](https://www.npmjs.com/package/@darbotlabs/darbot-browser-mcp)
 [![VS Code Extension](https://img.shields.io/visual-studio-marketplace/v/darbotlabs.darbot-browser-mcp?style=flat-square&color=24bfa5&label=VS%20Code)](https://marketplace.visualstudio.com/items?itemName=darbotlabs.darbot-browser-mcp)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](./LICENSE)
 
-## ✨ Key Features
+## Key Features
 
-- **🚀 Fast and lightweight** - Uses accessibility tree, not pixel-based input
-- **🧠 AI-friendly** - No vision models needed, operates purely on structured data  
-- **🎯 Deterministic** - Avoids ambiguity common with screenshot-based approaches
-- **🔄 Work Profiles** - Save and restore complete browser sessions
-- **🛠️ 29 Autonomous Tools** - Comprehensive autonomous browser capabilities
-- **⚡ Multi-Platform** - Available as NPM package, VS Code extension, NuGet package, and browser extension
+- **Fast and lightweight** - Uses accessibility tree, not pixel-based input
+- **DarbotLM framework** - No vision models needed, operates purely on structured data
+- **Deterministic** - Avoids ambiguity common with screenshot-based approaches
+- **Session States** - Save and restore complete browser sessions with Edge profile context
+- **52 Autonomous Tools** - Comprehensive autonomous browser capabilities
+- **Autonomous Crawling** - BFS strategy with memory, guardrails, and reporting
+- **DarbotLabsMemory System** - State tracking and deduplication with darbot-memory-mcp integration
+- **HTML Reports** - Comprehensive crawl reports with screenshots and statistics
+- **Multi-Platform** - Available as NPM package, VS Code extension, NuGet package, and browser extension
 
-## 📋 Requirements
-- **Node.js** 18 or newer
+## Requirements
+
+- **Node.js** 23 or newer
 - **VS Code, Cursor, Windsurf, Claude Desktop** or any other MCP client
 - **Microsoft Edge** (recommended) or Chrome/Firefox/WebKit
 
-## 📦 Installation Options
+## Installation Options
 
 Darbot Browser MCP is available in multiple package formats:
 
-### 🔧 NPM Package
+### NPM Package
+
 ```bash
 # Install globally
 npm install -g @darbotlabs/darbot-browser-mcp
@@ -38,36 +43,48 @@ npm install -g @darbotlabs/darbot-browser-mcp
 npx @darbotlabs/darbot-browser-mcp@latest
 ```
 
-### 🔌 VS Code Extension
+### VS Code Extension
+
 Install the **"Darbot Browser MCP"** extension from the VS Code marketplace or search for `darbotlabs.darbot-browser-mcp`.
 
-[**📥 Install VS Code Extension**](https://marketplace.visualstudio.com/items?itemName=darbotlabs.darbot-browser-mcp)
+The extension **automatically configures the MCP server** when installed - just enable MCP in VS Code settings and start the server!
+
+[**Install VS Code Extension**](https://marketplace.visualstudio.com/items?itemName=darbotlabs.darbot-browser-mcp)
+
+**Quick Setup:**
+
+1. Install the extension from VS Code marketplace
+2. The extension will automatically prompt you to enable MCP and configure the server
+3. Use Command Palette: "Darbot Browser MCP: Start Server"
+4. Start chatting with GitHub Copilot using browser automation tools!
+
+### NuGet Package (.NET)
 
-### 📚 NuGet Package (.NET)
 ```bash
 # Install for .NET projects
 dotnet add package DarbotLabs.Browser.MCP
 ```
 
-### 🌐 Browser Extension
+### Browser Extension
+
 Install the **Browser MCP Bridge** extension from the Chrome Web Store to share browser tabs with the MCP server.
 
 ---
 
-## 🎯 Why Choose Darbot Browser MCP?
+## Why Choose Darbot Browser MCP?
 
-| Traditional Browser Automation | 🤖 Darbot Browser MCP |
-|--------------------------------|------------------------|
-| ❌ Pixel-based, brittle selectors | ✅ AI-friendly accessibility snapshots |
-| ❌ Requires vision models | ✅ Pure structured data approach |
-| ❌ Complex setup and maintenance | ✅ Simple NPM install, ready in seconds |
-| ❌ Browser-specific code | ✅ Universal MCP protocol |
-| ❌ No session management | ✅ Advanced autonomous work profiles |
+| Traditional Browser Automation | Darbot Browser MCP |
+| ----------------------------- | -------------------- |
+| ERROR Pixel-based, brittle selectors | AI-friendly accessibility snapshots |
+| ERROR Requires vision models | Pure structured data approach |
+| ERROR Complex setup and maintenance | Simple NPM install, ready in seconds |
+| ERROR Browser-specific code | Universal MCP protocol |
+| ERROR No session management | Advanced autonomous session states |
 
-### 🛠️ Complete Autonomous Toolkit (29 Tools)
+### Complete Autonomous Toolkit (52 Tools)
 
 <details>
-<summary><b>🔧 Core Autonomous Operations</b></summary>
+<summary><b> Core Autonomous Operations</b></summary>
 
 - `browser_navigate` - Autonomously navigate to any URL
 - `browser_click` - Autonomous intelligent element clicking  
@@ -78,12 +95,22 @@ Install the **Browser MCP Bridge** extension from the Chrome Web Store to share
 </details>
 
 <details>
-<summary><b>📁 Autonomous Work Profile Management</b></summary>
+<summary><b>Autonomous Crawling & Intelligence</b></summary>
 
-- `browser_save_profile` - Autonomously save complete browser sessions
-- `browser_switch_profile` - Autonomously load saved profiles  
-- `browser_list_profiles` - Autonomously manage all your profiles
-- `browser_delete_profile` - Autonomous clean profile management
+- `browser_start_autonomous_crawl` - Start intelligent BFS crawling with memory and reporting
+- `browser_configure_memory` - Configure memory system with darbot-memory-mcp integration
+- Built-in guardrail system for safe autonomous operation
+- Comprehensive HTML reporting with screenshots and statistics
+
+</details>
+
+<details>
+<summary><b>Autonomous Session State Management</b></summary>
+
+- `browser_save_profile` - Save complete browser session states with Edge profile context
+- `browser_switch_profile` - Restore saved session states  
+- `browser_list_profiles` - List all saved session states with Edge/workspace context
+- `browser_delete_profile` - Delete session states from storage
 
 </details>
 
@@ -97,7 +124,7 @@ Install the **Browser MCP Bridge** extension from the Chrome Web Store to share
 </details>
 
 <details>
-<summary><b>🗂️ Autonomous Tab Management</b></summary>
+<summary><b>️ Autonomous Tab Management</b></summary>
 
 - `browser_tab_new` - Autonomously open new tabs
 - `browser_tab_list` - Autonomously get all open tabs
@@ -107,7 +134,7 @@ Install the **Browser MCP Bridge** extension from the Chrome Web Store to share
 </details>
 
 <details>
-<summary><b>🧪 Autonomous Testing & Development</b></summary>
+<summary><b>Autonomous Testing & Development</b></summary>
 
 - `browser_generate_playwright_test` - Autonomously auto-generate test code
 - `browser_console_messages` - Autonomous debug with console access
@@ -115,16 +142,27 @@ Install the **Browser MCP Bridge** extension from the Chrome Web Store to share
 
 </details>
 
-[**📖 View All 29 Tools**](#tools)
+[**View All 52 tools**](#tools)
 
 <!--
 // Generate using:
 node utils/generate-links.js
 -->
 
-## 🚀 Getting Started
+## Getting Started
+
+The fastest way to get started is with the VS Code extension, which automatically configures everything for you. For other clients, you'll need to manually configure the MCP server.
 
-First, install the Browser MCP server with your client. A typical configuration looks like this:
+### **VS Code (Automatic Setup)**
+
+1. Install the [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=darbotlabs.darbot-browser-mcp)
+2. Extension auto-configures MCP settings
+3. Start the server via Command Palette
+4. Use with GitHub Copilot Chat!
+
+### **Manual Configuration (Other Clients)**
+
+For Claude Desktop, Cursor, Windsurf, etc., add this configuration:
 
 ```js
 {
@@ -139,14 +177,26 @@ First, install the Browser MCP server with your client. A typical configuration
 }
 ```
 
-### 📱 Quick Install Buttons
+### Quick Install Buttons
+
+**VS Code (Automatic):**
+[<img src="https://img.shields.io/badge/VS_Code-Auto_Install_Extension-0098FF?style=for-the-badge&logo=visual-studio-code" alt="Install VS Code Extension">](https://marketplace.visualstudio.com/items?itemName=darbotlabs.darbot-browser-mcp)
+
+**Manual Configuration:**
+[<img src="https://img.shields.io/badge/VS_Code-Manual_Server_Config-0098FF?style=for-the-badge&logo=visual-studio-code" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522browser%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540darbotlabs%252Fdarbot-browser-mcp%2540latest%2522%255D%257D) [<img src="https://img.shields.io/badge/VS_Code_Insiders-Manual_Server_Config-24bfa5?style=for-the-badge&logo=visual-studio-code" alt="Install in VS Code Insiders">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522browser%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540darbotlabs%252Fdarbot-browser-mcp%2540latest%2522%255D%257D)
 
-[<img src="https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visual-studio-code" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522browser%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540darbotlabs%252Fdarbot-browser-mcp%2540latest%2522%255D%257D) [<img src="https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=for-the-badge&logo=visual-studio-code" alt="Install in VS Code Insiders">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522browser%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540darbotlabs%252Fdarbot-browser-mcp%2540latest%2522%255D%257D)
+<details><summary><b>Install in VS Code (Automatic Setup)</b></summary>
 
+**Recommended: Use the VS Code Extension for automatic setup!**
 
-<details><summary><b>Install in VS Code</b></summary>
+The [Darbot Browser MCP Extension](https://marketplace.visualstudio.com/items?itemName=darbotlabs.darbot-browser-mcp) automatically handles all configuration:
 
-You can also install the Browser MCP server using the VS Code CLI:
+1. **Install from marketplace**: Search "Darbot Browser MCP" in VS Code extensions
+2. **Auto-configuration**: Extension prompts to enable MCP and configures the server
+3. **Start & Use**: Use Command Palette → "Darbot Browser MCP: Start Server"
+4. **Chat with Copilot**: Ask GitHub Copilot to "browse to example.com"
+
+**Manual CLI installation (if you prefer):**
 
 ```bash
 # For VS Code
@@ -179,6 +229,7 @@ Go to `Cursor Settings` -> `MCP` -> `Add new MCP Server`. Name to your liking, u
   }
 }
 ```
+
 </details>
 
 <details>
@@ -198,6 +249,7 @@ Follow Windsuff MCP [documentation](https://docs.windsurf.com/windsurf/cascade/m
   }
 }
 ```
+
 </details>
 
 <details>
@@ -217,6 +269,7 @@ Follow the MCP install [guide](https://modelcontextprotocol.io/quickstart/user),
   }
 }
 ```
+
 </details>
 
 <details>
@@ -227,6 +280,7 @@ Use the Claude Code CLI to add the Browser MCP server:
 ```bash
 claude mcp add browser npx @darbotlabs/darbot-browser-mcp@latest
 ```
+
 </details>
 
 <details>
@@ -258,53 +312,69 @@ Browser MCP server supports following arguments. They can be provided in the JSO
 
 ```
 > npx darbot-browser-mcp@latest --help
-  --allowed-origins <origins>  semicolon-separated list of origins to allow the
-                               browser to request. Default is to allow all.
-  --blocked-origins <origins>  semicolon-separated list of origins to block the
-                               browser from requesting. Blocklist is evaluated
-                               before allowlist. If used without the allowlist,
-                               requests not matching the blocklist are still
-                               allowed.
-  --block-service-workers      block service workers
-  --browser <browser>          browser or chrome channel to use, possible
-                               values: msedge, chrome, firefox, webkit.
-  --browser-agent <endpoint>   Use browser agent (experimental).
-  --caps <caps>                comma-separated list of capabilities to enable,
-                               possible values: tabs, pdf, history, wait, files,
-                               install. Default is all.
-  --cdp-endpoint <endpoint>    CDP endpoint to connect to.
-  --config <path>              path to the configuration file.
-  --device <device>            device to emulate, for example: "iPhone 15"
-  --executable-path <path>     path to the browser executable.
-  --headless                   run browser in headless mode, headed by default
-  --host <host>                host to bind server to. Default is localhost. Use
-                               0.0.0.0 to bind to all interfaces.
-  --ignore-https-errors        ignore https errors
-  --isolated                   keep the browser profile in memory, do not save
-                               it to disk.
-  --image-responses <mode>     whether to send image responses to the client.
-                               Can be "allow", "omit", or "auto". Defaults to
-                               "auto", which sends images if the client can
-                               display them.
-  --no-sandbox                 disable the sandbox for all process types that
-                               are normally sandboxed.
-  --output-dir <path>          path to the directory for output files.
-  --port <port>                port to listen on for SSE transport.
-  --proxy-bypass <bypass>      comma-separated domains to bypass proxy, for
-                               example ".com,chromium.org,.domain.com"
-  --proxy-server <proxy>       specify proxy server, for example
-                               "http://myproxy:3128" or "socks5://myproxy:8080"
-  --save-trace                 Whether to save the Playwright Trace of the
-                               session into the output directory.
-  --storage-state <path>       path to the storage state file for isolated
-                               sessions.
-  --user-agent <ua string>     specify user agent string
-  --user-data-dir <path>       path to the user data directory. If not
-                               specified, a temporary directory will be created.
-  --viewport-size <size>       specify browser viewport size in pixels, for
-                               example "1280, 720"
-  --vision                     Run server that uses screenshots (Aria snapshots
-                               are used by default)
+  --allowed-origins <origins>   semicolon-separated list of origins to allow the
+                                browser to request. Default is to allow all.
+  --blocked-origins <origins>   semicolon-separated list of origins to block the
+                                browser from requesting. Blocklist is evaluated
+                                before allowlist. If used without the allowlist,
+                                requests not matching the blocklist are still
+                                allowed.
+  --block-service-workers       block service workers
+  --browser <browser>           browser or chrome channel to use, possible
+                                values: msedge, chrome, firefox, webkit.
+  --browser-agent <endpoint>    Use browser agent (experimental).
+  --caps <caps>                 comma-separated list of capabilities to enable,
+                                possible values: tabs, pdf, history, wait,
+                                files, install. Default is all.
+  --cdp-endpoint <endpoint>     CDP endpoint to connect to.
+  --config <path>               path to the configuration file.
+  --device <device>             device to emulate, for example: "iPhone 15"
+  --executable-path <path>      path to the browser executable.
+  --headless                    run browser in headless mode, headed by default
+  --host <host>                 host to bind server to. Default is localhost.
+                                Use 0.0.0.0 to bind to all interfaces.
+  --ignore-https-errors         ignore https errors
+  --isolated                    keep the browser profile in memory, do not save
+                                it to disk.
+  --image-responses <mode>      whether to send image responses to the client.
+                                Can be "allow", "omit", or "auto". Defaults to
+                                "auto", which sends images if the client can
+                                display them.
+  --no-sandbox                  disable the sandbox for all process types that
+                                are normally sandboxed.
+  --output-dir <path>           path to the directory for output files.
+  --port <port>                 port to listen on for SSE transport.
+  --proxy-bypass <bypass>       comma-separated domains to bypass proxy, for
+                                example ".com,chromium.org,.domain.com"
+  --proxy-server <proxy>        specify proxy server, for example
+                                "http://myproxy:3128" or "socks5://myproxy:8080"
+  --save-trace                  Whether to save the Playwright Trace of the
+                                session into the output directory.
+  --storage-state <path>        path to the storage state file for isolated
+                                sessions.
+  --user-agent <ua string>      specify user agent string
+  --user-data-dir <path>        path to the user data directory. If not
+                                specified, a temporary directory will be
+                                created.
+  --viewport-size <size>        specify browser viewport size in pixels, for
+                                example "1280, 720"
+  --vision                      Run server that uses screenshots (Aria snapshots
+                                are used by default)
+  --edge-profile <name>         Edge profile name to use (e.g., "Profile 1",
+                                "Default"). This is recorded in saved session
+                                states.
+  --edge-profile-email <email>  Email associated with the Edge profile. This is
+                                recorded in saved session states for context.
+  --auto-sign-in                Auto sign in with work/school account (Edge
+                                profile preference)
+  --profile-switching           Enable automatic profile switching based on site
+                                (Edge profile preference)
+  --intranet-switch             Automatically switch to work profile for
+                                intranet sites (Edge profile preference)
+  --ie-mode-switch              Automatically switch profile for IE mode sites
+                                (Edge profile preference)
+  --default-profile <name>      Default Edge profile for external links (Edge
+                                profile preference)
 ```
 
 <!--- End of options generated section -->
@@ -438,6 +508,7 @@ npx @darbotlabs/darbot-browser-mcp@latest --config path/to/config.json
   noImageResponses?: boolean;
 }
 ```
+
 </details>
 
 ### Standalone MCP server
@@ -449,13 +520,13 @@ run the MCP server from environment with the DISPLAY and pass the `--port` flag
 npx @darbotlabs/darbot-browser-mcp@latest --port 8931
 ```
 
-And then in MCP client config, set the `url` to the SSE endpoint:
+And then in MCP client config, set the `url` to the MCP endpoint:
 
 ```js
 {
   "mcpServers": {
     "playwright": {
-      "url": "http://localhost:8931/sse"
+      "url": "http://localhost:8931/mcp"
     }
   }
 }
@@ -482,6 +553,7 @@ You can build the Docker image yourself.
 ```
 docker build -t mcr.microsoft.com/playwright/mcp .
 ```
+
 </details>
 
 <details>
@@ -504,6 +576,7 @@ http.createServer(async (req, res) => {
   // ...
 });
 ```
+
 </details>
 
 ### Tools
@@ -540,26 +613,27 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_snapshot**
-  - Title: Page snapshot
-  - Description: Capture accessibility snapshot of the current page, this is better than screenshot
+  - Title: Autonomous page snapshot
+  - Description: Autonomously capture a detailed accessibility snapshot of the current page for analysis. This provides structured page content better than a screenshot.
   - Parameters: None
   - Read-only: **true**
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_click**
-  - Title: Click
-  - Description: Perform click on a web page
+  - Title: Autonomous click
+  - Description: Autonomously perform click interactions on web page elements
   - Parameters:
     - `element` (string): Human-readable element description used to obtain permission to interact with the element
     - `ref` (string): Exact target element reference from the page snapshot
+    - `doubleClick` (boolean, optional): Whether to perform a double click instead of a single click
   - Read-only: **false**
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_drag**
-  - Title: Drag mouse
-  - Description: Perform drag and drop between two elements
+  - Title: Autonomous drag & drop
+  - Description: Autonomously perform drag and drop operations between web page elements
   - Parameters:
     - `startElement` (string): Human-readable source element description used to obtain the permission to interact with the element
     - `startRef` (string): Exact source element reference from the page snapshot
@@ -570,8 +644,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_hover**
-  - Title: Hover mouse
-  - Description: Hover over element on page
+  - Title: Autonomous hover
+  - Description: Autonomously hover over specific elements on the web page
   - Parameters:
     - `element` (string): Human-readable element description used to obtain permission to interact with the element
     - `ref` (string): Exact target element reference from the page snapshot
@@ -580,8 +654,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_type**
-  - Title: Type text
-  - Description: Type text into editable element
+  - Title: Autonomous text input
+  - Description: Autonomously type text into editable elements on the web page
   - Parameters:
     - `element` (string): Human-readable element description used to obtain permission to interact with the element
     - `ref` (string): Exact target element reference from the page snapshot
@@ -593,8 +667,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_select_option**
-  - Title: Select option
-  - Description: Select an option in a dropdown
+  - Title: Autonomous dropdown selection
+  - Description: Autonomously select options in dropdown menus on the web page
   - Parameters:
     - `element` (string): Human-readable element description used to obtain permission to interact with the element
     - `ref` (string): Exact target element reference from the page snapshot
@@ -604,8 +678,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_press_key**
-  - Title: Press a key
-  - Description: Press a key on the keyboard
+  - Title: Autonomous keyboard input
+  - Description: Autonomously press keys on the keyboard to interact with the web page
   - Parameters:
     - `key` (string): Name of the key to press or a character to generate, such as `ArrowLeft` or `a`
   - Read-only: **false**
@@ -613,8 +687,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_wait_for**
-  - Title: Wait for
-  - Description: Wait for text to appear or disappear or a specified time to pass
+  - Title: Autonomous wait conditions
+  - Description: Autonomously wait for specific conditions: text appearance, text disappearance, or time duration
   - Parameters:
     - `time` (number, optional): The time to wait in seconds
     - `text` (string, optional): The text to wait for
@@ -624,8 +698,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_file_upload**
-  - Title: Upload files
-  - Description: Upload one or multiple files
+  - Title: Autonomous file upload
+  - Description: Autonomously upload one or multiple files when a file chooser dialog appears
   - Parameters:
     - `paths` (array): The absolute paths to the files to upload. Can be a single file or multiple files.
   - Read-only: **false**
@@ -633,8 +707,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_handle_dialog**
-  - Title: Handle a dialog
-  - Description: Handle a dialog
+  - Title: Autonomous dialog handling
+  - Description: Autonomously handle browser dialog boxes (alerts, confirmations, prompts)
   - Parameters:
     - `accept` (boolean): Whether to accept the dialog.
     - `promptText` (string, optional): The text of the prompt in case of a prompt dialog.
@@ -649,7 +723,7 @@ X Y coordinate space, based on the provided screenshot.
 
 - **browser_navigate**
   - Title: Navigate to a URL
-  - Description: Navigate to a URL
+  - Description: Autonomously navigate the browser to any URL. Use this command to launch and direct the browser to websites.
   - Parameters:
     - `url` (string): The URL to navigate to
   - Read-only: **false**
@@ -658,7 +732,7 @@ X Y coordinate space, based on the provided screenshot.
 
 - **browser_navigate_back**
   - Title: Go back
-  - Description: Go back to the previous page
+  - Description: Autonomously navigate back to the previous page in browser history
   - Parameters: None
   - Read-only: **true**
 
@@ -666,7 +740,7 @@ X Y coordinate space, based on the provided screenshot.
 
 - **browser_navigate_forward**
   - Title: Go forward
-  - Description: Go forward to the next page
+  - Description: Autonomously navigate forward to the next page in browser history
   - Parameters: None
   - Read-only: **true**
 
@@ -678,8 +752,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_take_screenshot**
-  - Title: Take a screenshot
-  - Description: Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.
+  - Title: Autonomous screenshot capture
+  - Description: Autonomously take visual screenshots of the current page or specific elements. Use browser_snapshot for structured page data instead of visual screenshots.
   - Parameters:
     - `raw` (boolean, optional): Whether to return without compression (in PNG format). Default is false, which returns a JPEG image.
     - `filename` (string, optional): File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified.
@@ -690,8 +764,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_pdf_save**
-  - Title: Save as PDF
-  - Description: Save page as PDF
+  - Title: Autonomous PDF generation
+  - Description: Autonomously save the current web page as a PDF document for archival or sharing
   - Parameters:
     - `filename` (string, optional): File name to save the pdf to. Defaults to `page-{timestamp}.pdf` if not specified.
   - Read-only: **true**
@@ -699,16 +773,16 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_network_requests**
-  - Title: List network requests
-  - Description: Returns all network requests since loading the page
+  - Title: Autonomous network monitoring
+  - Description: Autonomously capture and analyze all network requests made since page load for debugging
   - Parameters: None
   - Read-only: **true**
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_console_messages**
-  - Title: Get console messages
-  - Description: Returns all console messages
+  - Title: Autonomous console monitoring
+  - Description: Autonomously retrieve all browser console messages for debugging and analysis
   - Parameters: None
   - Read-only: **true**
 
@@ -720,24 +794,24 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_install**
-  - Title: Install the browser specified in the config
-  - Description: Install the browser specified in the config. Call this if you get an error about the browser not being installed.
+  - Title: Autonomous browser installation
+  - Description: Autonomously install the required browser engine specified in configuration. Use this to resolve browser installation errors.
   - Parameters: None
   - Read-only: **false**
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_close**
-  - Title: Close browser
-  - Description: Close the page
+  - Title: Autonomous browser closure
+  - Description: Autonomously close the browser session and terminate all operations
   - Parameters: None
   - Read-only: **true**
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_resize**
-  - Title: Resize browser window
-  - Description: Resize the browser window
+  - Title: Autonomous window resizing
+  - Description: Autonomously resize the browser window to specific dimensions for optimal viewing
   - Parameters:
     - `width` (number): Width of the browser window
     - `height` (number): Height of the browser window
@@ -751,16 +825,16 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_tab_list**
-  - Title: List tabs
-  - Description: List browser tabs
+  - Title: Autonomous tab listing
+  - Description: Autonomously list all open browser tabs and their current status
   - Parameters: None
   - Read-only: **true**
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_tab_new**
-  - Title: Open a new tab
-  - Description: Open a new tab
+  - Title: Autonomous new tab creation
+  - Description: Autonomously open a new browser tab, optionally navigating to a specified URL
   - Parameters:
     - `url` (string, optional): The URL to navigate to in the new tab. If not provided, the new tab will be blank.
   - Read-only: **true**
@@ -768,8 +842,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_tab_select**
-  - Title: Select a tab
-  - Description: Select a tab by index
+  - Title: Autonomous tab selection
+  - Description: Autonomously select and switch to a specific browser tab by index
   - Parameters:
     - `index` (number): The index of the tab to select
   - Read-only: **true**
@@ -777,8 +851,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_tab_close**
-  - Title: Close a tab
-  - Description: Close a tab
+  - Title: Autonomous tab closure
+  - Description: Autonomously close a browser tab by index, or close the current tab if no index specified
   - Parameters:
     - `index` (number, optional): The index of the tab to close. Closes current tab if not provided.
   - Read-only: **false**
@@ -786,42 +860,42 @@ X Y coordinate space, based on the provided screenshot.
 </details>
 
 <details>
-<summary><b>Work Profiles</b></summary>
+<summary><b>Session States</b></summary>
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_save_profile**
-  - Title: Save Work Profile
-  - Description: Save the current browser state as a work profile
+  - Title: Save session state
+  - Description: Save the current browser session state (cookies, localStorage, URL) for later restoration. Includes Edge profile and VS Code workspace context.
   - Parameters:
-    - `name` (string): Name for the work profile
-    - `description` (string, optional): Optional description for the work profile
+    - `name` (string): Name for the session state
+    - `description` (string, optional): Optional description for the session state
   - Read-only: **false**
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_switch_profile**
-  - Title: Switch Work Profile
-  - Description: Switch to a saved work profile
+  - Title: Restore session state
+  - Description: Restore a previously saved session state, including cookies, localStorage, and navigate to the saved URL
   - Parameters:
-    - `name` (string): Name of the work profile to switch to
+    - `name` (string): Name of the session state to restore
   - Read-only: **false**
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_list_profiles**
-  - Title: List Work Profiles
-  - Description: List all saved work profiles
+  - Title: List session states
+  - Description: List all saved Darbot session states with their Edge profile context and workspace information
   - Parameters: None
   - Read-only: **true**
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_delete_profile**
-  - Title: Delete Work Profile
-  - Description: Delete a saved work profile
+  - Title: Delete session state
+  - Description: Permanently delete a saved session state from storage
   - Parameters:
-    - `name` (string): Name of the work profile to delete
+    - `name` (string): Name of the session state to delete
   - Read-only: **false**
 
 </details>
@@ -832,8 +906,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_generate_playwright_test**
-  - Title: Generate a Playwright test
-  - Description: Generate a Playwright test for given scenario
+  - Title: Autonomous test generation
+  - Description: Autonomously generate Playwright test code for browser automation scenarios and user workflows
   - Parameters:
     - `name` (string): The name of the test
     - `description` (string): The description of the test
@@ -901,8 +975,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_press_key**
-  - Title: Press a key
-  - Description: Press a key on the keyboard
+  - Title: Autonomous keyboard input
+  - Description: Autonomously press keys on the keyboard to interact with the web page
   - Parameters:
     - `key` (string): Name of the key to press or a character to generate, such as `ArrowLeft` or `a`
   - Read-only: **false**
@@ -910,8 +984,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_wait_for**
-  - Title: Wait for
-  - Description: Wait for text to appear or disappear or a specified time to pass
+  - Title: Autonomous wait conditions
+  - Description: Autonomously wait for specific conditions: text appearance, text disappearance, or time duration
   - Parameters:
     - `time` (number, optional): The time to wait in seconds
     - `text` (string, optional): The text to wait for
@@ -921,8 +995,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_file_upload**
-  - Title: Upload files
-  - Description: Upload one or multiple files
+  - Title: Autonomous file upload
+  - Description: Autonomously upload one or multiple files when a file chooser dialog appears
   - Parameters:
     - `paths` (array): The absolute paths to the files to upload. Can be a single file or multiple files.
   - Read-only: **false**
@@ -930,8 +1004,8 @@ X Y coordinate space, based on the provided screenshot.
 <!-- NOTE: This has been generated via update-readme.js -->
 
 - **browser_handle_dialog**
-  - Title: Handle a dialog
-  - Description: Handle a dialog
+  - Title: Autonomous dialog handling
+  - Description: Autonomously handle browser dialog boxes (alerts, confirmations, prompts)
   - Parameters:
     - `accept` (boolean): Whether to accept the dialog.
     - `promptText` (string, optional): The text of the prompt in case of a prompt dialog.
@@ -945,29 +1019,46 @@ X Y coordinate space, based on the provided screenshot.
 ## Package Formats
 
 ### NPM Package
+
 - **Name**: `@darbotlabs/darbot-browser-mcp`
 - **Installation**: `npm install -g @darbotlabs/darbot-browser-mcp`
 - **Usage**: `npx @darbotlabs/darbot-browser-mcp@latest`
 
 ### VS Code Extension
+
 - **Name**: Darbot Browser MCP
 - **Publisher**: darbotlabs
 - **Installation**: Search for "Darbot Browser MCP" in VS Code Extensions marketplace
 - **Features**: Start/stop MCP server, status monitoring, configuration management
 
 ### NuGet Package (.NET)
+
 - **Name**: `DarbotLabs.Browser.MCP`
 - **Installation**: `dotnet add package DarbotLabs.Browser.MCP`
 - **Usage**: Host the Browser MCP server in .NET applications
 
 ### Browser Extension
+
 - **Name**: Browser MCP Bridge
 - **Installation**: Available in Chrome Web Store (coming soon)
 - **Features**: Share browser tabs with MCP server via CDP bridge
 
 ## Repository Structure
+
 - `/vscode-extension/` - VS Code extension source
 - `/dotnet/` - .NET NuGet package source
 - `/extension/` - Browser extension source
 - `/src/` - Main MCP server source code
 - `/tests/` - Test suite
+
+## Autonomous Features
+
+For detailed information about the autonomous crawling capabilities, including memory system, BFS planner, guardrails, and reporting, see [AUTONOMOUS_FEATURES.md](./AUTONOMOUS_FEATURES.md).
+
+**Key Autonomous Capabilities:**
+
+- Intelligent BFS crawling with memory and state tracking
+- Darbot-memory-mcp integration for persistent memory  
+- HTML report generation with screenshots and statistics
+- Configurable domain filtering and safety policies
+