v2.48.13

calcom/cal.diyv2.48.13Mar 31, 2026by j-mendez

AI Summary

Introduces a new CLI command for Spider Cloud authentication, enabling users to store API keys locally and utilize various cloud modes for remote crawls and headless browsing.

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
Priority order for key resolution: flags > environment variables > stored credentials

New Features

Spider Cloud API key storage via 'spider authenticate' command
Spider Browser Cloud integration for remote headless browsing
Cloud modes: proxy, api, unblocker, fallback, and 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.