v2.48.13

viarotel-org/escrcpyv2.48.13Mar 31, 2026by j-mendez

AI Summary

Introduces CLI authentication for Spider Cloud to store API keys locally for remote crawls. This update adds a new `spider authenticate` command, supports multiple cloud modes (proxy, api, unblocker, fallback, smart), and defines a resolution order for API keys.

Key Highlights

New `spider authenticate` command to store Spider Cloud API keys locally
Support for multiple cloud modes including 'smart' auto-detection and 'unblocker' bypass
Resolution order: CLI flag > Environment variable > Stored credentials

New Features

Spider Cloud CLI authentication
Remote headless browser via Spider Browser Cloud

Full Release Notes

## What's New

**`spider authenticate` command** — Store your [Spider Cloud](https://spider.cloud) API key locally for remote crawls.

### Usage

```sh
# Authenticate (stores key in ~/.spider/credentials)
spider authenticate sk-your-key
spider auth  # alias, interactive prompt

# Crawl via Spider Cloud (key auto-loaded)
spider crawl -u https://example.com -o

# Choose cloud mode
spider crawl -u https://example.com --spider-cloud-mode smart -o
spider crawl -u https://example.com --spider-cloud-mode unblocker -o

# Remote headless browser via Spider Browser Cloud
spider crawl -u https://example.com --spider-cloud-browser --headless -o
```

### Key Resolution Order
1. `--spider-cloud-key` flag
2. `SPIDER_CLOUD_API_KEY` env var
3. Stored credentials from `spider authenticate`

### Cloud Modes
| Mode | Description |
|------|-------------|
| `proxy` | Transparent proxy (default) |
| `api` | POST /crawl API |
| `unblocker` | Anti-bot bypass |
| `fallback` | Direct fetch first, fallback on 403/429/503 |
| `smart` | Auto-detects bot protection |

Sign up at https://spider.cloud for an API key.