v2.48.13

swirlai/swirl-searchv2.48.13Mar 31, 2026by j-mendez

AI Summary

This release introduces a new command-line interface feature for authenticating with Spider Cloud, allowing users to store API keys locally for remote crawls and headless browser operations.

Key Highlights

New `spider authenticate` command for storing Spider Cloud API keys.
New cloud modes including `smart` (auto-detect bot protection) and `unblocker`.
Support for remote headless browsing via Spider Browser Cloud.
Configurable key resolution order: flags > env vars > stored credentials.

New Features

Spider Cloud authentication and credential management.
Spider Browser Cloud integration with headless mode.
Enhanced cloud modes (proxy, api, unblocker, fallback, smart).

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.