gologin-web-access 0.3.2 → 0.3.4

package/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ## Unreleased
 
-- browser automation is now embedded directly in `gologin-web-access`, so one repo and one install contains both Web Unlocker and Cloud Browser flows
+- browser automation is now embedded directly in `gologin-web-access`, so one repo and one install contains both Scraping API and Cloud Browser flows
 - doctor now reports the embedded browser runtime source and version
 
 ## 0.3.2 - 2026-04-03
@@ -17,9 +17,9 @@ Initial public release of Gologin Web Access.
 
 Highlights:
 
-- Unified CLI entry point for Gologin Web Unlocker and Gologin Cloud Browser workflows
+- Unified CLI entry point for GoLogin Scraping API and Gologin Cloud Browser workflows
 - Scraping commands: `scrape`, `scrape-markdown`, `scrape-text`, `scrape-json`, `batch-scrape`
 - Browser commands: `open`, `snapshot`, `click`, `type`, `screenshot`, `close`, `sessions`, `current`
-- Clear two-key configuration model with `GOLOGIN_WEB_UNLOCKER_API_KEY` and `GOLOGIN_TOKEN`
+- Clear two-key configuration model with `GOLOGIN_SCRAPING_API_KEY` and `GOLOGIN_TOKEN`
 - `doctor`, `config show`, and `config init` to reduce setup friction
 - Compatibility support for legacy env names used by existing Gologin tools

package/README.md

@@ -1,12 +1,13 @@
 # Gologin Web Access
 
-Gologin Web Access lets developers and AI agents read and interact with the web using Gologin Web Unlocker and Gologin Cloud Browser.
+Gologin Web Access lets developers and AI agents read and interact with the web using GoLogin Scraping API and Gologin Cloud Browser.
 
 This is a unified web access layer, not just a scraping tool and not just a browser automation tool.
 
 - Read the web through stateless extraction APIs
 - Interact with the web through stateful cloud browser sessions
 - Carry Gologin’s browser-side strengths into those workflows: profiles, identity-aware browser sessions, cloud browser infrastructure, and Gologin’s profile/proxy stack when you run against a configured profile
+- Manage common GoLogin profile/proxy API operations without leaving the CLI: cloud usage, cloud profile start/stop, profile cookies, fingerprint refresh, managed proxies, and user-agent updates
 
 Package name and binary are the same:
 
@@ -17,7 +18,7 @@ Package name and binary are the same:
 
 Gologin Web Access combines two existing product surfaces behind one CLI:
 
-- Web Unlocker
+- Scraping API
   Stateless read and extraction. Best when you want page content quickly without maintaining a browser session.
 - Cloud Browser
   Stateful interaction. Best when you need navigation, clicks, typing, screenshots, or multi-step flows that persist across commands.
@@ -35,23 +36,23 @@ The point of the unified CLI is that both modes live in one product with one com
 
 ### Scraping / Read
 
-These commands use Gologin Web Unlocker:
+These commands use GoLogin Scraping API:
 
 - `gologin-web-access scrape <url>`
-- `gologin-web-access read <url> [--format text|markdown|html] [--source auto|unlocker|browser]`
-- `gologin-web-access scrape-markdown <url> [--source auto|unlocker|browser]`
-- `gologin-web-access scrape-text <url> [--source auto|unlocker|browser]`
+- `gologin-web-access read <url> [--format text|markdown|html] [--source auto|scraping|browser]`
+- `gologin-web-access scrape-markdown <url> [--source auto|scraping|browser]`
+- `gologin-web-access scrape-text <url> [--source auto|scraping|browser]`
 - `gologin-web-access scrape-json <url> [--fallback none|browser]`
-- `gologin-web-access batch-scrape <url...> [--format html|markdown|text|json] [--fallback none|browser] [--source auto|unlocker|browser] [--only-main-content] [--retry <n>] [--backoff-ms <ms>] [--summary] [--output <path>] [--strict]`
-- `gologin-web-access batch-extract <url...> --schema <schema.json> [--source auto|unlocker|browser] [--retry <n>] [--backoff-ms <ms>] [--summary] [--output <path>]`
-- `gologin-web-access search <query> [--limit <n>] [--country <cc>] [--language <lang>] [--source auto|unlocker|browser]`
+- `gologin-web-access batch-scrape <url...> [--format html|markdown|text|json] [--fallback none|browser] [--source auto|scraping|browser] [--only-main-content] [--retry <n>] [--backoff-ms <ms>] [--summary] [--output <path>] [--strict]`
+- `gologin-web-access batch-extract <url...> --schema <schema.json> [--source auto|scraping|browser] [--retry <n>] [--backoff-ms <ms>] [--summary] [--output <path>]`
+- `gologin-web-access search <query> [--limit <n>] [--country <cc>] [--language <lang>] [--source auto|scraping|browser]`
 - `gologin-web-access map <url> [--limit <n>] [--max-depth <n>] [--concurrency <n>] [--strict]`
 - `gologin-web-access crawl <url> [--format html|markdown|text|json] [--limit <n>] [--max-depth <n>] [--only-main-content] [--strict]`
 - `gologin-web-access crawl-start <url> ...`
 - `gologin-web-access crawl-status <jobId>`
 - `gologin-web-access crawl-result <jobId>`
 - `gologin-web-access crawl-errors <jobId>`
-- `gologin-web-access extract <url> --schema <schema.json> [--source auto|unlocker|browser]`
+- `gologin-web-access extract <url> --schema <schema.json> [--source auto|scraping|browser]`
 - `gologin-web-access change-track <url> [--format html|markdown|text|json]`
 - `gologin-web-access batch-change-track <url...> [--format html|markdown|text|json] [--retry <n>] [--backoff-ms <ms>] [--summary] [--output <path>]`
 - `gologin-web-access parse-document <url-or-path>`
@@ -108,6 +109,24 @@ These commands use Gologin Cloud Browser through the local daemon-backed agent l
 
 Use these when you need state, interaction, or multi-step browser flows.
 
+### GoLogin API Helpers
+
+These commands use the GoLogin REST API directly through `GOLOGIN_TOKEN`. They do not require Scraping API and do not start the browser daemon:
+
+- `gologin-web-access cloud-usage --profile <profileId> | --workspace <workspaceId> [--days <1-30>] [--json]`
+- `gologin-web-access profile-cloud start <profileId> [--json]`
+- `gologin-web-access profile-cloud stop <profileId> [--json]`
+- `gologin-web-access profile-cookies export <profileId> [--output <path>] [--json]`
+- `gologin-web-access profile-cookies import <profileId> <cookies.json> [--clean] [--json]`
+- `gologin-web-access profile-fingerprint refresh <profileId...> [--json]`
+- `gologin-web-access profile-proxy list [--page <n>] [--json]`
+- `gologin-web-access profile-proxy traffic`
+- `gologin-web-access profile-proxy add-gologin <profileId> --country <cc> [--city <city>] [--type residential|mobile|dc] [--json]`
+- `gologin-web-access profile-ua latest [--os lin|mac|win|android|android-cloud] [--json]`
+- `gologin-web-access profile-ua update <profileId...> [--all-profiles] [--workspace <id>] [--json]`
+
+Use these when an agent needs GoLogin account/profile operations and would otherwise drop into raw REST calls or SDK code.
+
 ## When To Use `scrape` vs `browser`
 
 - Use `scrape` commands when you need page content, extracted text, markdown, or simple structured output.
@@ -124,6 +143,7 @@ Use these when you need state, interaction, or multi-step browser flows.
 - Use `batch-change-track` when you want to monitor a watchlist of pages in one pass.
 - Use `parse-document` when the source is a PDF, DOCX, XLSX, HTML, or local document path instead of a normal HTML page.
 - Use browser commands when you need clicks, forms, navigation, screenshots, sessions, or logged-in/profile-backed flows.
+- Use GoLogin API helper commands when you need to attach managed proxy traffic, export/import profile cookies, refresh fingerprints, update user agents, inspect usage, or start/stop a cloud profile.
 - Use browser commands when you need ref-based interaction, uploads, PDFs, semantic find flows, keyboard control, or a browser-visible search journey.
 - Use `run` and `batch` when you want reusable workflows or multi-target execution on top of the CLI surface.
 - Use `scrape` when stateless speed matters more than interaction.
@@ -165,25 +185,25 @@ If the browser surface grows substantially later, a nested namespace may become
 
 This CLI uses two different GoLogin credentials on purpose, because the underlying products are different.
 
-- `GOLOGIN_WEB_UNLOCKER_API_KEY`
+- `GOLOGIN_SCRAPING_API_KEY`
   Required for Scraping / Read commands.
 - `GOLOGIN_TOKEN`
-  Required for `gologin-web-access open` and for profile validation in `gologin-web-access doctor`.
+  Required for `gologin-web-access open`, GoLogin API helper commands, and profile validation in `gologin-web-access doctor`.
 - `GOLOGIN_DEFAULT_PROFILE_ID`
   Optional default profile for browser flows.
 - `GOLOGIN_DAEMON_PORT`
   Optional local daemon port for browser workflows.
 
-Recommended full setup for agents is to configure both `GOLOGIN_WEB_UNLOCKER_API_KEY` and `GOLOGIN_TOKEN` before starting work, even if the current task looks read-only or browser-only.
+Recommended full setup for agents is to configure both `GOLOGIN_SCRAPING_API_KEY` and `GOLOGIN_TOKEN` before starting work, even if the current task looks read-only or browser-only.
 
 Missing-key errors are command-group specific. Example:
 
-`Missing GOLOGIN_WEB_UNLOCKER_API_KEY. This is required for scraping commands like \`gologin-web-access scrape\`.`
+`Missing GOLOGIN_SCRAPING_API_KEY. This is required for scraping commands like \`gologin-web-access scrape\`.`
 
 Environment variables are the primary configuration mechanism:
 
 ```bash
-export GOLOGIN_WEB_UNLOCKER_API_KEY="wu_..."
+export GOLOGIN_SCRAPING_API_KEY="wu_..."
 export GOLOGIN_TOKEN="gl_..."
 export GOLOGIN_DEFAULT_PROFILE_ID="profile_123"
 export GOLOGIN_DAEMON_PORT="4590"
@@ -198,8 +218,8 @@ gologin-web-access config init
 Useful variants:
 
 ```bash
-gologin-web-access config init --web-unlocker-api-key wu_... --token gl_...
-gologin-web-access config init --web-unlocker-key wu_... --token gl_...
+gologin-web-access config init --scraping-api-key wu_... --token gl_...
+gologin-web-access config init --web-unlocker-key wu_... --token gl_... # legacy alias
 ```
 
 That writes `~/.gologin-web-access/config.json` once and the CLI will keep reading it on later runs.
@@ -246,7 +266,7 @@ npm install -g gologin-web-access
 ### Read A Page
 
 ```bash
-export GOLOGIN_WEB_UNLOCKER_API_KEY="wu_..."
+export GOLOGIN_SCRAPING_API_KEY="wu_..."
 
 gologin-web-access scrape https://example.com
 gologin-web-access read https://docs.browserbase.com/features/stealth-mode
@@ -287,6 +307,20 @@ gologin-web-access current
 gologin-web-access close
 ```
 
+### Manage Profiles And Proxies
+
+```bash
+export GOLOGIN_TOKEN="gl_..."
+
+gologin-web-access cloud-usage --profile profile_123
+gologin-web-access profile-proxy add-gologin profile_123 --country us --type residential
+gologin-web-access profile-proxy traffic
+gologin-web-access profile-cookies export profile_123 --output ./cookies.json
+gologin-web-access profile-fingerprint refresh profile_123
+gologin-web-access profile-ua latest --os mac
+gologin-web-access profile-ua update profile_123
+```
+
 ### Search In A Real Browser
 
 ```bash
@@ -298,17 +332,17 @@ gologin-web-access snapshot -i
 
 ## Structured Output And Retry Controls
 
-- `scrape-markdown` and `scrape-text` now default to `--source auto`: they start with Unlocker, isolate the most readable content block, and can auto-retry with Cloud Browser when the output still looks like JS-rendered docs chrome.
+- `scrape-markdown` and `scrape-text` now default to `--source auto`: they start with Scraping API, isolate the most readable content block, and can auto-retry with Cloud Browser when the output still looks like JS-rendered docs chrome.
 - `read` is the shortest path for "look at this docs page" work: it targets the most readable content block and defaults to `--format text --source auto`.
-- `scrape-markdown` and `scrape-text` also accept `--source unlocker` and `--source browser` when you want to force one path.
-- `extract` now accepts `--source auto|unlocker|browser` and returns `renderSource`, fallback flags, and request metadata with the extracted JSON.
+- `scrape-markdown` and `scrape-text` also accept `--source scraping` and `--source browser` when you want to force one path. `--source unlocker` remains as a legacy alias.
+- `extract` now accepts `--source auto|scraping|browser` and returns `renderSource`, fallback flags, and request metadata with the extracted JSON.
 - `batch-extract` reuses the same extraction path across many URLs and returns one structured result per URL, including request and fallback metadata. Add `--output <path>` to save the full array directly.
 - `scrape-json` now returns both a flat `headings` array and `headingsByLevel` buckets for `h1` through `h6`.
 - `scrape-json --fallback browser` is available for JS-heavy pages where stateless extraction returns weak heading data.
 - `scrape-json` now also classifies the page outcome as `ok`, `empty`, `incomplete`, `authwall`, `challenge`, `blocked`, or `cookie_wall`, and includes `nextActionHint` when the result is weak or gated.
 - `scrape`, `scrape-markdown`, `scrape-text`, `scrape-json`, and `batch-scrape` accept `--retry`, `--backoff-ms`, and `--timeout-ms`.
 - `batch-scrape --only-main-content` lets markdown, text, and html batch runs use the same readable-content isolation path as `read`.
-- `crawl --only-main-content` uses the same readable-fragment extraction strategy for html, markdown, and text crawl output, but stays on the stateless unlocker path.
+- `crawl --only-main-content` uses the same readable-fragment extraction strategy for html, markdown, and text crawl output, but stays on the stateless Scraping API path.
 - `batch-scrape --summary` prints a one-line success/failure summary to `stderr` after the JSON payload.
 - `batch-scrape` now returns exit code `0` on partial success by default and only fails the command when every URL failed. Add `--strict` if any single failed URL should make the whole batch exit non-zero.
 - `batch-scrape --output <path>` writes the full JSON to disk so shells and agent consoles cannot truncate a large payload silently.
@@ -336,7 +370,7 @@ gologin-web-access jobs
 
 Gologin Web Access still has two runtime layers:
 
-- Web Unlocker for stateless read and extraction
+- Scraping API for stateless read and extraction
 - Cloud Browser for stateful interaction
 
 But both are now shipped inside the same package and the same repository. One install gives you the full read layer and the full browser/session layer.

package/dist/cli.js

@@ -30,6 +30,7 @@ const find_1 = require("./commands/find");
 const focus_1 = require("./commands/focus");
 const forward_1 = require("./commands/forward");
 const get_1 = require("./commands/get");
+const gologinApi_1 = require("./commands/gologinApi");
 const hover_1 = require("./commands/hover");
 const jobs_1 = require("./commands/jobs");
 const map_1 = require("./commands/map");
@@ -67,12 +68,12 @@ const wait_1 = require("./commands/wait");
 const doctor_1 = require("./doctor");
 const errors_1 = require("./lib/errors");
 const output_1 = require("./lib/output");
-const CLI_VERSION = "0.3.2";
+const CLI_VERSION = "0.3.4";
 async function main() {
     const program = new commander_1.Command();
     program
         .name("gologin-web-access")
-        .description("Read and interact with the web using Gologin Web Unlocker and Cloud Browser.")
+        .description("Read and interact with the web using the GoLogin Scraping API and Cloud Browser.")
         .version(CLI_VERSION)
         .showHelpAfterError()
         .showSuggestionAfterError();
@@ -137,6 +138,12 @@ async function main() {
     program.addCommand((0, close_1.buildCloseCommand)());
     program.addCommand((0, sessions_1.buildSessionsCommand)());
     program.addCommand((0, current_1.buildCurrentCommand)());
+    program.addCommand((0, gologinApi_1.buildCloudUsageCommand)());
+    program.addCommand((0, gologinApi_1.buildProfileCloudCommand)());
+    program.addCommand((0, gologinApi_1.buildProfileCookiesCommand)());
+    program.addCommand((0, gologinApi_1.buildProfileFingerprintCommand)());
+    program.addCommand((0, gologinApi_1.buildProfileProxyCommand)());
+    program.addCommand((0, gologinApi_1.buildProfileUaCommand)());
     program
         .command("doctor")
         .description("Inspect both recommended keys, profile configuration, and local daemon health.")
@@ -163,10 +170,11 @@ Quick picks:
 Command groups:
   Scraping: gologin-web-access scrape|read|scrape-markdown|scrape-text|scrape-json|batch-scrape|batch-extract|search|map|crawl|crawl-start|crawl-status|crawl-result|crawl-errors|extract|change-track|batch-change-track|parse-document
   Browser:  gologin-web-access open|search-browser|scrape-screenshot|tabs|tabopen|tabfocus|tabclose|snapshot|click|dblclick|focus|type|fill|hover|select|check|uncheck|press|scroll|scrollintoview|wait|get|back|forward|reload|find|cookies|cookies-import|cookies-clear|storage-export|storage-import|storage-clear|eval|upload|pdf|screenshot|close|sessions|current
+  GoLogin API: gologin-web-access cloud-usage|profile-cloud|profile-cookies|profile-fingerprint|profile-proxy|profile-ua
   Agent:    gologin-web-access run|batch|jobs|job
 
 Key model:
-  ${"GOLOGIN_WEB_UNLOCKER_API_KEY"} powers scraping commands.
+  ${"GOLOGIN_SCRAPING_API_KEY"} powers scraping commands.
   ${"GOLOGIN_TOKEN"} powers browser commands.
   Recommended setup: configure both keys up front, even if the current task only needs one path.
 `);

package/dist/commands/batchExtract.js

@@ -18,7 +18,7 @@ function buildBatchExtractCommand() {
         .description("Extract structured data from multiple pages using one selector schema.")
         .argument("<urls...>", "One or more URLs")
         .requiredOption("--schema <path>", "Path to a JSON extraction schema")
-        .option("--source <source>", "Read source: auto, unlocker, or browser", "auto")
+        .option("--source <source>", "Read source: auto, scraping, or browser. Legacy alias: unlocker", "auto")
         .option("--concurrency <count>", "Number of concurrent requests", "4")
         .option("--output <path>", "Write the full batch result JSON to a file")
         .option("--summary", "Print one-line summary stats to stderr after the JSON output")

package/dist/commands/batchScrape.js

@@ -17,12 +17,12 @@ const unlocker_1 = require("../lib/unlocker");
 const shared_1 = require("./shared");
 function buildBatchScrapeCommand() {
     return (0, shared_1.addProfileOption)((0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("batch-scrape")
-        .description("Fetch multiple pages through Web Unlocker and print a JSON array of results.")
+        .description("Fetch multiple pages through Scraping API and print a JSON array of results.")
         .argument("<urls...>", "One or more URLs")
         .option("--format <format>", "html, markdown, text, or json", "html")
         .option("--concurrency <count>", "Number of concurrent requests", "4")
         .option("--fallback <mode>", "Structured scrape fallback: none or browser", "none")
-        .option("--source <source>", "Read source for --only-main-content mode: auto, unlocker, or browser", "auto")
+        .option("--source <source>", "Read source for --only-main-content mode: auto, scraping, or browser. Legacy alias: unlocker", "auto")
         .option("--only-main-content", "For html, markdown, or text formats, isolate the most readable content block per page")
         .option("--output <path>", "Write the full batch result JSON to a file")
         .option("--summary", "Print one-line summary stats to stderr after the JSON output")

package/dist/commands/configInit.js

@@ -8,9 +8,10 @@ const output_1 = require("../lib/output");
 const unlocker_1 = require("../lib/unlocker");
 function buildConfigInitCommand() {
     return new commander_1.Command("init")
-        .description("Write ~/.gologin-web-access/config.json with current values or placeholders. Recommended: persist both the Web Unlocker key and the GoLogin token.")
-        .option("--web-unlocker-api-key <key>", "Persist a Web Unlocker API key")
-        .option("--web-unlocker-key <key>", "Alias for --web-unlocker-api-key")
+        .description("Write ~/.gologin-web-access/config.json with current values or placeholders. Recommended: persist both the Scraping API key and the GoLogin token.")
+        .option("--scraping-api-key <key>", "Persist a Scraping API key")
+        .option("--web-unlocker-api-key <key>", "Legacy alias for --scraping-api-key")
+        .option("--web-unlocker-key <key>", "Legacy alias for --scraping-api-key")
         .option("--token <token>", "Persist a GoLogin token")
         .option("--cloud-token <token>", "Backward-compatible alias for --token")
         .option("--default-profile-id <id>", "Persist a default Gologin profile ID")
@@ -18,7 +19,12 @@ function buildConfigInitCommand() {
         .option("--no-validate", "Skip live key validation after writing config")
         .option("--force", "Overwrite an existing config file")
         .action(async (options) => {
-        const webUnlockerApiKey = options.webUnlockerApiKey ?? options.webUnlockerKey ?? process.env[config_1.ENV_NAMES.webUnlockerApiKey];
+        const webUnlockerApiKey = options.scrapingApiKey ??
+            options.webUnlockerApiKey ??
+            options.webUnlockerKey ??
+            process.env[config_1.ENV_NAMES.webUnlockerApiKey] ??
+            process.env.GOLOGIN_WEB_UNLOCKER_API_KEY ??
+            process.env.GOLOGIN_WEBUNLOCKER_API_KEY;
         const result = await (0, config_1.initConfigFile)({
             webUnlockerApiKey,
             cloudToken: options.token ??
@@ -37,7 +43,7 @@ function buildConfigInitCommand() {
         (0, output_1.printKeyValueRows)([
             { label: "Config file", value: result.path },
             {
-                label: "Web Unlocker key",
+                label: "Scraping API key",
                 value: result.config.webUnlockerApiKey ? "written" : "left empty",
             },
             {
@@ -54,7 +60,7 @@ function buildConfigInitCommand() {
             },
         ]);
         if (!result.config.webUnlockerApiKey || !result.config.cloudToken) {
-            (0, output_1.printText)("Recommended next step: configure both GOLOGIN_WEB_UNLOCKER_API_KEY and GOLOGIN_TOKEN so agents can use scraping and browser flows without asking again.");
+            (0, output_1.printText)("Recommended next step: configure both GOLOGIN_SCRAPING_API_KEY and GOLOGIN_TOKEN so agents can use scraping and browser flows without asking again.");
         }
         if (options.validate === false) {
             return;
@@ -63,7 +69,7 @@ function buildConfigInitCommand() {
         if (result.config.webUnlockerApiKey) {
             const validation = await (0, unlocker_1.validateWebUnlockerKey)(result.config.webUnlockerApiKey);
             validationRows.push({
-                label: "Web Unlocker validation",
+                label: "Scraping API validation",
                 value: validation.ok ? "ok" : `failed${validation.status ? ` (${validation.status})` : ""}: ${validation.detail}`,
             });
         }

package/dist/commands/crawl.js

@@ -7,7 +7,7 @@ const crawl_1 = require("../lib/crawl");
 const output_1 = require("../lib/output");
 function buildCrawlCommand() {
     return new commander_1.Command("crawl")
-        .description("Crawl a website through Gologin Web Unlocker and return per-page extracted content.")
+        .description("Crawl a website through GoLogin Scraping API and return per-page extracted content.")
         .argument("<url>", "Root website URL to crawl")
         .option("--format <format>", "html, markdown, text, or json", "markdown")
         .option("--limit <count>", "Maximum number of pages to visit", "25")

package/dist/commands/extract.js

@@ -18,7 +18,7 @@ function buildExtractCommand() {
         .argument("<url>", "Target URL")
         .requiredOption("--schema <path>", "Path to a JSON extraction schema")
         .option("--output <path>", "Write extracted JSON to a file")
-        .option("--source <source>", "Read source: auto, unlocker, or browser", "auto")
+        .option("--source <source>", "Read source: auto, scraping, or browser. Legacy alias: unlocker", "auto")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();
         const source = (0, readSource_1.normalizeReadSourceMode)(options.source, "auto");

package/dist/commands/gologinApi.js

@@ -0,0 +1,324 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCloudUsageCommand = buildCloudUsageCommand;
+exports.buildProfileCloudCommand = buildProfileCloudCommand;
+exports.buildProfileCookiesCommand = buildProfileCookiesCommand;
+exports.buildProfileFingerprintCommand = buildProfileFingerprintCommand;
+exports.buildProfileProxyCommand = buildProfileProxyCommand;
+exports.buildProfileUaCommand = buildProfileUaCommand;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const commander_1 = require("commander");
+const config_1 = require("../config");
+const cloudApi_1 = require("../lib/cloudApi");
+const errors_1 = require("../lib/errors");
+const output_1 = require("../lib/output");
+async function getCloudToken() {
+    const config = await (0, config_1.loadConfig)();
+    return (0, config_1.requireCloudToken)(config);
+}
+function parseDays(value) {
+    const days = value ? Number(value) : 7;
+    if (!Number.isInteger(days) || days < 1 || days > 30) {
+        throw new errors_1.CliError("--days must be an integer from 1 to 30.");
+    }
+    return days;
+}
+function parsePage(value) {
+    if (!value) {
+        return undefined;
+    }
+    const page = Number(value);
+    if (!Number.isInteger(page) || page < 1) {
+        throw new errors_1.CliError("--page must be a positive integer.");
+    }
+    return page;
+}
+function normalizeCountryCode(value) {
+    const countryCode = value.toLowerCase();
+    if (!/^[a-z]{2}$/.test(countryCode)) {
+        throw new errors_1.CliError("--country must be a 2-letter country code, for example us.");
+    }
+    return countryCode;
+}
+function normalizeProxyType(value) {
+    const type = value ?? "residential";
+    if (type === "mobile") {
+        return { isMobile: true, label: "mobile" };
+    }
+    if (type === "dc" || type === "datacenter") {
+        return { isDC: true, label: "datacenter" };
+    }
+    if (type === "residential") {
+        return { label: "residential" };
+    }
+    throw new errors_1.CliError("--type must be one of residential, mobile, or dc.");
+}
+function detectHostOs() {
+    if (process.platform === "darwin") {
+        return "mac";
+    }
+    if (process.platform === "win32") {
+        return "win";
+    }
+    return "lin";
+}
+function normalizeOs(value) {
+    const os = value ?? detectHostOs();
+    if (!["lin", "mac", "win", "android", "android-cloud"].includes(os)) {
+        throw new errors_1.CliError("--os must be one of lin, mac, win, android, or android-cloud.");
+    }
+    return os;
+}
+async function readJsonFile(targetPath) {
+    const absolutePath = path_1.default.resolve(targetPath);
+    try {
+        return JSON.parse(await fs_1.promises.readFile(absolutePath, "utf8"));
+    }
+    catch (error) {
+        throw new errors_1.CliError(`Failed to read JSON file ${absolutePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function writeJsonFile(targetPath, payload) {
+    const absolutePath = path_1.default.resolve(targetPath);
+    await fs_1.promises.mkdir(path_1.default.dirname(absolutePath), { recursive: true });
+    await fs_1.promises.writeFile(absolutePath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+    return absolutePath;
+}
+function buildCloudUsageCommand() {
+    return new commander_1.Command("cloud-usage")
+        .description("Read GoLogin Cloud Browser usage statistics.")
+        .option("--profile <profileId>", "Profile ID to inspect")
+        .option("--workspace <workspaceId>", "Workspace ID to inspect")
+        .option("--days <days>", "Workspace stats range from 1 to 30 days", "7")
+        .option("--json", "Print JSON output")
+        .action(async (options) => {
+        if (options.profile && options.workspace) {
+            throw new errors_1.CliError("Use either --profile or --workspace, not both.");
+        }
+        const token = await getCloudToken();
+        if (options.profile) {
+            const payload = await (0, cloudApi_1.gologinApiRequest)(token, "GET", `/cloud-usage/profile/${options.profile}/stats`);
+            if (options.json) {
+                (0, output_1.printJson)(payload);
+                return;
+            }
+            (0, output_1.printText)(`profile=${options.profile} usage=${JSON.stringify(payload)}`);
+            return;
+        }
+        if (!options.workspace) {
+            throw new errors_1.CliError("Usage: gologin-web-access cloud-usage --profile <profileId> | --workspace <workspaceId> [--days <1-30>] [--json]");
+        }
+        const days = parseDays(options.days);
+        const payload = await (0, cloudApi_1.gologinApiRequest)(token, "GET", "/cloud-usage/stats", {
+            query: { workspaceId: options.workspace, days },
+        });
+        if (options.json) {
+            (0, output_1.printJson)(payload);
+            return;
+        }
+        (0, output_1.printText)(`workspace=${options.workspace} days=${days} usage=${JSON.stringify(payload)}`);
+    });
+}
+function buildProfileCloudCommand() {
+    const command = new commander_1.Command("profile-cloud").description("Start or stop a GoLogin profile in Cloud Browser.");
+    command
+        .command("start")
+        .argument("<profileId>", "Profile ID")
+        .option("--json", "Print JSON output")
+        .action(async (profileId, options) => {
+        const token = await getCloudToken();
+        const payload = await (0, cloudApi_1.gologinApiRequest)(token, "POST", `/browser/${profileId}/web`, { body: {} });
+        if (options.json) {
+            (0, output_1.printJson)(payload ?? { profileId, started: true });
+            return;
+        }
+        const value = (0, cloudApi_1.asObjectPayload)(payload);
+        const remoteUrl = typeof value.remoteOrbitaUrl === "string" ? ` remote=${value.remoteOrbitaUrl}` : "";
+        (0, output_1.printText)(`profile=${profileId} cloud=started${remoteUrl}`);
+    });
+    command
+        .command("stop")
+        .argument("<profileId>", "Profile ID")
+        .option("--json", "Print JSON output")
+        .action(async (profileId, options) => {
+        const token = await getCloudToken();
+        await (0, cloudApi_1.gologinApiRequest)(token, "DELETE", `/browser/${profileId}/web`);
+        if (options.json) {
+            (0, output_1.printJson)({ profileId, stopped: true });
+            return;
+        }
+        (0, output_1.printText)(`profile=${profileId} cloud=stopped`);
+    });
+    return command;
+}
+function buildProfileCookiesCommand() {
+    const command = new commander_1.Command("profile-cookies").description("Export or import cookies from the GoLogin profile database.");
+    command
+        .command("export")
+        .argument("<profileId>", "Profile ID")
+        .option("--output <path>", "Write cookies JSON to a file")
+        .option("--json", "Print JSON output with profile metadata")
+        .action(async (profileId, options) => {
+        const token = await getCloudToken();
+        const cookies = await (0, cloudApi_1.gologinApiRequest)(token, "GET", `/browser/${profileId}/cookies`);
+        if (options.output) {
+            (0, output_1.printText)(await writeJsonFile(options.output, cookies));
+            return;
+        }
+        (0, output_1.printJson)(options.json ? { profileId, cookies } : cookies);
+    });
+    command
+        .command("import")
+        .argument("<profileId>", "Profile ID")
+        .argument("<cookiesJson>", "Cookie JSON file")
+        .option("--clean", "Clear existing cookies before importing")
+        .option("--json", "Print JSON output")
+        .action(async (profileId, cookiesJson, options) => {
+        const cookies = await readJsonFile(cookiesJson);
+        if (!Array.isArray(cookies)) {
+            throw new errors_1.CliError("Cookie import file must contain a JSON array.");
+        }
+        const token = await getCloudToken();
+        await (0, cloudApi_1.gologinApiRequest)(token, "POST", `/browser/${profileId}/cookies`, {
+            query: { fromUser: true, cleanCookies: options.clean || undefined },
+            body: cookies,
+        });
+        if (options.json) {
+            (0, output_1.printJson)({ profileId, imported: cookies.length, cleanCookies: options.clean === true });
+            return;
+        }
+        (0, output_1.printText)(`profile=${profileId} importedCookies=${cookies.length}${options.clean ? " clean=true" : ""}`);
+    });
+    return command;
+}
+function buildProfileFingerprintCommand() {
+    const command = new commander_1.Command("profile-fingerprint").description("Refresh fingerprints for one or more GoLogin profiles.");
+    command
+        .command("refresh")
+        .argument("<profileIds...>", "Profile IDs")
+        .option("--json", "Print JSON output")
+        .action(async (profileIds, options) => {
+        const token = await getCloudToken();
+        const payload = await (0, cloudApi_1.gologinApiRequest)(token, "PATCH", "/browser/fingerprints", {
+            body: { browsersIds: profileIds },
+        });
+        if (options.json) {
+            (0, output_1.printJson)(payload);
+            return;
+        }
+        (0, output_1.printText)(`refreshedFingerprints=${profileIds.length} profiles=${profileIds.join(",")}`);
+    });
+    return command;
+}
+function buildProfileProxyCommand() {
+    const command = new commander_1.Command("profile-proxy").description("Manage GoLogin proxies through the REST API.");
+    command
+        .command("list")
+        .option("--page <page>", "Page number", "1")
+        .option("--json", "Print JSON output")
+        .action(async (options) => {
+        const token = await getCloudToken();
+        const payload = await (0, cloudApi_1.gologinApiRequest)(token, "GET", "/proxy/v2", {
+            query: { page: parsePage(options.page) },
+        });
+        if (options.json) {
+            (0, output_1.printJson)(payload);
+            return;
+        }
+        const value = (0, cloudApi_1.asObjectPayload)(payload);
+        const proxies = Array.isArray(value.proxies) ? value.proxies : [];
+        (0, output_1.printText)(`proxies=${proxies.length} hasMore=${value.hasMore === true}`);
+    });
+    command
+        .command("traffic")
+        .description("Read GoLogin managed proxy traffic balance/usage.")
+        .action(async () => {
+        const token = await getCloudToken();
+        (0, output_1.printJson)(await (0, cloudApi_1.gologinApiRequest)(token, "GET", "/users-proxies/geolocation/traffic"));
+    });
+    command
+        .command("add-gologin")
+        .argument("<profileId>", "Profile ID to link the managed proxy to")
+        .requiredOption("--country <cc>", "2-letter country code, for example us")
+        .option("--city <city>", "Optional city name")
+        .option("--type <type>", "residential, mobile, or dc", "residential")
+        .option("--name <name>", "Custom proxy name")
+        .option("--json", "Print JSON output")
+        .action(async (profileId, options) => {
+        const token = await getCloudToken();
+        const countryCode = normalizeCountryCode(options.country);
+        const proxyType = normalizeProxyType(options.type);
+        const body = {
+            countryCode,
+            profileIdToLink: profileId,
+            customName: options.name ?? `gologin-${countryCode}-${profileId.slice(0, 6)}`,
+        };
+        if (options.city) {
+            body.city = options.city;
+        }
+        if (proxyType.isMobile !== undefined) {
+            body.isMobile = proxyType.isMobile;
+        }
+        if (proxyType.isDC !== undefined) {
+            body.isDC = proxyType.isDC;
+        }
+        const payload = await (0, cloudApi_1.gologinApiRequest)(token, "POST", "/users-proxies/mobile-proxy", { body });
+        if (options.json) {
+            (0, output_1.printJson)(payload ?? { profileId, countryCode, type: proxyType.label });
+            return;
+        }
+        (0, output_1.printText)(`profile=${profileId} proxy=gologin:${countryCode} type=${proxyType.label}`);
+    });
+    return command;
+}
+function buildProfileUaCommand() {
+    const command = new commander_1.Command("profile-ua").description("Read latest GoLogin user agent or update profile UA.");
+    command
+        .command("latest")
+        .option("--os <os>", "lin, mac, win, android, or android-cloud")
+        .option("--json", "Print JSON output")
+        .action(async (options) => {
+        const os = normalizeOs(options.os);
+        const token = await getCloudToken();
+        const payload = await (0, cloudApi_1.gologinApiRequest)(token, "GET", "/browser/latest-useragent", {
+            query: { os },
+        });
+        if (options.json) {
+            (0, output_1.printJson)(payload);
+            return;
+        }
+        (0, output_1.printText)(`os=${os} latestUserAgent=${typeof payload === "string" ? payload : JSON.stringify(payload)}`);
+    });
+    command
+        .command("update")
+        .argument("[profileIds...]", "Profile IDs")
+        .option("--all-profiles", "Update all profiles in the current workspace")
+        .option("--workspace <id>", "Current workspace ID")
+        .option("--json", "Print JSON output")
+        .action(async (profileIds, options) => {
+        if (profileIds.length === 0 && !options.allProfiles) {
+            throw new errors_1.CliError("Usage: gologin-web-access profile-ua update <profileId...> [--all-profiles] [--workspace <id>] [--json]");
+        }
+        const token = await getCloudToken();
+        const payload = await (0, cloudApi_1.gologinApiRequest)(token, "PATCH", "/browser/update_ua_to_new_browser_v", {
+            query: { currentWorkspace: options.workspace },
+            body: {
+                browserIds: profileIds,
+                updateUaToNewBrowserV: true,
+                updateAllProfiles: options.allProfiles === true,
+            },
+        });
+        if (options.json) {
+            (0, output_1.printJson)(payload ?? { updated: true, profileIds, allProfiles: options.allProfiles === true });
+            return;
+        }
+        (0, output_1.printText)(options.allProfiles
+            ? "updatedUserAgent=allProfiles"
+            : `updatedUserAgentProfiles=${profileIds.length} profiles=${profileIds.join(",")}`);
+    });
+    return command;
+}

package/dist/commands/map.js

@@ -7,7 +7,7 @@ const output_1 = require("../lib/output");
 const crawl_1 = require("../lib/crawl");
 function buildMapCommand() {
     return new commander_1.Command("map")
-        .description("Discover internal website links through Gologin Web Unlocker.")
+        .description("Discover internal website links through GoLogin Scraping API.")
         .argument("<url>", "Root website URL to map")
         .option("--limit <count>", "Maximum number of pages to visit", "100")
         .option("--max-depth <depth>", "Maximum link depth from the root URL", "2")

package/dist/commands/read.js

@@ -12,7 +12,7 @@ function buildReadCommand() {
         .description("Read the main content of a docs page or article with automatic fallback to Cloud Browser when needed.")
         .argument("<url>", "URL to read")
         .option("--format <format>", "Output format: html, markdown, or text", "text")
-        .option("--source <source>", "Read source: auto, unlocker, or browser", "auto")
+        .option("--source <source>", "Read source: auto, scraping, or browser. Legacy alias: unlocker", "auto")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();
         const format = normalizeReadFormat(options.format);

package/dist/commands/scrape.js

@@ -8,7 +8,7 @@ const output_1 = require("../lib/output");
 const unlocker_1 = require("../lib/unlocker");
 function buildScrapeCommand() {
     return (0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("scrape")
-        .description("Fetch rendered HTML through Gologin Web Unlocker.")
+        .description("Fetch rendered HTML through GoLogin Scraping API.")
         .argument("<url>", "URL to scrape")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();

package/dist/commands/scrapeJson.js

@@ -8,7 +8,7 @@ const structuredScrape_1 = require("../lib/structuredScrape");
 const shared_1 = require("./shared");
 function buildScrapeJsonCommand() {
     return (0, shared_1.addProfileOption)((0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("scrape-json")
-        .description("Fetch a page through Web Unlocker and print a structured JSON envelope.")
+        .description("Fetch a page through Scraping API and print a structured JSON envelope.")
         .argument("<url>", "URL to scrape")
         .option("--fallback <mode>", "none or browser structured fallback for JS-heavy pages", "none")
         .action(async (url, options) => {

package/dist/commands/scrapeMarkdown.js

@@ -9,9 +9,9 @@ const shared_1 = require("./shared");
 const output_1 = require("../lib/output");
 function buildScrapeMarkdownCommand() {
     return (0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("scrape-markdown")
-        .description("Fetch a page through Web Unlocker and print Markdown.")
+        .description("Fetch a page through Scraping API and print Markdown.")
         .argument("<url>", "URL to scrape")
-        .option("--source <source>", "Read source: auto, unlocker, or browser", "auto")
+        .option("--source <source>", "Read source: auto, scraping, or browser. Legacy alias: unlocker", "auto")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();
         const source = (0, readSource_1.normalizeReadSourceMode)(options.source, "auto");

package/dist/commands/scrapeText.js

@@ -9,9 +9,9 @@ const shared_1 = require("./shared");
 const output_1 = require("../lib/output");
 function buildScrapeTextCommand() {
     return (0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("scrape-text")
-        .description("Fetch a page through Web Unlocker and print plain text.")
+        .description("Fetch a page through Scraping API and print plain text.")
         .argument("<url>", "URL to scrape")
-        .option("--source <source>", "Read source: auto, unlocker, or browser", "auto")
+        .option("--source <source>", "Read source: auto, scraping, or browser. Legacy alias: unlocker", "auto")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();
         const source = (0, readSource_1.normalizeReadSourceMode)(options.source, "auto");

package/dist/commands/search.js

@@ -12,7 +12,7 @@ function buildSearchCommand() {
         .option("--limit <count>", "Maximum number of results", "10")
         .option("--country <country>", "Country code for Google search", "us")
         .option("--language <language>", "Language for Google search", "en")
-        .option("--source <mode>", "Search path: auto, unlocker, or browser", "auto")
+        .option("--source <mode>", "Search path: auto, scraping, or browser. Legacy alias: unlocker", "auto")
         .action(async (query, options) => {
         const config = await (0, config_1.loadConfig)();
         const result = await (0, search_1.searchWeb)(query, config, {
@@ -32,6 +32,9 @@ function normalizeLimit(value) {
     return Math.min(Math.floor(parsed), 100);
 }
 function normalizeSource(value) {
+    if (value === "scraping" || value === "scraping-api") {
+        return "unlocker";
+    }
     if (value === "auto" || value === "unlocker" || value === "browser") {
         return value;
     }

package/dist/config.js

@@ -22,13 +22,13 @@ const LEGACY_CONFIG_DIR = ".gologin-web";
 const CONFIG_FILENAME = "config.json";
 exports.DEFAULT_DAEMON_PORT = 4590;
 exports.ENV_NAMES = {
-    webUnlockerApiKey: "GOLOGIN_WEB_UNLOCKER_API_KEY",
+    webUnlockerApiKey: "GOLOGIN_SCRAPING_API_KEY",
     cloudToken: "GOLOGIN_TOKEN",
     defaultProfileId: "GOLOGIN_DEFAULT_PROFILE_ID",
     daemonPort: "GOLOGIN_DAEMON_PORT",
 };
 const LEGACY_ENV_NAMES = {
-    webUnlockerApiKey: ["GOLOGIN_WEBUNLOCKER_API_KEY"],
+    webUnlockerApiKey: ["GOLOGIN_WEB_UNLOCKER_API_KEY", "GOLOGIN_WEBUNLOCKER_API_KEY"],
     cloudToken: ["GOLOGIN_CLOUD_TOKEN"],
     defaultProfileId: ["GOLOGIN_PROFILE_ID"],
     daemonPort: [],
@@ -100,7 +100,7 @@ function requireWebUnlockerKey(config) {
 }
 function requireCloudToken(config) {
     if (!config.cloudToken) {
-        throw new errors_1.MissingCredentialError(exports.ENV_NAMES.cloudToken, "browser commands like `gologin-web-access open`");
+        throw new errors_1.MissingCredentialError(exports.ENV_NAMES.cloudToken, "browser and GoLogin API commands like `gologin-web-access open` or `gologin-web-access profile-proxy`");
     }
     return config.cloudToken;
 }
@@ -119,7 +119,7 @@ function getRecommendedCredentialStatus(config) {
         return {
             ready: true,
             missing,
-            detail: "complete (Web Unlocker + Cloud Browser configured)",
+            detail: "complete (Scraping API + Cloud Browser configured)",
         };
     }
     return {

package/dist/doctor.js

@@ -12,7 +12,7 @@ async function runDoctor(options = {}) {
     const agentCli = await (0, agentCli_1.inspectAgentCli)();
     const recommended = (0, config_1.getRecommendedCredentialStatus)(config);
     checks.push({
-        name: "Web Unlocker API key",
+        name: "Scraping API key",
         status: config.webUnlockerApiKey ? "ok" : "warn",
         detail: config.webUnlockerApiKey ? `configured via ${config.sources.webUnlockerApiKey}` : "missing",
     });
@@ -25,7 +25,7 @@ async function runDoctor(options = {}) {
         name: "Recommended full setup",
         status: recommended.ready ? "ok" : "warn",
         detail: recommended.ready
-            ? "both GOLOGIN_WEB_UNLOCKER_API_KEY and GOLOGIN_TOKEN are configured"
+            ? "both GOLOGIN_SCRAPING_API_KEY and GOLOGIN_TOKEN are configured"
             : `missing ${recommended.missing.join(" and ")}`,
     });
     checks.push({

package/dist/lib/cloudApi.js

@@ -1,9 +1,70 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.gologinApiRequest = gologinApiRequest;
+exports.asObjectPayload = asObjectPayload;
 exports.validateCloudToken = validateCloudToken;
 exports.getProfile = getProfile;
 const errors_1 = require("./errors");
 const GOLOGIN_API_BASE_URL = "https://api.gologin.com";
+function buildApiUrl(path, query) {
+    const url = new URL(path.startsWith("http") ? path : `${GOLOGIN_API_BASE_URL}${path}`);
+    for (const [key, value] of Object.entries(query ?? {})) {
+        if (value !== undefined) {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    return url.toString();
+}
+async function readPayload(response) {
+    const text = await response.text();
+    if (!text) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function formatApiErrorDetail(payload) {
+    if (!payload) {
+        return undefined;
+    }
+    if (typeof payload === "string") {
+        return payload.slice(0, 500);
+    }
+    if (typeof payload === "object") {
+        const value = payload;
+        for (const key of ["message", "error", "reason"]) {
+            if (typeof value[key] === "string" && value[key].length > 0) {
+                return value[key].slice(0, 500);
+            }
+        }
+        return JSON.stringify(value).slice(0, 500);
+    }
+    return String(payload).slice(0, 500);
+}
+async function gologinApiRequest(token, method, path, options = {}) {
+    const hasBody = options.body !== undefined;
+    const response = await fetch(buildApiUrl(path, options.query), {
+        method,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            ...(hasBody ? { "Content-Type": "application/json" } : {}),
+        },
+        body: hasBody ? JSON.stringify(options.body) : undefined,
+    });
+    const payload = await readPayload(response);
+    if (!response.ok) {
+        const detail = formatApiErrorDetail(payload);
+        throw new errors_1.HttpError(`GoLogin API ${method} ${path} failed with status ${response.status}.`, response.status, detail);
+    }
+    return payload;
+}
+function asObjectPayload(value) {
+    return value && typeof value === "object" ? value : {};
+}
 async function validateCloudToken(token) {
     const response = await fetch(`${GOLOGIN_API_BASE_URL}/browser/v2`, {
         headers: {

package/dist/lib/errors.js

@@ -26,7 +26,7 @@ class MissingCredentialError extends CliError {
     constructor(envName, commandGroup) {
         super(`Missing ${envName}. This is required for ${commandGroup}.`, 1, [
             "This CLI only reads credentials from environment variables or ~/.gologin-web-access/config.json.",
-            "Recommended setup: configure both GOLOGIN_WEB_UNLOCKER_API_KEY and GOLOGIN_TOKEN up front so agents do not stop to ask again.",
+            "Recommended setup: configure both GOLOGIN_SCRAPING_API_KEY and GOLOGIN_TOKEN up front so agents do not stop to ask again. GOLOGIN_WEB_UNLOCKER_API_KEY is still accepted as a legacy alias.",
             `Set ${envName} in your environment or add it to ~/.gologin-web-access/config.json.`,
             "Helpful commands: gologin-web-access config init, gologin-web-access config show, gologin-web-access doctor.",
         ].join("\n"));

package/dist/lib/output.js

@@ -16,7 +16,7 @@ function printText(value) {
     write(process.stdout, value);
 }
 function printJson(value) {
-    printText(JSON.stringify(value, null, 2));
+    printText(JSON.stringify(value ?? null, null, 2));
 }
 function printError(error) {
     if (error.message) {

package/dist/lib/readSource.js

@@ -16,6 +16,9 @@ function normalizeReadSourceMode(value, defaultMode = "auto") {
     if (!value) {
         return defaultMode;
     }
+    if (value === "scraping" || value === "scraping-api") {
+        return "unlocker";
+    }
     if (value === "auto" || value === "unlocker" || value === "browser") {
         return value;
     }

package/dist/lib/search.js

@@ -294,7 +294,7 @@ function classifySearchPage(engine, html, results) {
 }
 async function searchViaUnlocker(query, config, options, engine) {
     if (!config.webUnlockerApiKey) {
-        throw new errors_1.CliError("Missing GOLOGIN_WEB_UNLOCKER_API_KEY for unlocker search.");
+        throw new errors_1.CliError("Missing GOLOGIN_SCRAPING_API_KEY for Scraping API search.");
     }
     const searchUrl = buildSearchUrl(engine, query, options);
     const scraped = await (0, unlocker_1.scrapeRenderedHtml)(searchUrl, config.webUnlockerApiKey);

package/dist/lib/unlocker.js

@@ -44,7 +44,7 @@ class WebUnlockerClient {
         });
         if (!response.ok) {
             const body = await safeReadText(response, this.timeoutMs);
-            throw new errors_1.HttpError(`Web Unlocker request failed with status ${response.status}.`, response.status, body ? truncate(body, 300) : undefined);
+            throw new errors_1.HttpError(`Scraping API request failed with status ${response.status}.`, response.status, body ? truncate(body, 300) : undefined);
         }
         const content = await readResponseTextWithTimeout(response, this.timeoutMs);
         return {
@@ -132,7 +132,7 @@ async function fetchWithRetry(url, options) {
                 };
             }
             const body = await safeReadText(response, options.timeoutMs);
-            const error = new errors_1.HttpError(`Web Unlocker request failed with status ${response.status}.`, response.status, body ? truncate(body, 300) : undefined);
+            const error = new errors_1.HttpError(`Scraping API request failed with status ${response.status}.`, response.status, body ? truncate(body, 300) : undefined);
             const retriable = attempt < options.maxRetries && isRetriableStatus(response.status);
             attempts.push({
                 attempt: attempt + 1,
@@ -154,10 +154,10 @@ async function fetchWithRetry(url, options) {
                 throw error;
             }
             const normalizedError = error instanceof Error && error.name === "AbortError"
-                ? new errors_1.HttpError("Web Unlocker request timed out.", 408)
+                ? new errors_1.HttpError("Scraping API request timed out.", 408)
                 : error instanceof Error
                     ? new errors_1.HttpError(error.message, 500)
-                    : new errors_1.HttpError("Web Unlocker request failed.", 500);
+                    : new errors_1.HttpError("Scraping API request failed.", 500);
             const retriable = attempt < options.maxRetries;
             attempts.push({
                 attempt: attempt + 1,
@@ -175,11 +175,11 @@ async function fetchWithRetry(url, options) {
         throw attachRequestMeta(lastStatusError, attempts);
     }
     if (lastError instanceof Error && lastError.name === "AbortError") {
-        throw attachRequestMeta(new errors_1.HttpError("Web Unlocker request timed out.", 408), attempts);
+        throw attachRequestMeta(new errors_1.HttpError("Scraping API request timed out.", 408), attempts);
     }
     throw attachRequestMeta(lastError instanceof Error
         ? new errors_1.HttpError(lastError.message, 500)
-        : new errors_1.HttpError("Web Unlocker request failed.", 500), attempts);
+        : new errors_1.HttpError("Scraping API request failed.", 500), attempts);
 }
 function buildScrapeRequestMeta(attempts) {
     return {
@@ -230,7 +230,7 @@ async function readResponseTextWithTimeout(response, timeoutMs) {
             new Promise((_, reject) => {
                 timer = setTimeout(() => {
                     void response.body?.cancel().catch(() => undefined);
-                    reject(new errors_1.HttpError("Web Unlocker response body timed out.", 408));
+                    reject(new errors_1.HttpError("Scraping API response body timed out.", 408));
                 }, timeoutMs);
             }),
         ]);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gologin-web-access",
-  "version": "0.3.2",
-  "description": "Unified web access CLI for developers and AI agents to read and interact with the web using Gologin Web Unlocker and Cloud Browser.",
+  "version": "0.3.4",
+  "description": "Unified web access CLI for developers and AI agents to read and interact with the web using the GoLogin Scraping API and Cloud Browser.",
   "main": "dist/cli.js",
   "bin": {
     "gologin-web-access": "dist/cli.js"
@@ -39,6 +39,7 @@
     "gologin",
     "web-access",
     "cli",
+    "scraping-api",
     "webunlocker",
     "scraping",
     "cloud-browser",