Skip to content

Test

Classification: NEEDS-DESKTOP

Status: NEEDS-DESKTOP Dolphin Anty is a desktop antidetect browser. There is no installable CLI package. The desktop app must be downloaded from dolphin-anty.com, installed, and running for any API smoke test to work. A free tier is available with up to 5 profiles.

Install method: Download the installer from dolphin-anty.com and run it. Create an account, log in, and start the app before calling the local API.

Cost/access: Free tier available (up to 5 profiles). Paid plans for more profiles.


Dolphin Anty is a desktop application with a local REST API. There is no installable CLI package with a --version flag. Smoke tests require the desktop app to be installed and running.

Smoke Test 1: Local API Health Check

With the Dolphin Anty desktop app running and authenticated, confirm the local API server is reachable:

bash
curl -s http://localhost:3001/v1.0/auth/login-with-token \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"token": "YOUR_API_TOKEN"}'

Success output:

json
{"success": true}

Failure output (app not running or wrong token):

json
{"success": false, "message": "Invalid token"}

or a connection refused error if the app is not running.

Smoke Test 2: Start a Profile (CDP endpoint)

After authenticating, start a profile and confirm the CDP endpoint is returned:

bash
curl -s "http://localhost:3001/v1.0/browser_profiles/YOUR_PROFILE_ID/start?automation=1"

Success output:

json
{
  "success": true,
  "automation": {
    "port": 50568,
    "wsEndpoint": "/devtools/browser/c71c1a9d-f07c-4dd9-84a9-53a4c6df9969"
  }
}

The port and wsEndpoint values change with each session. Pass them directly to puppeteer.connect or chromium.connectOverCDP.

Smoke Test 3: Cloud API Reachability

Verify the cloud profile API accepts your token:

bash
curl -s https://dolphin-anty-api.com/browser_profiles \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Success output:

json
{
  "data": [...],
  "meta": {"total": 0, "page": 1, "limit": 50}
}

An HTTP 401 response means the token is invalid or expired.

Notes

  • These tests were not run locally because Dolphin Anty requires a licensed desktop install and an active account token. tested=false.
  • The free tier provides 5 profiles, which is sufficient for smoke testing all three endpoints above.
  • If the local API port 3001 is occupied by another process, the app assigns an alternate port. Check the app UI for the active port.