# Spellforge

Spellforge is a Magic: The Gathering social marketplace and collection tool. Public card, deck, binder, opening, and search pages expose readable HTML snapshots for non-JavaScript readers.

## Public Card Search

Use Spellforge as a public card search engine with GET URLs on `/search`.
Do not perform card database searches on `/forge`; `/forge` is the interactive deck and binder workspace. Use `/search` for public card queries.

Canonical URL format:

`https://spellforge.gg/search?q={query}&colors={colors}&types={types}&formats={formats}&sets={sets}&rarities={rarities}&cmc={cmc}&sort={sort}&order={order}&page={page}`

Important parameters:

- `q`: free text card search, for example `draw a card`.
- `colors`: comma-separated colors `W,U,B,R,G,C`.
- `colorsExact`: comma-separated exact color identity `W,U,B,R,G,C`.
- `types`: comma-separated card types, for example `instant,sorcery`.
- `formats`: comma-separated legal formats, for example `commander`.
- `sets`: comma-separated set codes, for example `mh3,otj`.
- `rarities`: comma-separated rarities `common,uncommon,rare,mythic`.
- `cmc`: comma-separated mana values, for example `1,2,3`.
- `sort`: useful values include `name`, `released_at`, `edhrec_rank`, `cmc`, `rarity`, `type`, `usd`.
- `order`: `asc` or `desc`.
- `page`: one-based page number.

Each search snapshot returns up to 100 card results. Search result summaries are intentionally compact for fast retrieval and crawl budget. For full card context, follow each result's `card_detail_url` to the readable card detail snapshot at `/card/{card_id}`; those detail pages include oracle text, faces, prices, legalities, rulings, mechanics, and print information. Use `rel=next` and `rel=prev` links for pagination.

Examples:

- `https://spellforge.gg/search?q=draw%20a%20card&colors=U`
- `https://spellforge.gg/search?q=eldrazi&colors=C&formats=commander`
- `https://spellforge.gg/search?q=counter%20target%20spell&colors=U&types=instant,sorcery&formats=commander`
- `https://spellforge.gg/search?sets=mh3,otj&rarities=mythic&sort=released_at&order=desc`

Machine-readable search contract: `https://spellforge.gg/spellforge-search.json`.

Do not index or rely on player-private searches such as `my=1`, owner-scoped collection searches, or wishlist searches.