Skip to main content

scry

Run a raw Scryfall card search.

Usage

./ritual scry <query> [options]

Arguments

ArgumentDescriptionRequired
<query>Scryfall search queryYes

Options

OptionDescriptionDefault
--csvOutput results as CSVfalse
--pages <number>Number of pages to output1 (for non-TTY)
--fields <list>Comma-separated fields for json/ndjson output-
--output <format>Output format (json, ndjson, or text)json
--quietSuppress non-essential output and default to one page in TTY modefalse
--non-interactiveDisable interactive pagination promptsfalse
-y, --yesAutomatically fetch additional pages in TTY modefalse

Examples

Search for legendary creatures:

./ritual scry "type:legendary type:creature"

Search for cards legal in Commander under $5:

./ritual scry "legal:commander usd<5"

Export search results to CSV:

./ritual scry "set:mh2 type:creature" --csv > creatures.csv

Force text output:

./ritual scry "type:artifact" --output text

Stream projected card fields as NDJSON:

./ritual scry "type:artifact" --fields name,set,prices.usd --output ndjson

Get multiple pages of results:

./ritual scry "type:planeswalker" --pages 5

Fetch all pages in TTY mode without prompts:

./ritual scry "type:planeswalker" --yes

Query Syntax

This command uses Scryfall's search syntax. Some common operators:

OperatorExampleDescription
type:type:creatureFilter by card type
set:set:mh2Filter by set code
cmc:cmc:3Filter by mana value
c:c:blueFilter by color
legal:legal:commanderFilter by format legality
usd<usd<10Filter by price