Add support for remote browsers via CDP (BrowserStack, LambdaTest)

[Copilot]

Adds ability to connect to remote browser services via Chrome DevTools Protocol instead of launching a local browser.

Changes

• src/index.ts: Added initBrowser() function that uses chromium.connectOverCDP() when BROWSER_WS_ENDPOINT is set, falls back to local browser otherwise
• .env.example: Documented new BROWSER_WS_ENDPOINT variable with examples for BrowserStack and LambdaTest
• README.md: Added remote browser configuration section with environment variable reference
• tests/browser-config.spec.ts: Tests for environment variable parsing logic

Usage

# BrowserStack
BROWSER_WS_ENDPOINT=wss://cdp.browserstack.com/playwright?caps=<encoded_caps>

# LambdaTest
BROWSER_WS_ENDPOINT=wss://cdp.lambdatest.com/playwright?capabilities=<encoded_caps>

When unset, behavior is unchanged (local browser).

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• fake.test.endpoint
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/web-capture/web-capture/node_modules/.bin/ts-node ./src/index.ts git ome-�� *.ts" --fix --global /home/REDACTED/.local/bin/git credential.usernldd (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add support remote browser like browserstack or lamdatest</issue_title>
<issue_description></issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Add support remote browser like browserstack or lamdatest #4

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud