DocsLicense Managementbrowser_add_license

browser_add_license

Use browser_add_license when you need to automate a browser task. It is part of Owl Browser's License Management toolset and runs inside a self-hosted, source-level stealth engine, so every call inherits the same undetectable browser fingerprint as the rest of your automation — no separate anti-detect setup required.

Usage Example

1234567891011

import asyncio

from owl_browser import OwlBrowser, RemoteConfig

# Async usage

async with OwlBrowser(config) as browser:

context = await browser.create_context()

context_id = context["context_id"]

await browser.add_license(

license_path="value"

)

Parameters

Required

license_pathstringrequired

Absolute path to the license file (.olic extension). Example: '/path/to/license.olic'

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}

Frequently Asked Questions

What does browser_add_license do?

Install a license file to activate the browser. Provide either a file path or base64-encoded content. The license is validated against the hardware fingerprint. Returns success/failure with validation details. It belongs to Owl Browser's License Management category and is available through the REST API, the Python SDK (browser.add_license()), the Node.js SDK, and the MCP server.

What parameters does browser_add_license accept?

browser_add_license accepts 1 required parameter (license_path) and 0 optional parameters. All parameters are sent as JSON in a POST request to /api/execute/browser_add_license.

Is browser_add_license detectable by anti-bot systems like Cloudflare or DataDome?

No. browser_add_license executes inside Owl Browser's Chromium engine, which applies fingerprint spoofing at the C++ source level rather than through JavaScript patches. Every tool call shares the same consistent, human-like fingerprint, so anti-bot systems such as Cloudflare, DataDome, and Akamai see an ordinary browser.

Related Tools

browser_get_license_status

Check if the browser has a valid license. Returns license status (valid, expired, missing, invalid), expiration date, and license type (trial, standard, enterprise). Quick check for license validity.

browser_get_license_info

Get comprehensive license information including licensee name, license key (partially masked), features enabled, usage limits, support expiration, and full license metadata.

browser_get_hardware_fingerprint

Get the machine's hardware fingerprint used for license binding. Provide this to obtain a license file tied to your hardware. The fingerprint is a unique identifier based on hardware characteristics.

browser_remove_license

Remove the currently installed license. The browser reverts to unlicensed/trial mode. Use before installing a new license or to deactivate the browser on this machine.

browser_create_context

Create a new isolated browser context with its own cookies, storage, and optional proxy configuration. Each context acts as an independent browser session. Use this to create multiple isolated browsing sessions, configure proxy/Tor connections, load browser profiles with saved fingerprints, and enable/disable LLM features. Returns a context_id to use with other browser tools.

browser_navigate

Navigate the browser to a specified URL. This is a non-blocking operation that starts navigation and returns immediately. Use browser_wait_for_network_idle or browser_wait_for_selector to wait for the page to fully load. Supports HTTP, HTTPS, file, and data URLs. When wait_until is set (load, networkidle, fullscroll, domcontentloaded) and the page declares WebMCP tools, the response includes a webmcp_tools array containing the full tool definitions (name, description, inputSchema). Use browser_webmcp_call_tool to execute any of these tools directly.

Browse the full Owl Browser API reference or get started with the Python SDK and Node.js SDK.