[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [Curated website collections](https://spiral.ai/integrations/dots/curated-website-collections)

# How to Use Curated website collections in dots

Returns websites from a themed Curated collection, such as dark interfaces or agency sites. Use it when the design direction matters more than a particular website name.

|  |  |
| --- | --- |
| Model | Curated website collections |
| Available through | Alexandria |
| Category | Developer |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Curated website collections in dots

- Every Friday, use Curated website collections for https://curated.design/inspiration/minimal/ and report up to five references absent from your previous check, with their names and entry links.
- Every Monday at 9am: use Curated website collections to look this up and give me the result as a table.
- Pull the latest numbers from Curated website collections and tell me what changed since last week.
- Check Curated website collections and summarize what you find in three bullet points.
- Pull the newest data from Curated website collections and give me the result as a table.

## How to set up Curated website collections in dots

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send dots this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Curated website collections**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "curated-design/web-design-inspiration/list_shelf_sites",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: dots finds Curated website collections on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/dots

## Curated website collections tools and prices

- [Curated (curated.design) · List shelf sites](https://spiral.ai/tools/alexandria/curated-design/web-design-inspiration/list_shelf_sites) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | Alternative to `slug`: a pasted shelf URL such as https://curated.design/inspiration/dark/?page=2 (its page query is used unless `page` is given). Pattern: ^https?://(www\.)?curated\.design/inspiration/[a-z0-9-]+/?(\?.*)?$. |
| page | 1 to 10000 | — | 1-based page; 32 cards per page. Defaults to 1. |
| slug |  | — | Shelf slug: an industry (agency, portfolio, ...), a style (dark, minimal, ...) or a tag (saas, ai, ...). Pattern: ^[a-z0-9]+(-[a-z0-9]+)*$. |

## What can you do with Curated website collections in dots?

Keep a team's design reference shortlist current through scheduled checks of Curated. An always-on agent can compare returned entries and labels with earlier checks and prepare a small review queue.

### Prepare a website redesign brief

Start with Curated's discovery labels, gather industry examples, investigate named references, and inspect shortlisted entries. Give the team a focused list of original-site links to review before choosing a direction.

### Compare industry and style references

Build one shortlist around the business category and another around a visual direction such as minimal or dark. Check the entries to identify references that belong in both discussions.

### Run a design reference workshop

Choose relevant labels, gather a small set of website examples, and add references participants name during the workshop. Use each website's entry and original link to keep the discussion tied to identifiable work.

### Create a project reference index

Organize a project's selected references using Curated's labels. Combine industry browsing, themed collections, and named searches, then keep the relevant entry links alongside the team's own design notes.

### Prepare an agency website pitch

Gather agency references and investigate a named studio such as Basement Studio. Present a shortlist with Curated's assigned labels and original links so stakeholders can review the actual websites.

### Refresh a team's reference shortlist

Periodically revisit a chosen industry or style collection and compare returned website links with the team's previous shortlist. Inspect unfamiliar entries before proposing additions to the next design review.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All dots guides](https://spiral.ai/integrations/dots)

## Curated website collections in other agents

- [Amp](https://spiral.ai/integrations/amp/curated-website-collections)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/curated-website-collections)
- [Claude](https://spiral.ai/integrations/claude-desktop/curated-website-collections)
- [Claude Code](https://spiral.ai/integrations/claude-code/curated-website-collections)
- [Cline](https://spiral.ai/integrations/cline/curated-website-collections)
- [Codex](https://spiral.ai/integrations/codex/curated-website-collections)
- [Cursor](https://spiral.ai/integrations/cursor/curated-website-collections)
- [Devin](https://spiral.ai/integrations/devin/curated-website-collections)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/curated-website-collections)
- [Gemini](https://spiral.ai/integrations/gemini/curated-website-collections)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/curated-website-collections)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/curated-website-collections)
- [goose](https://spiral.ai/integrations/goose/curated-website-collections)
- [Grok](https://spiral.ai/integrations/grok/curated-website-collections)
- [Grok Build](https://spiral.ai/integrations/grok-build/curated-website-collections)
- [Hermes](https://spiral.ai/integrations/hermes/curated-website-collections)
- [Instinct](https://spiral.ai/integrations/instinct/curated-website-collections)
- [Manus](https://spiral.ai/integrations/manus/curated-website-collections)
- [Muse](https://spiral.ai/integrations/muse/curated-website-collections)
- [Muse Code](https://spiral.ai/integrations/muse-code/curated-website-collections)
- [n8n](https://spiral.ai/integrations/n8n/curated-website-collections)
- [Notion](https://spiral.ai/integrations/notion/curated-website-collections)
- [OpenClaw](https://spiral.ai/integrations/openclaw/curated-website-collections)
- [opencode](https://spiral.ai/integrations/opencode/curated-website-collections)
- [Perplexity](https://spiral.ai/integrations/perplexity/curated-website-collections)
- [Raycast](https://spiral.ai/integrations/raycast/curated-website-collections)
- [VS Code](https://spiral.ai/integrations/vscode/curated-website-collections)
- [Windsurf](https://spiral.ai/integrations/windsurf/curated-website-collections)
- [Zapier](https://spiral.ai/integrations/zapier/curated-website-collections)

## More dots guides

- [Curated website categories and styles](https://spiral.ai/integrations/dots/curated-website-categories-and-styles)
- [Curated website details](https://spiral.ai/integrations/dots/curated-website-details)
- [Claude website page](https://spiral.ai/integrations/dots/claude-website-page)
- [Curated website gallery](https://spiral.ai/integrations/dots/curated-website-gallery)
- [Claude resource search](https://spiral.ai/integrations/dots/claude-resource-search)
- [Curated website search](https://spiral.ai/integrations/dots/curated-website-search)

## Questions about Curated website collections in dots

**Can dots use Curated website collections?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run Curated website collections like any built-in tool.

**How much does Curated website collections cost in dots?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need an Alexandria account to use Curated website collections in dots?**

You need no Alexandria account. dots uses one Spiral API key for every tool, and Spiral runs Curated website collections on its own Alexandria account.

**How long does it take to set up Curated website collections in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while Curated website collections runs?**

Curated website collections runs in the background. dots starts the run, checks on it and gives you the json when it's ready.

**Does Curated cover every website in an industry?**

Its coverage is a selection of websites that have already shipped. A person reviews submissions before accepted sites receive style and category labels, so the collection is an editorial reference rather than an industry census.

**Can entries disappear from Curated?**

Yes. Curated says it removes entries when a website goes offline or its owner requests removal, so a previously available reference can leave the collection.

**Should I search by name or browse a category?**

Curated recommends search when you know the website's name. Its category, style, and design-detail labels support discovery when you have a brief but no specific reference.

**What does Curated mean by a dark website?**

The dark collection covers websites that use a dark presentation by default. A website merely offering a dark-mode toggle does not match that stated definition.

**Can I inspect the original website?**

Each featured website has its own Curated page with a live-site link and its assigned tags. That link lets you move from the gallery reference to the original website.

