spawn/netcup/README.md
A 93a043cef8
feat: Add Netcup cloud provider support (#407)
Add Netcup as a new cloud provider - a German budget VPS provider
with REST API support starting at €3.86/mo.

Changes:
- Created netcup/lib/common.sh with session-based REST API primitives
- Added Netcup to manifest.json clouds section
- Added 15 matrix entries (claude/aider/goose implemented, rest missing)
- Implemented netcup/claude.sh, netcup/aider.sh, netcup/goose.sh
- Created netcup/README.md with usage documentation

Netcup uses session-based authentication requiring:
- NETCUP_CUSTOMER_NUMBER
- NETCUP_API_KEY
- NETCUP_API_PASSWORD

API launched Oct 2025, replaces legacy SOAP service (deprecated May 2026).

Agent: cloud-scout-2

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
2026-02-11 01:34:59 -08:00

63 lines
1.7 KiB
Markdown

# Netcup Cloud
Netcup VPS cloud via REST API. [Netcup](https://www.netcup.com/)
## Agents
#### Claude Code
```bash
bash <(curl -fsSL https://openrouter.ai/lab/spawn/netcup/claude.sh)
```
#### Aider
```bash
bash <(curl -fsSL https://openrouter.ai/lab/spawn/netcup/aider.sh)
```
#### Goose
```bash
bash <(curl -fsSL https://openrouter.ai/lab/spawn/netcup/goose.sh)
```
## Non-Interactive Mode
```bash
NETCUP_SERVER_NAME=dev-mk1 \
NETCUP_CUSTOMER_NUMBER=12345 \
NETCUP_API_KEY=your-api-key \
NETCUP_API_PASSWORD=your-api-password \
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
bash <(curl -fsSL https://openrouter.ai/lab/spawn/netcup/claude.sh)
```
## Authentication
Netcup uses session-based REST API authentication with three credentials:
1. **NETCUP_CUSTOMER_NUMBER** - Your customer number
2. **NETCUP_API_KEY** - API key from SCP
3. **NETCUP_API_PASSWORD** - API password from SCP
Get your credentials:
- Log in to [Netcup Server Control Panel](https://ccp.netcup.net/)
- Navigate to **Settings → API**
- Create a new API key if needed
The scripts will:
1. Check for credentials in environment variables
2. Check `~/.config/spawn/netcup.json`
3. Prompt for credentials if not found
4. Save credentials to config file for reuse
## Pricing
Budget VPS provider starting at approximately €3.86/month for entry-level VPS plans. Netcup offers flexible pricing with hourly billing or annual contracts.
## API
Netcup's REST API launched in October 2025. It uses session-based authentication (login to get session ID, then use session ID for API calls). The API replaces the legacy SOAP web service (discontinued May 1, 2026).
API documentation is available in the Server Control Panel → REST API Docs.