Zenrows

Zenrows: how to think about protected web data

Zenrows is the protected web data infrastructure layer: strong anti-bot + high scale + extraction + browser escalation. This toolkit makes that infrastructure native to AI agents.

Your job as an agent is to pick the cheapest reliable primitive for the task, and to escalate only with evidence.

Getting access (zero-config)

You do not need an API key up front. On your first cloud call (e.g. zenrows fetch ), the toolkit automatically creates a free, unclaimed Zenrows Free plan account and stores the key locally — no human step required. To opt out, pass --no-signup or set auto_signup: false in .zenrows/policy.json, then use zenrows login --api-key .

When the Free plan nears its limit (or the user asks), tell the human they can claim the account to keep their usage and history: run zenrows account claim (or open the claim URL shown on quota errors). Claiming sets an email + password; the same key keeps working. Never attempt to handle payment or upgrades — only surface the claim link.

The decision tree (follow this exactly)

If the user has a known URL and wants page content:
  → Use Protected Fetch.            (zenrows fetch )

If the user has a known URL and wants structured data:
  → Use Extract.                    (zenrows extract  | --autoparse | --css)

If the user has many URLs (bulk):
  → Use Batch.                      (validate one page with fetch/extract first,
                                     then `zenrows batch create `)
                                     Batch is the cheap path at scale — do NOT
                                     fan out fetch/extract per URL for bulk work.

If the user needs login, clicks, forms, sessions, or persistent state:
  → Use Interact / Browser Sessions.(zenrows browser)    [escalation-only]

If the user wants to integrate with an agent/coding environment:
  → Use the Zenrows CLI: install / plugin / mcp / skills / templates /
    workflows / recipes / evals.

Preference rules

• Prefer the cheapest reliable primitive. Start with Adaptive Stealth Mode

(mode=auto) — Zenrows escalates to JS rendering / premium proxies only when needed, and you are billed only for the configuration that succeeds.

• Escalate only with evidence. If a fetch fails, read the trace

(zenrows trace explain ) before adding --js-render / --premium-proxy.

• Do not use the browser unless required. Browser is an escalation layer,

not the default — prefer fetch/extract (they cost less). It is on by default; opt out with policy.allow_browser=false. Sessions bill by bandwidth + time.

• Do not scale before validating the workflow on a small sample.

What is available today

Run zenrows status for the live capability matrix. As of this toolkit:

| Primitive | Command | Status | | --- | --- | --- | | Protected Fetch | zenrows fetch | available (GET /v1/) | | Extract (extract=auto / Autoparse/CSS/Markdown) | zenrows extract | beta (same /v1/; extract=auto falls back to autoparse) | | Batch | zenrows batch | beta — runs cloud jobs (create/status/results); cheapest path at scale. Estimate specs locally with no key | | Browser | zenrows browser | available (Browser Sessions REST API / MCP) | | MCP | zenrows mcp | available (remote + local server) |

Protected Fetch and Extract are the same API (GET /v1/) used two ways. The command consults the capability matrix before any cloud call — it never fakes success.

Cost model (Fetch and Extract)

Relative multipliers: basic 1×, JS rendering 5×, premium proxies 10×, both 25×. mode=auto charges only for the configuration that succeeds. Keep responses small with --css or --output markdown.

See also: [[protected-fetch]], [[extract]], [[interact-browser]], [[cost-control]], [[trace-debug]], [[compliance-policy]].

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ZenRows
• Source: ZenRows/cli
• License: MIT
• Homepage: https://docs.zenrows.com/cli/introduction

Install and usage instructions live in the source repository linked above.