Local API

Overview

Start with the smallest reproducible environment. Record the profile directory, platform identity, regional settings, proxy configuration and automation entry point before scaling.

Workflow

Automate profile lifecycle operations through a local interface.

1. Create an empty profile
2. Choose a coherent platform identity
3. Assign and test the network route
4. Launch and inspect the environment
5. Back up the working configuration

Inspectable example

Use an explicit profile path and keep launch errors observable.

const context = await firefox.launchPersistentContext(profilePath, {
  headless: false,
  proxy: { server: proxyUrl }
});

Verification checklist

Validate the environment before adding more profiles.

1. The profile launches without shared storage
2. External IP and region are expected
3. Locale and timezone agree with the chosen region
4. A restart preserves the intended session
5. Errors remain visible in the operation log