gologin-web-access 0.3.3 → 0.3.5

package/CHANGELOG.md

@@ -2,9 +2,15 @@
 
 ## 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.5 - 2026-05-14
+
+- renamed the internal stateless scraping layer from Web Unlocker to Scraping API
+- config files now write `scrapingApiKey`, while legacy `webUnlockerApiKey` configs and old env aliases still load
+- `renderSource` and search transport values now use `scraping`; `unlocker` remains accepted as a legacy `--source` alias
+
 ## 0.3.2 - 2026-04-03
 
 - added unified page outcome classification across `read`, `scrape-json`, and `batch-scrape`
@@ -17,9 +23,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.
@@ -229,7 +229,7 @@ You can also write a minimal config file at `~/.gologin-web-access/config.json`:
 
 ```json
 {
-  "webUnlockerApiKey": "wu_...",
+  "scrapingApiKey": "wu_...",
   "cloudToken": "gl_...",
   "defaultProfileId": "profile_123",
   "daemonPort": 4590
@@ -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.5";
 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/batchChangeTrack.js

@@ -13,7 +13,7 @@ const concurrency_1 = require("../lib/concurrency");
 const output_1 = require("../lib/output");
 const shared_1 = require("./shared");
 function buildBatchChangeTrackCommand() {
-    return (0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("batch-change-track")
+    return (0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("batch-change-track")
         .description("Track multiple pages over time and report which ones are new, same, or changed.")
         .argument("<urls...>", "One or more URLs")
         .option("--format <format>", "html, markdown, text, or json", "markdown")
@@ -22,10 +22,10 @@ function buildBatchChangeTrackCommand() {
         .option("--summary", "Print one-line status counts to stderr after the JSON output")
         .action(async (urls, options) => {
         const config = await (0, config_1.loadConfig)();
-        const apiKey = (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = (0, config_1.requireScrapingApiKey)(config);
         const format = (0, changeTracking_1.normalizeTrackingFormat)(options.format);
         const concurrency = Math.max(1, Number(options.concurrency) || 4);
-        const requestOptions = (0, shared_1.normalizeUnlockerRequestOptions)(options);
+        const requestOptions = (0, shared_1.normalizeScrapingApiRequestOptions)(options);
         const results = await (0, concurrency_1.mapWithConcurrency)(urls, concurrency, async (url) => {
             try {
                 const key = (0, changeTracking_1.buildTrackingKey)(url);

package/dist/commands/batchExtract.js

@@ -14,21 +14,21 @@ const output_1 = require("../lib/output");
 const readSource_1 = require("../lib/readSource");
 const shared_1 = require("./shared");
 function buildBatchExtractCommand() {
-    return (0, shared_1.addProfileOption)((0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("batch-extract")
+    return (0, shared_1.addProfileOption)((0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("batch-extract")
         .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")
         .action(async (urls, options) => {
         const config = await (0, config_1.loadConfig)();
         const source = (0, readSource_1.normalizeReadSourceMode)(options.source, "auto");
-        const apiKey = source === "browser" ? "" : (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = source === "browser" ? "" : (0, config_1.requireScrapingApiKey)(config);
         const schema = await readSchema(path_1.default.resolve(options.schema));
         const concurrency = Math.max(1, Number(options.concurrency) || 4);
-        const request = (0, shared_1.normalizeUnlockerRequestOptions)(options);
+        const request = (0, shared_1.normalizeScrapingApiRequestOptions)(options);
         const results = await (0, concurrency_1.mapWithConcurrency)(urls, concurrency, async (url) => {
             try {
                 return {

package/dist/commands/batchScrape.js

@@ -13,16 +13,16 @@ const config_1 = require("../config");
 const output_1 = require("../lib/output");
 const readSource_1 = require("../lib/readSource");
 const structuredScrape_1 = require("../lib/structuredScrape");
-const unlocker_1 = require("../lib/unlocker");
+const scrapingApi_1 = require("../lib/scrapingApi");
 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.")
+    return (0, shared_1.addProfileOption)((0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("batch-scrape")
+        .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")
@@ -32,9 +32,9 @@ function buildBatchScrapeCommand() {
         const format = normalizeFormat(options.format);
         const source = (0, readSource_1.normalizeReadSourceMode)(options.source, "auto");
         const usingBrowserOnlyMainContent = Boolean(options.onlyMainContent) && format !== "json" && source === "browser";
-        const apiKey = usingBrowserOnlyMainContent ? "" : (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = usingBrowserOnlyMainContent ? "" : (0, config_1.requireScrapingApiKey)(config);
         const concurrency = Math.max(1, Number(options.concurrency) || 4);
-        const requestOptions = (0, shared_1.normalizeUnlockerRequestOptions)(options);
+        const requestOptions = (0, shared_1.normalizeScrapingApiRequestOptions)(options);
         const fallback = (0, structuredScrape_1.normalizeStructuredFallbackMode)(options.fallback);
         const results = await mapWithConcurrency(urls, concurrency, async (url) => {
             try {
@@ -120,15 +120,15 @@ async function formatOutput(url, config, apiKey, format, requestOptions, fallbac
     switch (format) {
         case "html":
             return {
-                output: (await (0, unlocker_1.scrapeRenderedHtml)(url, apiKey, requestOptions)).content,
+                output: (await (0, scrapingApi_1.scrapeRenderedHtml)(url, apiKey, requestOptions)).content,
             };
         case "markdown":
             return {
-                output: (await (0, unlocker_1.scrapeMarkdown)(url, apiKey, requestOptions)).markdown,
+                output: (await (0, scrapingApi_1.scrapeMarkdown)(url, apiKey, requestOptions)).markdown,
             };
         case "text":
             return {
-                output: (await (0, unlocker_1.scrapeText)(url, apiKey, requestOptions)).text,
+                output: (await (0, scrapingApi_1.scrapeText)(url, apiKey, requestOptions)).text,
             };
         case "json":
             return mapStructuredBatchResult(await (0, structuredScrape_1.scrapeStructuredJson)(url, config, apiKey, {
@@ -137,7 +137,7 @@ async function formatOutput(url, config, apiKey, format, requestOptions, fallbac
             }));
         default:
             return {
-                output: (await (0, unlocker_1.scrapeRenderedHtml)(url, apiKey, requestOptions)).content,
+                output: (await (0, scrapingApi_1.scrapeRenderedHtml)(url, apiKey, requestOptions)).content,
             };
     }
 }

package/dist/commands/changeTrack.js

@@ -12,7 +12,7 @@ const changeTracking_1 = require("../lib/changeTracking");
 const output_1 = require("../lib/output");
 const shared_1 = require("./shared");
 function buildChangeTrackCommand() {
-    return (0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("change-track")
+    return (0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("change-track")
         .description("Track a page over time and report whether it changed since the last snapshot.")
         .argument("<url>", "Target URL")
         .option("--format <format>", "html, markdown, text, or json", "markdown")
@@ -21,10 +21,10 @@ function buildChangeTrackCommand() {
         .option("--output <path>", "Write the current tracking result to a file")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();
-        const apiKey = (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = (0, config_1.requireScrapingApiKey)(config);
         const format = (0, changeTracking_1.normalizeTrackingFormat)(options.format);
         const key = (0, changeTracking_1.buildTrackingKey)(url, options.key);
-        const snapshot = await (0, changeTracking_1.scrapeForTracking)(url, apiKey, format, (0, shared_1.normalizeUnlockerRequestOptions)(options));
+        const snapshot = await (0, changeTracking_1.scrapeForTracking)(url, apiKey, format, (0, shared_1.normalizeScrapingApiRequestOptions)(options));
         const result = await (0, changeTracking_1.compareAndPersistSnapshot)(config, {
             key,
             url,

package/dist/commands/configInit.js

@@ -5,12 +5,13 @@ const commander_1 = require("commander");
 const config_1 = require("../config");
 const cloudApi_1 = require("../lib/cloudApi");
 const output_1 = require("../lib/output");
-const unlocker_1 = require("../lib/unlocker");
+const scrapingApi_1 = require("../lib/scrapingApi");
 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,9 +19,14 @@ 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 scrapingApiKey = options.scrapingApiKey ??
+            options.webUnlockerApiKey ??
+            options.webUnlockerKey ??
+            process.env[config_1.ENV_NAMES.scrapingApiKey] ??
+            process.env.GOLOGIN_WEB_UNLOCKER_API_KEY ??
+            process.env.GOLOGIN_WEBUNLOCKER_API_KEY;
         const result = await (0, config_1.initConfigFile)({
-            webUnlockerApiKey,
+            scrapingApiKey,
             cloudToken: options.token ??
                 options.cloudToken ??
                 process.env[config_1.ENV_NAMES.cloudToken] ??
@@ -37,8 +43,8 @@ function buildConfigInitCommand() {
         (0, output_1.printKeyValueRows)([
             { label: "Config file", value: result.path },
             {
-                label: "Web Unlocker key",
-                value: result.config.webUnlockerApiKey ? "written" : "left empty",
+                label: "Scraping API key",
+                value: result.config.scrapingApiKey ? "written" : "left empty",
             },
             {
                 label: "GoLogin token",
@@ -53,17 +59,17 @@ function buildConfigInitCommand() {
                 value: String(result.config.daemonPort ?? config_1.DEFAULT_DAEMON_PORT),
             },
         ]);
-        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.");
+        if (!result.config.scrapingApiKey || !result.config.cloudToken) {
+            (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;
         }
         const validationRows = [];
-        if (result.config.webUnlockerApiKey) {
-            const validation = await (0, unlocker_1.validateWebUnlockerKey)(result.config.webUnlockerApiKey);
+        if (result.config.scrapingApiKey) {
+            const validation = await (0, scrapingApi_1.validateScrapingApiKey)(result.config.scrapingApiKey);
             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")
@@ -22,7 +22,7 @@ function buildCrawlCommand() {
         .option("--strict", "Exit non-zero when any page fails during crawling")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();
-        const apiKey = (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = (0, config_1.requireScrapingApiKey)(config);
         const format = normalizeFormat(options.format);
         const result = await (0, crawl_1.crawlSite)(url, apiKey, format, {
             limit: normalizePositiveInt(options.limit, 25),

package/dist/commands/crawlStart.js

@@ -21,7 +21,7 @@ function buildCrawlStartCommand() {
         .option("--only-main-content", "For html, markdown, or text output, isolate the most readable content block on each page")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();
-        (0, config_1.requireWebUnlockerKey)(config);
+        (0, config_1.requireScrapingApiKey)(config);
         const args = buildCrawlArgs(url, options);
         const job = await (0, jobRegistry_1.createJob)(config, {
             kind: "crawl",

package/dist/commands/extract.js

@@ -13,20 +13,20 @@ const output_1 = require("../lib/output");
 const readSource_1 = require("../lib/readSource");
 const shared_1 = require("./shared");
 function buildExtractCommand() {
-    return (0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("extract")
+    return (0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("extract")
         .description("Extract structured data from a page using a selector schema.")
         .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");
-        const apiKey = source === "browser" ? "" : (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = source === "browser" ? "" : (0, config_1.requireScrapingApiKey)(config);
         const schema = await readSchema(path_1.default.resolve(options.schema));
         const result = await (0, extractRunner_1.extractUrlWithSchema)(url, config, apiKey, schema, {
             source,
-            request: (0, shared_1.normalizeUnlockerRequestOptions)(options),
+            request: (0, shared_1.normalizeScrapingApiRequestOptions)(options),
         });
         if (options.output) {
             const outputPath = path_1.default.resolve(options.output);

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")
@@ -20,7 +20,7 @@ function buildMapCommand() {
         .option("--strict", "Exit non-zero when any page fails during mapping")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();
-        const apiKey = (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = (0, config_1.requireScrapingApiKey)(config);
         const result = await (0, crawl_1.mapSite)(url, apiKey, {
             limit: normalizePositiveInt(options.limit, 100),
             maxDepth: normalizeNonNegativeInt(options.maxDepth, 2),

package/dist/commands/read.js

@@ -8,20 +8,20 @@ const readSource_1 = require("../lib/readSource");
 const output_1 = require("../lib/output");
 const shared_1 = require("./shared");
 function buildReadCommand() {
-    return (0, shared_1.addProfileOption)((0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("read")
+    return (0, shared_1.addProfileOption)((0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("read")
         .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);
         const source = (0, readSource_1.normalizeReadSourceMode)(options.source, "auto");
-        const apiKey = source === "browser" ? "" : (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = source === "browser" ? "" : (0, config_1.requireScrapingApiKey)(config);
         const readOptions = {
             source,
             profile: options.profile,
-            request: (0, shared_1.normalizeUnlockerRequestOptions)(options),
+            request: (0, shared_1.normalizeScrapingApiRequestOptions)(options),
         };
         const result = format === "html"
             ? await (0, readSource_1.readHtmlContent)(url, config, apiKey, readOptions)

package/dist/commands/scrape.js

@@ -5,15 +5,15 @@ const commander_1 = require("commander");
 const config_1 = require("../config");
 const shared_1 = require("./shared");
 const output_1 = require("../lib/output");
-const unlocker_1 = require("../lib/unlocker");
+const scrapingApi_1 = require("../lib/scrapingApi");
 function buildScrapeCommand() {
-    return (0, shared_1.addUnlockerRequestOptions)(new commander_1.Command("scrape")
-        .description("Fetch rendered HTML through Gologin Web Unlocker.")
+    return (0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("scrape")
+        .description("Fetch rendered HTML through GoLogin Scraping API.")
         .argument("<url>", "URL to scrape")
         .action(async (url, options) => {
         const config = await (0, config_1.loadConfig)();
-        const apiKey = (0, config_1.requireWebUnlockerKey)(config);
-        const result = await (0, unlocker_1.scrapeRenderedHtml)(url, apiKey, (0, shared_1.normalizeUnlockerRequestOptions)(options));
+        const apiKey = (0, config_1.requireScrapingApiKey)(config);
+        const result = await (0, scrapingApi_1.scrapeRenderedHtml)(url, apiKey, (0, shared_1.normalizeScrapingApiRequestOptions)(options));
         (0, output_1.printText)(result.content);
     }));
 }

package/dist/commands/scrapeJson.js

@@ -7,21 +7,21 @@ const output_1 = require("../lib/output");
 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.")
+    return (0, shared_1.addProfileOption)((0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("scrape-json")
+        .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) => {
         const config = await (0, config_1.loadConfig)();
-        const apiKey = (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = (0, config_1.requireScrapingApiKey)(config);
         const envelope = await (0, structuredScrape_1.scrapeStructuredJson)(url, config, apiKey, {
             fallback: (0, structuredScrape_1.normalizeStructuredFallbackMode)(options.fallback),
             profile: options.profile,
-            request: (0, shared_1.normalizeUnlockerRequestOptions)(options),
+            request: (0, shared_1.normalizeScrapingApiRequestOptions)(options),
         });
         if (envelope.fallbackAttempted) {
             const fallbackStatus = envelope.fallbackUsed
-                ? "Browser fallback succeeded and replaced the unlocker result."
+                ? "Browser fallback succeeded and replaced the Scraping API result."
                 : `Browser fallback was attempted but not used. ${envelope.fallbackReason ?? "It did not improve the structured output."}`;
             process.stderr.write(`${fallbackStatus}\n`);
         }

package/dist/commands/scrapeMarkdown.js

@@ -8,17 +8,17 @@ const readSource_1 = require("../lib/readSource");
 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.")
+    return (0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("scrape-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");
-        const apiKey = source === "browser" ? "" : (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = source === "browser" ? "" : (0, config_1.requireScrapingApiKey)(config);
         const result = await (0, readSource_1.readMarkdownContent)(url, config, apiKey, {
             source,
-            request: (0, shared_1.normalizeUnlockerRequestOptions)(options),
+            request: (0, shared_1.normalizeScrapingApiRequestOptions)(options),
         });
         emitReadNotice(result);
         (0, output_1.printText)(result.content);

package/dist/commands/scrapeText.js

@@ -8,17 +8,17 @@ const readSource_1 = require("../lib/readSource");
 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.")
+    return (0, shared_1.addScrapingApiRequestOptions)(new commander_1.Command("scrape-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");
-        const apiKey = source === "browser" ? "" : (0, config_1.requireWebUnlockerKey)(config);
+        const apiKey = source === "browser" ? "" : (0, config_1.requireScrapingApiKey)(config);
         const result = await (0, readSource_1.readTextContent)(url, config, apiKey, {
             source,
-            request: (0, shared_1.normalizeUnlockerRequestOptions)(options),
+            request: (0, shared_1.normalizeScrapingApiRequestOptions)(options),
         });
         emitReadNotice(result);
         (0, output_1.printText)(result.content);