Nstbrowser SOP

Appearance

Test ​

Classification: NEEDS-DESKTOP ​

Status: NEEDS-DESKTOP Nstbrowser is an antidetect browser with a desktop client and a cloud backend. The desktop client must be downloaded from nstbrowser.io and installed, or run via Docker. An account and API key from the Nstbrowser dashboard are required for live profile launches. A free plan is available.

Install method: Download the desktop client from nstbrowser.io and install it, or pull and run the Docker image. Register for an account to obtain an API key.

Cost/access: Free plan available (up to 1,000 profile launches per day on the free tier). Paid plans for higher limits.

Nstbrowser is a desktop/Docker application with a local API server. There is no CLI command that returns a version string without the full client running. The smoke test below verifies the SDK package installs correctly and confirms the API surface is importable.

SDK Smoke Test (Node.js) ​

This test confirms the npm package installs without errors and the main export is reachable. It does NOT require a running Nstbrowser client.

bash
mkdir /tmp/nstbrowser-test && cd /tmp/nstbrowser-test
npm init -y
npm install nstbrowser-sdk-node
node -e "const { NstBrowserV2 } = require('nstbrowser-sdk-node'); console.log('NstBrowserV2 loaded:', typeof NstBrowserV2);"

Expected success output:

NstBrowserV2 loaded: function

If you see NstBrowserV2 loaded: function the package is installed correctly and the SDK is ready to use.

API Connectivity Test (requires running client or Docker) ​

Once the Nstbrowser client or Docker container is running on port 8848, confirm the API is reachable:

bash
curl -s http://localhost:8848/api/v2/health

Expected success output:

json
{"status":"ok"}

If you receive a JSON response with "status":"ok", the local API server is up and ready to accept SDK calls and browser launch commands.

Python SDK Smoke Test ​

bash
pip install nstbrowser
python -c "from nstbrowser import NstbrowserClient; print('NstbrowserClient loaded:', NstbrowserClient)"

Expected success output:

NstbrowserClient loaded: <class 'nstbrowser.client.NstbrowserClient'>

Notes ​

  • All live tests (launching a profile, navigating a page) require a valid API key from the Nstbrowser dashboard and a running client or Docker container.
  • The free tier allows up to 1,000 profile launches per day, which is more than enough for smoke testing.
  • If the API returns 401 Unauthorized, your API key is missing or incorrect. Retrieve it from Settings > API in the Nstbrowser desktop client.