gologin-web-access 0.3.3 → 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,6 +1,6 @@
 # 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.
 
@@ -18,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.
@@ -36,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>`
@@ -111,7 +111,7 @@ 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 Web Unlocker and do not start the browser daemon:
+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]`
@@ -185,7 +185,7 @@ 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`, GoLogin API helper commands, and profile validation in `gologin-web-access doctor`.
@@ -194,16 +194,16 @@ This CLI uses two different GoLogin credentials on purpose, because the underlyi
 - `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"
@@ -218,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.
@@ -266,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
@@ -332,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.
@@ -370,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

@@ -68,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.3";
+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();
@@ -174,7 +174,7 @@ Command groups:
   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/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: [],
@@ -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/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/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.3",
-  "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",