Open WebBridge

https://github.com/zhizuzhefu/open-webbridge
Admin
Open WebBridge is a local tool that lets an AI agent operate your real Chrome browser, performing...
Tokens:14,029
Snippets:146
Trust Score:4.6
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install Open WebBridge

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/references/operations.md

Install the release binary using the official installer script. This is the first step if the command is not found.

```bash
curl -fsSL https://raw.githubusercontent.com/zhizuzhefu/open-webbridge/main/scripts/install.sh | bash
```

--------------------------------

### Print the version

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Displays the currently installed version of the open-webbridge service.

```bash
open-webbridge version
```

--------------------------------

### Install Open WebBridge Background Service

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Installs the prebuilt binary for the Open WebBridge service. Add the program to your PATH for convenience.

```bash
curl -fsSL https://raw.githubusercontent.com/zhizuzhefu/open-webbridge/main/scripts/install.sh | bash
```

```bash
export PATH="$PATH:$HOME/.open-webbridge/bin"
```

--------------------------------

### Install Latest Open-WebBridge Version

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Installs the latest version of Open-WebBridge and restarts the service. This is the primary command for updating the service.

```bash
open-webbridge update             # install the latest version and restart
```

--------------------------------

### Build and Package Extension

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-extension/STORE.md

Builds the minified extension and creates a zip archive for upload. Ensure you are in the correct directory and have installed dependencies.

```bash
cd open-webbridge-extension
npm install
npm run build                         # → dist/  (bundled + minified)
( cd dist && zip -r ../open-webbridge-extension.zip . )   # manifest.json at the zip root
```

--------------------------------

### Start the background service

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Initiates the open-webbridge background service. Use --host and --port to specify the network binding, which are saved in the configuration.

```bash
open-webbridge start [--host H] [--port N]
```

--------------------------------

### Start Open WebBridge Daemon

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/references/operations.md

Start the Open WebBridge daemon if it is not running. This command is used when the status indicates the daemon is stopped.

```bash
open-webbridge start
```

--------------------------------

### Record Network Activity

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Start network recording, navigate to a URL, and then list network requests filtered by API calls.

```bash
open-webbridge call network --session net --args '{"cmd":"start"}'
open-webbridge call navigate --session net --args '{"url":"https://example.com"}'
open-webbridge call network --session net --args '{"cmd":"list","filter":"api"}'
```

--------------------------------

### Navigate and Snapshot a Webpage

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Example of opening a URL in a new tab within a specific session and then taking a snapshot of the page. Ensure the session name is consistent for related actions.

```bash
open-webbridge call navigate --session research --args '{"url":"https://example.com","newTab":true}'
```

```bash
open-webbridge call snapshot --session research
```

--------------------------------

### Build Open WebBridge Browser Extension

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Builds the Open WebBridge browser extension from source. This is part of the manual installation process.

```bash
cd open-webbridge-extension
npm install
npm run build          # produces the dist/ folder
```

--------------------------------

### Running Open WebBridge by Full Path

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

If the 'command not found' error occurs, the service might not be installed or its directory is not on your PATH. Try running the command using its full path.

```bash
~/.open-webbridge/bin/open-webbridge
```

--------------------------------

### Remove Agent Skill Directory (Example)

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

If the agent skill was installed, use this command to remove its directory. The path may vary based on your installation.

```bash
~/.claude/skills/open-webbridge
```

--------------------------------

### Get the connection link for the extension

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Retrieves and prints the connection URL, including the access token, required for the browser extension to connect to the service.

```bash
open-webbridge url
```

--------------------------------

### Open-WebBridge Daily Operations

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/references/operations.md

Common commands for managing the Open-WebBridge daemon, such as checking status, starting, stopping, restarting, and retrieving logs or connection URLs.

```bash
open-webbridge status
```

```bash
open-webbridge start
```

```bash
open-webbridge stop
```

```bash
open-webbridge restart
```

```bash
open-webbridge logs -n 100
```

```bash
open-webbridge logs -f
```

```bash
open-webbridge url
```

```bash
open-webbridge token
```

--------------------------------

### Resolving Port Conflicts

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

If 'start' reports the address is in use, another program is using the port. You can change the 'port' in 'config.json' or free the port.

```json
{
  "port": 8080 
}
```

--------------------------------

### Remote Automation Calls to Open-WebBridge

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/references/operations.md

Examples of making calls to a remote Open-WebBridge daemon using the 'call' command. You can specify the daemon URL and token directly or via environment variables.

```bash
open-webbridge call snapshot --session work \
  --daemon http://<machine-A-ip>:9234 --token <token-from-A>
```

```bash
export OWB_DAEMON=http://<machine-A-ip>:9234 OWB_TOKEN=<token>
open-webbridge call navigate --session work --args '{"url":"https://example.com","newTab":true}'
```

--------------------------------

### Get All Cookies for a Domain

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Retrieves all cookies for a specified domain and its subdomains across the entire browser profile. Requires the 'all' command.

```bash
open-webbridge call cookies --session goofish --args '{"cmd":"all","domain":"goofish.com"}'
```

--------------------------------

### Get Open WebBridge Connection URL

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/references/operations.md

Retrieve the connection URL for the Open WebBridge extension. This URL includes the authentication token and is used for the initial connection.

```bash
open-webbridge url
# ws://127.0.0.1:9234/ws?token=<hex>
```

--------------------------------

### Get Cookies for Active Tab

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Retrieves cookies for the currently active tab. This is the default command for the cookies function.

```bash
open-webbridge call cookies --session goofish
```

--------------------------------

### Scope Cookie Retrieval to Specific Origins

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Retrieves cookies scoped to specific origins using the 'get' command. Useful for targeting cookies for particular URLs.

```bash
open-webbridge call cookies --session goofish --args '{"urls":["https://h5api.m.goofish.com"]}'
```

--------------------------------

### Fixing macOS Binary Signature Issues

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

On macOS, if you encounter 'killed: 9' or 'cannot be opened', the binary may have lost its signature. Re-run the installer or fix it manually by removing quarantine attributes and re-signing the binary.

```bash
xattr -dr com.apple.quarantine ~/.open-webbridge/bin/open-webbridge && codesign --force --sign - ~/.open-webbridge/bin/open-webbridge
```

--------------------------------

### Show usage information

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Displays the help message and usage instructions for the open-webbridge command-line tool.

```bash
open-webbridge help
```

--------------------------------

### Call command options explained

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Details the options available for the 'call' command, including specifying the session, arguments, and remote daemon/token.

```bash
open-webbridge call <action> [--session NAME] [--args '<json>'] [json] 
                             [--daemon URL] [--token TOKEN]
```

--------------------------------

### Fill and Submit Form

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Navigate to a login page, take a snapshot to identify element selectors, fill in user credentials, and click the submit button.

```bash
open-webbridge call navigate --session form --args '{"url":"https://example.com/login","newTab":true}'
open-webbridge call snapshot --session form          # find the field/button references
open-webbridge call fill  --session form --args '{"selector":"@e3","value":"my-user"}'
open-webbridge call fill  --session form --args '{"selector":"@e4","value":"secret"}'
open-webbridge call click --session form --args '{"selector":"@e5"}'
```

--------------------------------

### General open-webbridge Command Form

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

The basic structure for using the open-webbridge command-line tool. Replace <command> with a specific action and [options] with relevant flags.

```bash
open-webbridge <command> [options]
```

--------------------------------

### Read Page Title

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Navigate to a URL, take a snapshot, evaluate the document title, and close the session.

```bash
open-webbridge call navigate --session demo --args '{"url":"https://example.com","newTab":true}'
open-webbridge call snapshot --session demo
open-webbridge call evaluate --session demo --args '{"code":"document.title"}'
open-webbridge call close_session --session demo
```

--------------------------------

### Inspecting Recent Logs for Timeouts

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

If tool calls time out, inspect recent activity using 'open-webbridge logs -n 100'. A page that never finishes loading can stall navigation.

```bash
open-webbridge logs -n 100
```

--------------------------------

### List All Tab Limits

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Displays all currently configured per-domain tab limits.

```bash
open-webbridge tablimit list
```

--------------------------------

### Bind Open-WebBridge for Remote Access

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/references/operations.md

Commands to expose the /command HTTP endpoint for remote automation. Use 'bind local' to revert to local-only access.

```bash
open-webbridge bind remote
```

```bash
open-webbridge token
```

```bash
open-webbridge bind local
```

--------------------------------

### Open-Webbridge Configuration Fields

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

The config.json file contains fields for network binding, port, access token, and auto-update settings.

```json
{
  "host": "127.0.0.1",
  "port": 9234,
  "token": "generated",
  "auto_update": false
}
```

--------------------------------

### Print the access token

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Displays the secret access token used for authenticating with the open-webbridge service.

```bash
open-webbridge token
```

--------------------------------

### Inspect and Emulate

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Actions for inspecting network activity, cookies, and emulating device properties.

```APIDOC
## network

### Description
Manages and inspects network activity.

### Arguments
- `cmd` (string, required): The command to execute (`start`, `stop`, `list`, `detail`).
- `filter` (string, optional): A filter string for `list` command.
- `requestId` (string, optional): The ID of a request for the `detail` command.

### Returns
- request/response data: Depending on the command, returns network request/response details.
```

```APIDOC
## cookies

### Description
Retrieves browser cookies.

### Arguments
- `cmd` (string, optional): The command to execute (`get` or `all`). Defaults to `get`.
- `domain` (string, optional): Filters cookies by domain.
- `urls` (array of strings, optional): Origins to filter cookies for the `get` command.

### Returns
- `{ count, cookies, header }`: An object containing the cookie count, an array of cookie objects, and a formatted `Cookie:` header string. Includes HttpOnly cookies.
```

```APIDOC
## emulate

### Description
Emulates device properties like user agent, geolocation, and screen size.

### Arguments
- `device` (object): Device properties like `{ width, height, deviceScaleFactor, mobile }`.
- `userAgent` (string): The user agent string to emulate.
- `geolocation` (object): Geolocation coordinates `{ latitude, longitude, accuracy }`.
- `clear` (bool): Whether to clear emulation settings.

### Returns
- `{ applied }`: A boolean indicating if the emulation settings were applied.
```

--------------------------------

### Show service logs

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Displays recent log entries from the open-webbridge service. Use -n N to specify the number of lines and -f to follow the log in real-time.

```bash
open-webbridge logs [-n N] [-f]
```

--------------------------------

### Emulation and Download Management

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Tools for emulating devices, user agents, and geolocation, as well as managing downloads.

```APIDOC
## emulate

### Description
Emulates specific device characteristics, user agents, or geolocation.

### Args
- **device** {width, height, deviceScaleFactor, mobile} - Emulates a specific device.
OR
- **userAgent** (string) - Emulates a specific user agent string.
OR
- **geolocation** {latitude, longitude, accuracy} - Emulates a specific geolocation.
OR
- **clear** (boolean) - If true, clears all active emulations.

### Returns
- **{applied}** - A boolean indicating if the emulation was applied successfully.
```

```APIDOC
## download

### Description
Manages native browser downloads, allowing to start, list, or cancel them.

### Args
- **cmd** (string) - The command to execute ('start', 'list', 'cancel').
- **url** (string) - Required for 'start' command. The URL of the file to download.
- **id** (string) - Required for 'cancel' command. The ID of the download to cancel.
- **limit** (number) - Optional. Limits the number of downloads to list.

### Returns
- **{downloads:[{id,url,filename,state,bytesReceived,totalBytes}]}** - An object containing an array of download objects with their details.
```

--------------------------------

### Restart the background service

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Restarts the open-webbridge background service.

```bash
open-webbridge restart
```

--------------------------------

### Set network binding and restart service

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Configures the network binding for the open-webbridge service to either 'local' (loopback) or 'remote' (0.0.0.0) and restarts the service. Refer to the Remote operation section for more details.

```bash
open-webbridge bind <host> [--port N]
```

--------------------------------

### Call Open WebBridge Actions

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Use this command format for all browser interactions. Specify the action, an optional session name for tab grouping, and arguments as a JSON object.

```bash
open-webbridge call <action> --session <name> --args '<json>'
```

--------------------------------

### Capture Page as PDF

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Navigate to a report URL and save the page content as a PDF file with a specified format and name.

```bash
open-webbridge call navigate    --session cap --args '{"url":"https://example.com/report","newTab":true}'
open-webbridge call save_as_pdf --session cap --args '{"paper_format":"a4","file_name":"report"}'
```

--------------------------------

### Secure Remote Access with SSH Tunnel

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/references/operations.md

Demonstrates setting up an SSH tunnel for secure, encrypted communication with a remote Open-WebBridge daemon when on untrusted networks. This avoids the need for 'bind remote'.

```bash
ssh -L 9234:127.0.0.1:9234 userA@machineA
```

```bash
OWB_DAEMON=http://127.0.0.1:9234 OWB_TOKEN=<token> open-webbridge call ...
```

--------------------------------

### Open-Webbridge Directory Structure

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

All data for Open-Webbridge is stored under the ~/.open-webbridge/ directory, including the service binary, configuration, logs, and saved files.

```text
~/.open-webbridge/
├── bin/open-webbridge      the service / command-line program
├── config.json             configuration (permissions 0600)
├── daemon.pid              process id of the running service
├── logs/daemon.log         activity log
└── files/                  saved screenshots and PDFs
```

--------------------------------

### Run Parallel Jobs

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Initiate two separate navigation tasks concurrently by assigning them distinct session names.

```bash
open-webbridge call navigate --session research --args '{"url":"https://news.example","newTab":true}'
open-webbridge call navigate --session filing   --args '{"url":"https://admin.example","newTab":true}'
```

--------------------------------

### Check for Open-WebBridge Updates

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Reports whether a newer version of Open-WebBridge is available. Use this command to proactively check for updates.

```bash
open-webbridge update --check     # report whether a newer version is available
```

--------------------------------

### Perform a browser action

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Executes a specified browser action. Arguments can be provided as a JSON string or a trailing JSON object.

```bash
open-webbridge call <action> [--session NAME] [--args '<json>'] [json] [--daemon URL] [--token TOKEN]
```

--------------------------------

### Update the service to the latest release

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Updates the open-webbridge service to the newest version. Use --check to only verify availability or --force to bypass checks.

```bash
open-webbridge update [--check] [--force]
```

--------------------------------

### Bind and Operate Open-Webbridge Remotely

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

On the machine running Chrome, bind the command endpoint to all interfaces, note the access token, and then revert to local-only when finished.

```bash
# On the machine running Chrome:
open-webbridge bind remote      # bind the command endpoint to all interfaces
open-webbridge token            # note the access token
open-webbridge bind local       # revert to local-only when finished
```

--------------------------------

### Call Remote Open-Webbridge Service

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

From another machine, direct 'call' at the remote service using the host and token.

```bash
open-webbridge call snapshot --session work \
  --daemon http://<remote-host>:9234 --token <token>
```

--------------------------------

### Manage Per-Domain Rate Limits

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Commands to view, clear, or clear all configured per-domain rate limits.

```bash
open-webbridge ratelimit list            # show current limits
```

```bash
open-webbridge ratelimit clear douyin.com   # remove one
```

```bash
open-webbridge ratelimit clear --all        # remove all
```

--------------------------------

### Rebuilding and Reloading Browser Extension

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

If the extension card shows an error after loading, rebuild the extension using 'npm run build' and then reload it in 'chrome://extensions'.

```bash
npm run build
```

--------------------------------

### Capture

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Actions for capturing screenshots and saving pages as PDFs.

```APIDOC
## screenshot

### Description
Captures a screenshot of the current page or a specific element.

### Arguments
- `format` (string): The image format (`png` or `jpeg`).
- `quality` (number, optional): The quality setting (0-100) for JPEG format.
- `selector` (string, optional): CSS selector or `@eN` reference to capture only a specific element.

### Returns
- `{ path, format, sizeBytes }`: Information about the saved screenshot, including path, format, and size.
```

```APIDOC
## save_as_pdf

### Description
Saves the current page as a PDF document.

### Arguments
- `paper_format` (string): The paper format (`letter`, `a4`, `legal`, `a3`, `tabloid`).
- `landscape` (bool, optional): Whether to save in landscape orientation.
- `scale` (number, optional): The scaling factor for the PDF content (0.1-2.0).
- `print_background` (bool, optional): Whether to print background graphics.
- `file_name` (string, optional): The name of the output PDF file.

### Returns
- `{ path, sizeBytes }`: Information about the saved PDF, including path and size.
```

--------------------------------

### File and Network Tools

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Tools for saving pages as PDFs, managing network requests, and handling cookies.

```APIDOC
## save_as_pdf

### Description
Saves the current page as a PDF file.

### Args
- **paper_format** (string) - The paper format (e.g., 'A4').
- **landscape** (boolean) - Whether to save in landscape orientation.
- **scale** (number) - The scale factor for the PDF.
- **print_background** (boolean) - Whether to print background graphics.
- **file_name** (string) - The name of the output PDF file.

### Returns
- **{path, sizeBytes}** - An object containing the path to the saved PDF and its size in bytes.
```

```APIDOC
## network

### Description
Manages network requests, allowing to start, stop, list, or get details of network activity.

### Args
- **cmd** (string) - The command to execute ('start', 'stop', 'list', 'detail').
- **filter** (object) - Optional. Filters for network requests.
- **requestId** (string) - Optional. The ID of a specific network request.

### Returns
- **request/response data** - The data related to the network activity based on the command.
```

```APIDOC
## cookies

### Description
Retrieves or manages cookies, including HttpOnly cookies.

### Args
- **cmd** (string) - The command to execute ('get', 'all').
- **domain** (string) - Optional. Filters cookies by domain.
- **urls** (string[]) - Optional. Used with 'get' command to specify URLs for which to retrieve cookies.

### Returns
- **{count, cookies:[{name,value,domain,path,expires,session,httpOnly,secure,sameSite}], header}** - An object containing the count of cookies, an array of cookie objects, and header information. Reads HttpOnly cookies.
```

--------------------------------

### Navigation and Tabs

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Actions related to browser navigation, tab management, and session handling.

```APIDOC
## navigate

### Description
Navigates the browser to a specified URL. Can open in a new tab and assign a group title.

### Arguments
- `url` (string, required): The URL to navigate to.
- `newTab` (bool, optional): Whether to open the URL in a new tab.
- `group_title` (string, optional): The title for the tab group.

### Returns
- `{ url, tabId, title }`: An object containing the URL, tab ID, and title of the navigated tab.
```

```APIDOC
## find_tab

### Description
Finds an existing browser tab based on its URL or domain.

### Arguments
- `url` (string, required): The URL or domain to search for.
- `active` (bool, optional): Whether to consider only active tabs.

### Returns
- `{ url, tabId }`: An object containing the URL and tab ID of the found tab.
```

```APIDOC
## list_tabs

### Description
Lists all currently open browser tabs.

### Arguments
- None

### Returns
- `{ tabs: [ { tabId, url, title, active, groupTitle } ] }`: An array of tab objects, each containing details like tab ID, URL, title, active status, and group title.
```

```APIDOC
## list_sessions

### Description
Lists all active browser sessions, including orphaned ones.

### Arguments
- None

### Returns
- `{ sessions: [ { session, groupId, color, tabCount, orphaned } ] }`: An array of session objects, each with session details, group ID, color, tab count, and an orphaned flag.
```

```APIDOC
## activate_tab

### Description
Activates a specified browser tab.

### Arguments
- `tabId` (number, optional): The ID of the tab to activate. If not provided, the currently active tab is used.

### Returns
- `{ tabId }`: The ID of the activated tab.
```

```APIDOC
## close_tab

### Description
Closes the currently active browser tab.

### Arguments
- None

### Returns
- `{ closed }`: A boolean indicating if the tab was closed.
```

```APIDOC
## close_session

### Description
Closes a browser session associated with a specific group ID.

### Arguments
- `groupId` (number, optional): The ID of the group to close. If not provided, the current session is closed.

### Returns
- `{ closed }`: A boolean indicating if the session was closed.
```

--------------------------------

### Dialog and Tab Management Tools

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Tools for handling native dialogs (alerts, confirms, prompts) and managing browser tabs and sessions.

```APIDOC
## dialog

### Description
Handles native dialogs (alert, confirm, prompt) that appear in the browser.

### Args
- **action** (string) - The action to perform ('accept' or 'dismiss').
- **promptText** (string) - Optional. The text to enter in a prompt dialog.
OR
- **cmd** (string) - Set to 'list' to see any active dialogs.

### Returns
- **{policy}** - Indicates the policy applied to the dialog.
OR
- **{dialogs}** - A list of active dialogs when `cmd:"list"` is used.
```

```APIDOC
## list_tabs

### Description
Lists all currently open tabs in the browser.

### Args
- None

### Returns
- **{tabs:[{tabId,url,title,active,groupTitle}]}** - An object containing an array of tab objects, each with its ID, URL, title, active state, and group title.
```

```APIDOC
## list_sessions

### Description
Lists all tab groups (sessions) in the browser, including orphaned ones.

### Args
- None

### Returns
- **{sessions:[{session,groupId,color,tabCount,orphaned}]}** - An object containing an array of session objects, detailing their group ID, color, tab count, and orphaned status.
```

```APIDOC
## activate_tab

### Description
Brings a specified tab to the foreground.

### Args
- **tabId** (string) - Optional. The ID of the tab to activate. If not provided, the active tab is activated.

### Returns
- **{tabId}** - The ID of the activated tab.
```

```APIDOC
## close_tab

### Description
Closes the currently active tab.

### Args
- None

### Returns
- **{closed}** - A boolean indicating if the tab was closed.
```

```APIDOC
## close_session

### Description
Closes all tabs within a specific session (tab group) or all orphaned tabs.

### Args
- **groupId** (string) - Optional. The group ID of the session to close. If not provided, all orphaned tabs are closed.

### Returns
- **{closed}** - A boolean indicating if the session/tabs were closed.
```

--------------------------------

### Browser Navigation Tools

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Tools for navigating the browser, opening new tabs, and finding existing tabs.

```APIDOC
## navigate

### Description
Navigates to a specified URL. Can open the URL in a new tab.

### Args
- **url** (string) - The URL to navigate to.
- **newTab** (boolean) - Optional. If true, opens the URL in a new tab. Defaults to false.
- **group_title** (string) - Optional. The title of the tab group to open the URL in.

### Returns
- **{url, tabId, title}** - An object containing the URL, tab ID, and title of the navigated tab.
```

```APIDOC
## find_tab

### Description
Finds an existing tab that matches the given URL or domain. Can optionally activate the tab.

### Args
- **url** (string) - The URL or domain to search for.
- **active** (boolean) - Optional. If true, activates the found tab. Defaults to false.

### Returns
- **{url, tabId}** - An object containing the URL and tab ID of the found tab.
```

--------------------------------

### Stop the background service

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Terminates the running open-webbridge background service.

```bash
open-webbridge stop
```

--------------------------------

### Updating Element References

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

If a call returns 'unknown element ref …', the page has changed since the last snapshot. Take a fresh snapshot and use the new references.

```bash
snapshot
```

--------------------------------

### Interaction

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Actions for interacting with elements on a web page.

```APIDOC
## click

### Description
Simulates a click action on a specified element.

### Arguments
- `selector` (string, required): CSS selector or `@eN` reference to the element.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ tag, text, method }`: Information about the clicked element.
```

```APIDOC
## fill

### Description
Fills an input element with a specified value, replacing existing content.

### Arguments
- `selector` (string, required): CSS selector or `@eN` reference to the input element.
- `value` (string, required): The value to fill into the input.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ mode, tag }`: Information about the filled element and the mode of operation.
```

```APIDOC
## hover

### Description
Simulates a hover action over a specified element or coordinates.

### Arguments
- `selector` (string): CSS selector or `@eN` reference to the element, OR `x` and `y` coordinates.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ success }`: A boolean indicating if the hover action was successful.
```

```APIDOC
## scroll

### Description
Scrolls to a specified element or coordinates.

### Arguments
- `selector` (string): CSS selector or `@eN` reference to the element, OR `x` and `y` coordinates.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ success, mode }`: A boolean indicating success and the scroll mode.
```

```APIDOC
## press_key

### Description
Simulates a key press event.

### Arguments
- `key` (string, required): The key to press (e.g., `Enter`, `Tab`, `ArrowDown`, or a single character).
- `selector` (string, optional): CSS selector or `@eN` reference to an element to focus before pressing the key.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ key }`: The key that was pressed.
```

```APIDOC
## select_option

### Description
Selects an option from a select element.

### Arguments
- `selector` (string, required): CSS selector or `@eN` reference to the select element.
- `value` (string): The value of the option to select.
- `label` (string): The label of the option to select.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ value }`: The value of the selected option.
```

```APIDOC
## drag

### Description
Simulates a drag-and-drop action.

### Arguments
- `from` (string, required): CSS selector or `@eN` reference for the starting element.
- `to` (string, required): CSS selector or `@eN` reference for the target element.
- OR `fromX`, `fromY`, `toX`, `toY` coordinates.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ from, to }`: Information about the drag operation's start and end points.
```

```APIDOC
## tap

### Description
Simulates a tap action on a specified element or coordinates, typically for touch devices.

### Arguments
- `selector` (string): CSS selector or `@eN` reference to the element, OR `x` and `y` coordinates.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ point, mode }`: Information about the tap action, including coordinates and mode.
```

```APIDOC
## upload

### Description
Uploads files to a file input element.

### Arguments
- `selector` (string, required): CSS selector or `@eN` reference to the file input element.
- `files` (array of strings, required): An array of absolute paths to the files to upload.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ fileCount }`: The number of files uploaded.
```

--------------------------------

### Check Open WebBridge Status

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/references/operations.md

Check the current status of the Open WebBridge daemon and its connection to the extension. This is useful for diagnosing issues.

```bash
open-webbridge status
```

--------------------------------

### Set Per-Domain Navigation Rate Limit

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Configure a rate limit for a specific domain to control navigation frequency. The limit applies to the domain and its subdomains.

```bash
# at most 1 navigation to xiaohongshu.com (and its subdomains) every 5s
open-webbridge ratelimit set xiaohongshu.com --per 5
```

```bash
# at most 1 navigation to douyin.com every 10s
open-webbridge ratelimit set douyin.com --per 10 --max 1
```

--------------------------------

### Status command result fields

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Defines the fields returned by the 'status' command and their meanings, covering service state, network binding, version, and extension connection status.

```bash
status result fields:
running
host, port
remote
version
extension_connected
extension_version
extension_compatible
uptime_seconds
```

--------------------------------

### Reading a Page

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

Actions for capturing page content and executing JavaScript.

```APIDOC
## snapshot

### Description
Captures a snapshot of the current page, including its URL, title, and DOM tree.

### Arguments
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ url, title, frame, refCount, tree }`: An object containing page snapshot details.
```

```APIDOC
## evaluate

### Description
Executes JavaScript code within the page and returns its serializable result.

### Arguments
- `code` (string, required): The JavaScript code to execute.
- `frame` (string, optional): Identifier for a specific frame within the page.

### Returns
- `{ type, value }`: An object containing the type and value of the execution result.
```

```APIDOC
## frames

### Description
Retrieves information about all frames within the current tab.

### Arguments
- None

### Returns
- `{ tabId, count, frames: [ { targetId, type, url, title, attached } ] }`: An object detailing the tab ID, frame count, and an array of frame objects.
```

--------------------------------

### Element Interaction Tools

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Tools for interacting with elements on a web page, such as clicking, filling forms, and scrolling.

```APIDOC
## snapshot

### Description
Takes a snapshot of the current page, returning an accessibility outline with element references.

### Args
- None

### Returns
- **{url, title, tree, refCount}** - An object containing the page URL, title, an indented accessibility outline, and reference counts. Use this to read pages and target elements.
```

```APIDOC
## click

### Description
Simulates a click on a specified element.

### Args
- **selector** (string) - The CSS selector or `@e<N>` reference of the element to click.

### Returns
- **{tag, text, method}** - An object containing the tag name, text content, and method used for the click.
```

```APIDOC
## fill

### Description
Clears and fills an input field or contenteditable element.

### Args
- **selector** (string) - The CSS selector or `@e<N>` reference of the element to fill.
- **value** (string) - The value to insert into the element.

### Returns
- **{mode, tag}** - An object indicating the mode of operation and the tag name of the element.
```

```APIDOC
## hover

### Description
Simulates a hover effect on a specified element.

### Args
- **selector** (string) - The CSS selector or `@e<N>` reference of the element to hover over.

### Returns
- **{success}** - A boolean indicating if the hover action was successful.
```

```APIDOC
## scroll

### Description
Scrolls the page to a specific element or coordinates.

### Args
- **selector** (string) - The CSS selector or `@e<N>` reference of the element to scroll to.
OR
- **x** (number) - The x-coordinate to scroll to.
- **y** (number) - The y-coordinate to scroll to.

### Returns
- **{success}** - A boolean indicating if the scroll action was successful.
```

```APIDOC
## press_key

### Description
Simulates a key press on the page or a specific element.

### Args
- **key** (string) - The key to press (e.g., Enter, Tab, Escape, ArrowUp, or a single character).
- **selector** (string) - Optional. The CSS selector or `@e<N>` reference of the element to target. If not provided, the key press is applied to the document.

### Returns
- **{key}** - An object containing the key that was pressed.
```

```APIDOC
## select_option

### Description
Selects an option from a dropdown or select element.

### Args
- **selector** (string) - The CSS selector or `@e<N>` reference of the select element.
- **value** (string) OR **label** (string) - The value or label of the option to select.

### Returns
- **{value}** - An object containing the value of the selected option.
```

```APIDOC
## drag

### Description
Simulates a drag-and-drop action.

### Args
- **from** (string) - The CSS selector or `@e<N>` reference of the element to drag.
- **to** (string) - The CSS selector or `@e<N>` reference of the drop target.
OR
- **fromX** (number) - The starting x-coordinate.
- **fromY** (number) - The starting y-coordinate.
- **toX** (number) - The ending x-coordinate.
- **toY** (number) - The ending y-coordinate.

### Returns
- **{from, to}** - An object containing the starting and ending points of the drag action.
```

```APIDOC
## tap

### Description
Simulates a touch tap action on the screen.

### Args
- **selector** (string) - Optional. The CSS selector or `@e<N>` reference of the element to tap.
OR
- **x** (number) - The x-coordinate to tap.
- **y** (number) - The y-coordinate to tap.

### Returns
- **{point}** - An object containing the coordinates of the tap.
```

--------------------------------

### Content Evaluation and Screenshot Tools

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Tools for evaluating JavaScript code within the page context and capturing screenshots.

```APIDOC
## evaluate

### Description
Evaluates a string of JavaScript code within the page's context.

### Args
- **code** (string) - The JavaScript code to execute. Supports `await`.

### Returns
- **{type, value}** - An object containing the type and value of the evaluated expression's result.
```

```APIDOC
## screenshot

### Description
Takes a screenshot of the current page or a specific element and saves it to disk.

### Args
- **format** (string) - The image format ('png' or 'jpeg').
- **quality** (number) - The quality of the screenshot (0-100) for JPEG format.
- **selector** (string) - Optional. The CSS selector or `@e<N>` reference of an element to capture.

### Returns
- **{path, format, sizeBytes}** - An object containing the path to the saved screenshot, its format, and size in bytes.
```

--------------------------------

### File Upload and Frame Management

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Tools for uploading files and managing iframes within the page.

```APIDOC
## upload

### Description
Uploads files to a file input element.

### Args
- **selector** (string) - The CSS selector or `@e<N>` reference of the file input element.
- **files** (string[]) - An array of absolute paths to the files to upload.

### Returns
- **{fileCount}** - An object containing the number of files uploaded.
```

```APIDOC
## frames

### Description
Lists all iframes present on the page.

### Args
- None

### Returns
- **{frames:[{targetId,type,url,title}]}** - An object containing an array of iframe objects, each with its target ID, type, URL, and title. The `targetId` can be used with other tools to act within a specific iframe.
```

--------------------------------

### Set Per-Domain Tab Limit

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Sets the maximum number of concurrent Open WebBridge tabs allowed for a specific domain and its subdomains. The most specific matching domain takes precedence. This limit is enforced before a tab is created or navigated.

```bash
open-webbridge tablimit set xiaohongshu.com --max 2
```

--------------------------------

### Clear All Tab Limits

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Removes all configured per-domain tab limits.

```bash
open-webbridge tablimit clear --all
```

--------------------------------

### Call command result format

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

The expected JSON output format for the 'call' command, indicating success ('ok': true) or failure ('ok': false) with an error message.

```json
{"ok": true, "data": …}
 or 
{"ok": false, "error": "…"}
```

--------------------------------

### Remove Open WebBridge Data Directory

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/README.md

This command recursively removes the Open WebBridge data directory. Ensure all necessary data is backed up before execution.

```bash
rm -rf ~/.open-webbridge
```

--------------------------------

### Clear Specific Domain Tab Limit

Source: https://github.com/zhizuzhefu/open-webbridge/blob/main/open-webbridge-skill/SKILL.md

Removes the tab limit configuration for a specific domain.

```bash
open-webbridge tablimit clear xiaohongshu.com
```
Tokens:
Raw