Add an example: NodeMaven proxies in Multilogin X profiles

Merged
AL
4d ago
+194-0

Adds examples/multilogin/: a script that starts a Multilogin X quick profile on a sticky NodeMaven session, attaches Playwright over CDP, and checks that the page sees the session's exit address. README with a five-minute run.

  • Proxy built with the SDK (Proxy(...).session(...)), HTTP on 8080 by default, --socks5 for port 1080.
  • The local launcher is called with trust_env=False, so a system or VPN proxy does not carry requests to 127.0.0.1.
  • Waits for the profile's CDP port before connecting: the launcher answers before the browser listens.
  • Quick profiles are deleted by Multilogin when stopped; the script stops the profile in finally.

Tested on Windows with the Multilogin X app 12.15.0 and playwright 1.63.0: three runs (US, GB, US) over --socks5, each matching the proxy's exit; a bad token is reported as the launcher's 401. The HTTP default was not exercised on that machine. No package code changes; the test suite is unchanged and green.

🤖 Generated with Claude Code

Summary by cubic

Adds examples/multilogin/: a script that starts a Multilogin X quick profile on a sticky NodeMaven session, attaches Playwright over CDP, and verifies the page sees the session's exit address.

  • Builds the proxy with the nodemaven SDK via Proxy(...).session(...); HTTP on 8080 by default, --socks5 for port 1080.
  • Sets trust_env=False on the launcher session so a system or VPN proxy doesn't carry requests to 127.0.0.1.
  • Waits for the profile's CDP port before connecting; the launcher answers before the browser listens.
  • Stops the profile in finally; quick profiles are deleted by Multilogin when stopped.
  • Includes a README with setup and run instructions, plus how to reuse the helpers in your own code.

Summary by CodeRabbit

  • New Features
    • Added a Multilogin example that launches a quick profile through a sticky residential proxy and checks that the browser’s visible address matches the proxy exit address.
    • Supports selecting a country, using SOCKS5, and connecting to a saved profile.
  • Documentation
    • Added setup instructions, prerequisites, environment variable details, and a sample run for the Multilogin example.