Zenrows CLI is the open-source command-line, MCP, skills, templates, workflows, recipes, and evals layer for giving AI agents reliable access to protected web data through Zenrows cloud infrastructure.
It makes the Zenrows Universal Scraper API, Scraping Browser, and Residential Proxies installable and usable directly from AI agents and developer workflows — so an agent can reliably access protected web data without hand-rolling anti-bot handling, proxies, or browser rendering.
A single, dependency-light CLI (zenrows) plus an installable asset registry
(skills, templates, workflows, recipes, evals) and MCP configuration for popular
agent clients. It makes Zenrows installable, usable, testable, and distributable
through AI agents, developers, and teams.
Normal fetch fails. Generic scrapers fail. Browser-first tools are expensive. The Zenrows Universal Scraper API retrieves protected pages reliably and structures them, while the Scraping Browser is there for the rare cases that need a real browser. Zenrows wins when the workflow runs over thousands or millions of URLs.
The core product is the Zenrows Universal Scraper API
(GET https://api.zenrows.com/v1/). The CLI exposes it two ways: zenrows fetch
retrieves a protected page, and zenrows extract turns it into structured data
(JSON / CSS / Markdown). Both call the same endpoint — extract is just
that endpoint with extraction parameters, not a separate product.
| Command | What it does | Status (this build) |
|---|---|---|
zenrows fetch |
Universal Scraper API — retrieve a protected page | available — GET https://api.zenrows.com/v1/ |
zenrows extract |
Universal Scraper API — structured extraction (Autoparse / CSS / Markdown) | available — same /v1/ |
zenrows batch |
Batch Scraper API — fan out over many URLs | beta — cloud works with beta access; local validate/estimate always |
zenrows browser |
Scraping Browser (CDP) / MCP escalation | experimental |
zenrows mcp |
MCP server config (remote + local) | available |
| Zenrows CLI | this repo | available |
The CLI maintains a capability matrix (registry/capabilities.json). Every
command checks status before any cloud call, so the toolkit never fakes behavior
for primitives the backend does not expose. Run zenrows status for the live
matrix.
npx -y @zenrows/cli init
zenrows fetch https://httpbin.io/html # auto-provisions a Free plan account on first use
zenrows extract https://www.scrapingcourse.com/ecommerce/ --autoparseNo API key up front: on your first cloud call the toolkit creates a free, unclaimed Zenrows Free plan account for you (see §6).
zenrows init --all # workspace + config + policy + assets + MCP snippets + health check
zenrows init --agents claude-code,codex,cursor,gemini,opencode,windsurf,vscodeIf a requested target cannot be auto-configured, the toolkit prints explicit manual instructions rather than silently skipping it.
You do not need an API key to get started. On your first cloud call
(e.g. zenrows fetch <url>), the toolkit automatically creates a free,
unclaimed Zenrows Free plan account, stores the key in .zenrows/secrets.json
(0600, gitignored), and records the account in .zenrows/account.json
(no secret — just the accountId, Free-period info, and a claim link).
When you (or your agent) want to keep the usage and history, claim the account — this sets an email + password; the same key keeps working:
zenrows account status # show account + Free period + claim link
zenrows account claim # open the claim URL in the browser
zenrows usage # plan usage, credits & concurrency (does not count against your limit)Opt out of auto-provisioning at any time:
zenrows fetch <url> --no-signup # do not auto-create an account for this call
zenrows signup --agent # explicitly provision a Free plan account, headless
zenrows login --api-key <key> # use an existing key (stored 0600, gitignored)
zenrows login --env # use the ZENROWS_API_KEY environment variableSet auto_signup: false in .zenrows/policy.json to disable auto-provisioning
globally.
zenrows fetch <url> # Adaptive Stealth Mode (mode=auto)
zenrows fetch <url> --output markdown
zenrows fetch <url> --manual --js-render --premium-proxy
zenrows fetch <url> --proxy-country us --wait-for ".price"zenrows extract <url> --autoparse
zenrows extract <url> --css '{"title":"h1","price":".price"}' --validate
zenrows extract <url> --output markdownThe Zenrows Batch Scraper API (https://async.api.zenrows.com/v1) fans a
protected fetch/extract out over many URLs. It is a real product in
beta: the cloud subcommands work once your API key has
beta access; without it the API returns BATCH_ACCESS_DENIED. Local spec
validation + credit estimation always work (no key needed).
zenrows batch estimate jobs.jsonl # validate the spec + estimate credits (local)
zenrows batch create jobs.jsonl --wait # submit a job and wait for it to finish
zenrows batch status <job-id> # run status + progress stats
zenrows batch results <job-id> --out results.jsonl # collect results (paginated)
zenrows batch cancel <job-id> # stop an in-flight runjobs.jsonl is one JSON object per line, each with a url (plus optional
per-line overrides like js_render, premium_proxy, proxy_country). Request
beta access from Zenrows to run in the cloud; until then, validate/estimate
locally or fan out with zenrows fetch per URL.
Escalation only, gated by policy.allow_browser. Backed by the Zenrows Scraping
Browser (CDP) and the @zenrows/mcp browser_* tools.
zenrows mcp status
zenrows mcp config --client claude-code # exact `claude mcp add` command
zenrows mcp config --client cursor # mcpServers JSON
zenrows mcp config --client vscode # servers JSON
zenrows mcp config --client generic --remote # hosted server at https://mcp.zenrows.com/mcpLocal server: npx -y @zenrows/mcp (env ZENROWS_API_KEY). Remote server:
https://mcp.zenrows.com/mcp.
zenrows plugin list
zenrows plugin install claude-code # installs core skills + prints MCP configAgent-readable playbooks that teach agents how to choose primitives.
zenrows skill list
zenrows skill install --all
zenrows skill validate zenrowsThe master skill skills/zenrows/SKILL.md teaches the full decision tree.
zenrows template list
zenrows template create protected-fetch-node --output ./my-projectzenrows workflow list
zenrows workflow explain competitor-intelligencezenrows recipe list
zenrows recipe run fetch-protected-pageReproducible, transparent benchmarks. No competitor keys are bundled and nothing is hardcoded to make Zenrows win — comparison evals require you to supply your own credentials.
zenrows eval list
zenrows eval run protected-fetch-smoke
zenrows eval report protected-fetch-smokeReports write input.json, results.json, report.md, failures.jsonl,
cost.json, and traces/ under .zenrows/evals/<run-id>/.
- API keys are never printed or written into run artifacts/assets.
- Secrets live in
.zenrows/secrets.json(0600, gitignored); logs are redacted. .zenrows/account.jsonholds no secret — only the accountId, Free-period info, and claim link..zenrows/policy.jsonenforces credit/page/concurrency limits and domain allow/deny.- Destructive
uninstallrequires--yes. Browser and experimental are off by default.
See registry/capabilities.json. zenrows status --json emits it.
The CLI is TypeScript with zero runtime dependencies (native fetch,
node:util parseArgs, node:test). Node 20+ runs the published build;
Node 23.6+ runs the TypeScript sources directly for development.
Zenrows is building the protected web data infrastructure layer. The Zenrows CLI is how that infrastructure becomes native to AI agents.