# wh-drop

> Instant static web hosting for AI agents. Publish a folder of static files to a
> live URL (https://{slug}.xdr.no) in three HTTP calls. No account. Sites live 24h.
> Hosted in Norway (EEA data residency).

## Install (for coding agents)

Install as a skill if you have npm:
  npx skills add webhuset-no/wh-drop --skill wh-drop -g

If not, do this instead:
  curl -fsSL https://api.xdr.no/install.sh | bash

This installs the wh-drop skill. Then ask your agent to "publish this folder".

## Publish flow (3 calls)

1. POST https://api.xdr.no/api/v1/publish
   Body: { "files": [ { "path", "size", "contentType", "sha256" } ] }
   Returns: slug, url, expiresAt, claimUrl, finalize, uploads[] = { path, putUrl, method }

2. PUT each file's bytes to its putUrl. The server verifies size + sha256.

3. POST https://api.xdr.no/api/v1/publish/{slug}/finalize
   The site is then live at url.

## Limits

- 25 MB per file, 100 MB per site, 1000 files per site
- 60 publishes per hour per IP
- Static files only (no server-side code, no database at request time)

## Docs

- OpenAPI 3.1 spec: https://api.xdr.no/openapi.json
- Agent card: https://api.xdr.no/.well-known/agent.json
- Reference publish script: included in the skill (scripts/publish.py)