Robskan Developers
Canonical: https://robskan.nl/developers
Markdown: https://robskan.nl/developers.md
Text: https://robskan.nl/developers.txt
Robskan Developers

Public, anonymous read APIs for Robbie's portfolio and live Spotify listening. No API keys required — respect rate limits.

Quickstart

curl https://robskan.nl/api/v1/health
curl https://robskan.nl/api/v1/profile
curl https://robskan.nl/api/v1/music/now-playing
curl https://robskan.nl/openapi.json

Documentation

- OpenAPI 3.1 (https://robskan.nl/openapi.json)
- auth.md (https://robskan.nl/auth.md) — agent authentication walkthrough
- llms.txt (https://robskan.nl/llms.txt) — agent navigation index
- plugin.json (https://robskan.nl/plugin.json) — Agent Plugins manifest
- pricing.md (https://robskan.nl/pricing.md) — free public API and MCP
- Cursor MCP example config (https://robskan.nl/.well-known/agent-configs/cursor-mcp.example.json)
- wikidata-setup.md (https://robskan.nl/wikidata-setup.md) — entity linking for Is Agentic
- Publishing checklist: docs/AGENT_PUBLISHING.md in the repo
- npm: @robskan/public-api, CLI npx @robskan/mcp-cli
- MCP docs: https://robskan.nl/mcp/docs
- MCP product: https://robskan.nl/mcp/product

Sandbox test mode

The sandbox base URL is https://robskan.nl/sandbox. Use test mode fixtures with the same /api/v1/... paths under that prefix (no production data):

curl https://robskan.nl/sandbox/api/v1/health
curl https://robskan.nl/sandbox/api/v1/profile
curl https://robskan.nl/sandbox/api/v1/music/now-playing

You can also send ?sandbox=true or header X-Robskan-Sandbox: 1 on /api/v1/health, /api/v1/profile, and /api/v1/music/now-playing to receive fixture JSON.

Legacy index: https://robskan.nl/api/v1/sandbox (OpenAPI server Sandbox). Responses include X-Robskan-Environment: sandbox.

For agents

Verify the API

GET https://robskan.nl/api/v1/health returns JSON with status: "ok" and links to OpenAPI.

Public REST endpoints
Method | Path | Purpose

GET | /api/v1/health | Liveness + discovery
GET | /api/v1/profile | Public profile + decimal age
GET | /api/v1/music/now-playing | Spotify snapshot
GET | /api/v1/music/listening-summary | Paginated listening summary
GET | /api/v1/sandbox | Sandbox / preview metadata
GET | /api/v1/sandbox/profile | Fixture profile (safe for tests)
GET | /api/v1/sandbox/music/now-playing | Fixture now-playing
POST | /api/v1/batch | Batch read-only GET (max 10)
POST | /api/v1/jobs/nlweb-query | Async site search (202 + poll)

OpenAPI 3.1: https://robskan.nl/openapi.json

Errors: application/problem+json with code, detail, hint.

Idempotency

Send Idempotency-Key on POST /ask, POST /api/v1/batch, and POST /api/v1/jobs/nlweb-query.

MCP
Server | URL

Product | https://robskan.nl/mcp/product
Documentation | https://robskan.nl/mcp/docs

Registry card: https://robskan.nl/.well-known/mcp/server-card.json

SDK & CLI

- npm SDK: @robskan/public-api
- MCP CLI: npx @robskan/mcp-cli
- stdio MCP: npx @robskan/mcp-server
- Python: robskan-public-api
- Go: github.com/Robskan/robskan-public-api-go
- Agent skills: see https://robskan.nl/.well-known/agent-skills/index.json