rayobrowse

The project uses a split licensing model:

1. Repository Wrapper, Examples, Docs, and Config Files: Licensed under the MIT License.
2. rayobrowse Browser Binary: Governed by a separate license. This license allows most commercial and hobby use but restricts illegal/unethical use and certain commercial resale categories.

Refer to LICENSE and BROWSER_BINARY_LICENSE.md for full details.

You are prohibited from using the Binary (directly or indirectly) for the following without a separate written agreement from Rayobyte:

1. Restricted Browser Solutions: Products that sell, resell, host, or provide browser automation, browser APIs, browser infrastructure, hosted browsers, anti-detect browsers, or stealth browsers to third parties.
2. Restricted Scraping APIs: Products where third parties call an API or hosted workflow to receive data from web scraping, crawling, extraction, or monitoring services.

For commercial licensing inquiries regarding these categories, contact sales@rayobyte.com.

The Binary may not be used for illegal, harmful, or unethical activities, including:

• Unauthorized access to systems, accounts, or networks.
• Credential stuffing, phishing, fraud, or malware distribution.
• Harassment, stalking, or unauthorized collection of sensitive personal information.
• Infringing on intellectual property or violating privacy and data protection laws.

rayobrowse must only be used for legal and ethical automation and web data collection.

Prohibited activities include:

• Credential attacks
• Fraud
• Spam
• Unauthorized access
• Harassment
• Malware or other harmful activity

Rayobyte is a partner of the EWDCI.

The rayobrowse project uses two different licenses:

1. Repository Wrapper: The source files, examples, documentation, and configuration files in this repository are licensed under the MIT License (see LICENSE).
2. Browser Binary: The actual browser executable (Chromium-based), stealth engine, and bundled binary artifacts are governed by the rayobrowse Browser Binary License.

If you are using rayobrowse in a commercial, regulated, or high-risk setting, you are responsible for ensuring your use complies with this specific binary license.

To use Scrapy with a stealth browser that passes modern bot detection, combine Scrapy with scrapy-playwright and use rayobrowse as the browser provider.

rayobrowse provides a Chromium session with a realistic device fingerprint and standard CDP support. The integration works by calling rayobrowse's HTTP /connect endpoint to obtain a CDP WebSocket URL, which is then passed to scrapy-playwright via the PLAYWRIGHT_CDP_URL setting.

Scrapy spider
  |
  | scrapy-playwright download handler
  v
Playwright  ---CDP--->  returned rayobrowse CDP URL  --->  stealth Chromium

Install the necessary Python packages for the integration. Note that you do not need to run playwright install because the browser is managed inside the rayobrowse Docker container.

pip install scrapy scrapy-playwright httpx

OpenClaw requires a profile containing a session-specific CDP URL. Because the CDP URL changes every time a new session is requested, you must update the profile whenever you want a fresh browser session.

Using OpenClaw CLI

First, request a new URL:

CDP_URL=$(curl -fsS "http://localhost:9222/connect?headless=true&os=windows")

Then, configure the rayobrowse profile:

openclaw config set browser.enabled true
openclaw config set browser.defaultProfile rayobrowse
openclaw config set "browser.profiles.rayobrowse.cdpUrl" "$CDP_URL"

Manual Configuration

Alternatively, edit ~/.openclaw/openclaw.json directly:

{
  browser: {
    enabled: true,
    defaultProfile: "rayobrowse",
    profiles: {
      rayobrowse: {
        cdpUrl: "ws://localhost:9222/cdp/br_59245e8658532863",
      },
    },
  },
}

rayobrowse Cloud is available in early access. The integration flow is identical to the local version, but you must use the cloud endpoint and provide an API key via the x-api-key header.

Endpoint: https://cloud.rayobrowse.com

To request access, contact sales@rayobyte.com.

CDP_URL=$(curl -fsS "https://cloud.rayobrowse.com/connect?headless=true&os=windows" \
  -H "x-api-key: YOUR_API_KEY")

To run rayobrowse locally, you must have Docker installed. The project uses Docker to provide a reproducible environment containing the Chromium binary, stealth fingerprint engine, and HTTP daemon.

Follow these steps to start the service:

1. Clone the repository.
2. Start the container using Docker Compose.
3. Verify the service is healthy by hitting the /health endpoint.

git clone https://github.com/rayobyte-data/rayobrowse.git
cd rayobrowse
docker compose up -d
curl http://localhost:9222/health