@zenrows/cli 1.5.1 → 1.5.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +9 -9
  2. package/dist/src/core/config.js +1 -1
  3. package/package.json +1 -1
  4. package/skills/zenrows/SKILL.md +11 -6
package/README.md CHANGED
@@ -36,13 +36,13 @@ that endpoint with extraction parameters, not a separate product.
36
36
 
37
37
  | Command | What it does | Status (this build) |
38
38
  | --- | --- | --- |
39
- | `zenrows fetch` | Fetch — retrieve a protected page | **available** — `GET https://api.zenrows.com/v1/` |
40
- | `zenrows extract` | Extract: `extract=auto` (any prepared domain; falls back to Autoparse on one not prepared yet), CSS, or Markdown | available, same `/v1/` |
41
- | `zenrows batch` | Batch: fan out over many URLs | **available**: `https://async.api.zenrows.com/v1`; local validate/estimate need no key |
42
- | `zenrows crawl` | Crawl (new) — collect the URLs behind one start page, optionally with each page's HTML | **available** — `https://api.zenrows.com/v1/crawls` |
43
- | `zenrows browser` | Browser Sessions REST API (same backend as MCP `browser_*`) | **available** — escalation-only; bills by bandwidth + time |
44
- | `zenrows mcp` | MCP server config (remote + local) | **available** |
45
- | Zenrows CLI | this repo | available |
39
+ | `zenrows fetch` | Fetch: retrieve a protected page | **available**: `GET https://api.zenrows.com/v1/` |
40
+ | `zenrows extract` | Extract: turn a page into structured data with `extract=auto` on any prepared domain (falls back to Autoparse on one not prepared yet), CSS selectors, or Markdown | **available**: `GET https://api.zenrows.com/v1/?extract=auto` |
41
+ | `zenrows batch` | Batch: run Fetch and Extract over many URLs in one job; specs validate and estimate locally with no key | **available**: `POST https://async.api.zenrows.com/v1/jobs` |
42
+ | `zenrows crawl` | Crawl (new): collect the URLs behind one start page, optionally with each page's HTML | **available**: `POST https://api.zenrows.com/v1/crawls` |
43
+ | `zenrows browser` | Browser Sessions: a real cloud browser over REST (same backend as MCP `browser_*`); escalation-only, billed by bandwidth + time | **available**: `POST https://mcp.zenrows.com/browser/sessions` |
44
+ | `zenrows mcp` | MCP: set up the Zenrows MCP server in your client, remote or local | **available**: `https://mcp.zenrows.com/mcp` |
45
+ | `zenrows` | CLI: this repo, the commands above, plus skills and templates | **available**: `npm install -g @zenrows/cli` |
46
46
 
47
47
  The CLI maintains a **capability matrix** (`registry/capabilities.json`). Every
48
48
  command checks status before any cloud call, so the toolkit never fakes behavior
@@ -55,7 +55,7 @@ matrix.
55
55
  npm install -g @zenrows/cli # puts `zenrows` on PATH (466 ms, zero deps)
56
56
  zenrows init
57
57
  zenrows fetch https://httpbin.io/html # auto-provisions a Free plan account on first use
58
- zenrows extract https://www.owler.com/company/meltwater # extract=auto on an enabled domain
58
+ zenrows extract https://www.owler.com/company/meltwater # extract=auto on a prepared domain
59
59
  zenrows extract https://www.scrapingcourse.com/ecommerce/ --autoparse # Autoparse (any domain)
60
60
  ```
61
61
 
@@ -116,7 +116,7 @@ zenrows fetch <url> --proxy-country us --wait-for ".price"
116
116
  ## 8. Extract
117
117
 
118
118
  ```bash
119
- zenrows extract https://www.owler.com/company/meltwater # extract=auto (enabled domain)
119
+ zenrows extract https://www.owler.com/company/meltwater # extract=auto (prepared domain)
120
120
  zenrows extract https://www.scrapingcourse.com/ecommerce/ --autoparse # Autoparse (any domain)
121
121
  zenrows extract <url> --css '{"title":"h1","price":".price"}' --validate
122
122
  zenrows extract <url> --outputs emails,links # built-in output filters → JSON
package/dist/src/core/config.js CHANGED
@@ -14,7 +14,7 @@ export const CONFIG_VERSION = "0.1.0";
14
14
  * entrypoint) so core modules — telemetry, signup provenance — can read it
15
15
  * without an import cycle. `VERSION` in `cli/index.ts` re-exports this.
16
16
  */
17
- export const CLI_VERSION = "1.5.1";
17
+ export const CLI_VERSION = "1.5.3";
18
18
  /** The User-Agent on every request to a Zenrows API. The gateway reads the version from it. */
19
19
  export const CLI_USER_AGENT = `zenrows-cli/${CLI_VERSION}`;
20
20
  /** Env var to override the Fetch and Extract API base (local/staging testing). */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zenrows/cli",
3
- "version": "1.5.1",
3
+ "version": "1.5.3",
4
4
  "description": "Open-source CLI, MCP, skills, templates, workflows, recipes, and evals layer for giving AI agents reliable access to protected web data through Zenrows cloud infrastructure.",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/skills/zenrows/SKILL.md CHANGED
@@ -71,12 +71,17 @@ Run `zenrows status` for the live capability matrix. As of this toolkit:
71
71
 
72
72
  | Primitive | Command | Status |
73
73
  | --- | --- | --- |
74
- | Protected Fetch | `zenrows fetch` | available (`GET /v1/`) |
75
- | Extract (extract=auto / Autoparse/CSS/Markdown) | `zenrows extract` | available (same `/v1/`; extract=auto falls back to autoparse) |
76
- | Batch | `zenrows batch` | available: runs cloud jobs (create/status/results); cheapest path at scale. Estimate specs locally with no key |
77
- | Crawl | `zenrows crawl` | new — collect the URLs behind one start page, optionally with each page's HTML |
78
- | Browser | `zenrows browser` | available (Browser Sessions REST API / MCP) |
79
- | MCP | `zenrows mcp` | available (remote + local server) |
74
+ | Protected Fetch | `zenrows fetch` | **available**: `GET https://api.zenrows.com/v1/` |
75
+ | Extract (`extract=auto`, Autoparse, CSS, Markdown) | `zenrows extract` | **available**: `GET https://api.zenrows.com/v1/?extract=auto` |
76
+ | Batch | `zenrows batch` | **available**: `POST https://async.api.zenrows.com/v1/jobs` |
77
+ | Crawl (new) | `zenrows crawl` | **available**: `POST https://api.zenrows.com/v1/crawls` |
78
+ | Browser | `zenrows browser` | **available**: `POST https://mcp.zenrows.com/browser/sessions` |
79
+ | MCP | `zenrows mcp` | **available**: `https://mcp.zenrows.com/mcp` |
80
+
81
+ - Extract: `extract=auto` falls back to Autoparse on a domain not prepared yet.
82
+ - Batch: the cheapest path at scale (create, status, results). Estimate specs locally with no key.
83
+ - Crawl: collects the URLs behind one start page, optionally with each page's HTML.
84
+ - Browser: escalation-only, for pages Fetch can't handle; same backend as the MCP `browser_*` tools.
80
85
 
81
86
  Protected Fetch and Extract are the same API (`GET /v1/`) used two ways.
82
87
  The command consults the capability matrix before any cloud call — it never