Bygg en AI-Commander-kortfinner med Scryfall

En Scryfall Commander-kortfinner gjør en beskrivelse av kortet du trenger om til et søk du kan undersøke. I denne veiledningen skal du bygge Open Query, en Quickchat AI Agent som viser sitt Scryfall-søk, returnerer ekte kortoppføringer og forklarer hvorfor hver kandidat kan passe i dekket ditt.

Start med én plass i et monogrønt Commander-deck. Du vil ha en skapning med trample og en pris under fem amerikanske dollar. Når du er ferdig, kan du skrive inn den forespørselen, åpne de returnerte kortene og finjustere søket uten å måtte huske hver eneste operator.

Den nyttige delen kommer når forespørselen blir vanskeligere. «Trekk når en annen skapning kommer inn» høres presist ut, men et søk etter ordene enters og draw finner også kort som gjør noe annet. Du skal fange opp det misforholdet og snevre inn søket, ved å bruke den returnerte kortteksten som bevis.

Hva skal du bygge, og hva trenger du?

Du skal koble én skrivebeskyttet API Action til Scryfall, gi Agenten søkeinstruksjonene sine og teste den i en samtale. Handlingen kaller en fast URL. Modellen leverer et søk og et sidenummer. Scryfall returnerer oppføringene svaret bygger på.

1. Opprett en Quickchat AI-konto og en Agent med navnet Open Query. Du trenger tilgjengelige AI-kreditter for samtaler og tester. Se gjeldende planer.
2. Ha Agentens Identity, Actions & MCPs og AI Preview tilgjengelige mens du arbeider. Ingen opplasting av kortsamling er nødvendig.
3. Bruk det offentlige API-et til Scryfall. Du trenger ikke en Scryfall-konto eller API-nøkkel for disse søkene.

Startpakken inneholder Main Prompt, oppskrift for handlingen, stier for responsfilter og testmeldinger. Eksemplene bruker engelsk Oracle-tekst og USD-priser. Behold søkeoperatorene og kortnavnene slik de er skrevet når du følger med på et annet språk.

Trinn 1: Hvordan gjør du en kortforespørsel om til et Scryfall-søk?

Et Scryfall-søk kombinerer begrensninger atskilt med mellomrom. For vår første forespørsel bruker du:

f:commander id<=g t:creature kw:trample usd<5

To små valg betyr noe. kw:trample søker etter nøkkelordet. o:trample søker etter ordet i Oracle-tekst. En skapning kan nevne trample uten selv å ha den evnen. Vi testet begge deler. Tekstsøket ga et bredere sett.

«Passer i et monogrønt deck» er også forskjellig fra «har nøyaktig grønn identitet». Det første tillater fargeløse kort. Bruk id=g for det siste, eller id<=ur for å søke innenfor fargene til en blå-rød commander. Dette er identitetsbegrensninger, ikke en fullstendig kontroll av deck-legalitet.

Referansen for søkesyntaks til Scryfall forklarer disse operatorene. I denne veiledningen skal du holde søket synlig i hvert svar slik at du kan oppdage en utelatt farge, en uventet valuta eller et søk som er bredere enn forespørselen din.

Trinn 2: Hvordan kobler du Scryfall API-et til Agenten din?

Opprett én API Action som sender en GET-forespørsel til endepunktet for kortsøk hos Scryfall. De faste innstillingene velger leverandør og sortering. De to parameterne lar Agenten velge søket og siden.

1. Åpne Actions & MCPs → Add Action → API Action.
2. Bruk builder-forespørselen nedenfor, og gå deretter gjennom de genererte innstillingene opp mot oppskriften. Builder-veiledningen for API Action forklarer flyten for generering og gjennomgang.
3. Sett API Action Name til Search Scryfall cards.

Create a read-only Scryfall card-search Action using GET https://api.scryfall.com/cards/search. Add required Text query and Integer page parameters. Map q to query and page to page in Query Params. Fix unique=cards and order=name. Send Accept: application/json and User-Agent: QuickchatTutorialCardFinder/1.0 (+https://quickchat.ai). No authentication and no request body. Fetch one page only. Preserve pagination, warnings, card IDs, names, Oracle text including card_faces, color identity, Commander legality, USD prices and Scryfall links in the response.

Definer de to parameterne

Under What to ask the user first legger du til disse påkrevde parameterne. Agenten kan fylle dem ut fra samtalen. Etiketten betyr ikke at den må be deg skrive inn rå søkesyntaks.

Sett endepunkt, søkeparametere og headere

Velg GET og skriv inn:

https://api.scryfall.com/cards/search

Under Query Params legger du til de fire radene nedenfor. For de dynamiske verdiene bruker du Add AI Data til å velge parameteren du opprettet. Notasjonen {{query}} og {{page}} nedenfor representerer disse parameterbrikkene.

Bruk feltene for søkeparametere slik at mellomrom, anførselstegn og operatorer blir kodet som parameterverdier. Hold endepunktets URL fast.

La Body stå tomt. Ingen autentisering er nødvendig. User-Agent er et identifiserende klientnavn, ikke en legitimasjon. Bruk ditt eget passende applikasjonsnavn og kontakt-URL når du tar i bruk din versjon.

Hold responsen nyttig

En Scryfall-side kan inneholde mange oppføringer. Behold feltene Agent trenger, sammen med informasjonen som forteller den om det finnes flere sider. Utvid Advanced settings og finn Response filter. Bruk Add JSONPath, og deretter plussknappen, for å legge til hver bane nedenfor som en egen oppføring:

$.total_cards
$.has_more
$.next_page
$.warnings
$.data[*].id
$.data[*].name
$.data[*].oracle_text
$.data[*].card_faces
$.data[*].color_identity
$.data[*].legalities.commander
$.data[*].prices.usd
$.data[*].scryfall_uri

Behold card_faces. Noen kort legger teksten sin på individuelle sider i stedet for på toppnivå. Behold også warnings: En vellykket HTTP-respons betyr ikke at Scryfall tolket hvert ledd slik du hadde tenkt. Referansen for Card object beskriver disse feltene.

I API Action Description limer du inn:

Use when a player wants to find real cards matching a confirmed request. Build an inspectable Scryfall query, fetch one page, and explain matching evidence from returned fields. Show the executed query and any returned warnings. Return at most five initial recommendations, with Scryfall links, relevant Oracle text, color identity and USD price. If more API pages exist, say so and offer the next page; do not claim the first results are exhaustive. Treat broad text searches as candidates until their Oracle text establishes the requested interaction.

Lagre handlingen og kontroller at den er aktiv. Veiledningen til HTTP Action anatomy forklarer hvordan parameterne, forespørselen og beskrivelsen virker sammen.

Trinn 3: Hvordan bør kortfinneren forklare resultatene sine?

Agenten trenger instruksjoner for å vise søket sitt, forankre anbefalinger i returnerte oppføringer og skille mellom et ordtreff og en regelinteraksjon. Åpne Identity → Main Prompt og lim inn hele prompten fra startpakken, gjengitt nedenfor.

You are Open Query, a Commander card-search helper. Clarify format, color identity and budget currency when needed. Turn the confirmed request into documented Scryfall syntax, call Search Scryfall cards, and show the executed query in a code block followed by up to five linked results. Recommend only records returned by this Action. Include each card's name, Scryfall link, color identity, returned USD price and the relevant Oracle text. Summarize without inventing text or cards. Use periods or semicolons rather than em dashes. Use text on card_faces when present.
For mono-green deck eligibility use id<=g; this includes colorless. For exactly green identity use id=g. A baseline trample request uses f:commander id<=g t:creature kw:trample usd<5.
Separate word matches from rules interpretation. If a card mentions the requested words but does not establish the requested trigger, label it a candidate to inspect, not a confirmed fit. Prices are provider observations, not seller quotes; a missing price is unknown. Say the total result count and whether more API pages exist. Start at page 1. Fetch the next page only when asked, using the same query and the next page number. Never fetch every page automatically. A shortlist is not exhaustive. If asked for more from this page, fetch the same query and page again, then choose returned cards you have not already shown. The next API page is different.
Do not build a full deck, invent cards, or claim a rules ruling. If a search returns no results or an error, explain it and offer a specific query change for confirmation. Inspect response warnings as well as errors. If Scryfall ignores part of a query, report that warning, do not recommend cards from that broadened result, and ask before changing the query. Do not silently retry an altered query. If rate limited, stop and ask the reader to try later.

Åpne nå AI Preview og send:

Find Commander-legal creatures in mono-green color identity with trample, priced below 5 USD.

Demoen tolket kvalifisering for monogrønt deck som grønn eller fargeløs. For nøyaktig grønn identitet må du si det uttrykkelig.

Les det kjørte søket før anbefalingene. Det bør bevare Commander, grønn-eller-fargeløs identitet, skapningstype, trample og USD under 5. Åpne én korts Scryfall-lenke og sammenlign relevant tekst, identitet og pris med svaret. Prisen er en oppslagsobservasjon for den returnerte trykkingen, ikke et pristilbud ved utsjekk.

API-resultatene er sortert etter navn, ikke rangert etter hvor godt de passer. Agenten velger en kortliste fra den hentede siden. unique=cards unngår å liste hver trykking som et eget resultat. Det betyr ikke at den valgte oppføringen er den billigste kopien du kan kjøpe.

Trinn 4: Hvordan retter du et søk som finner feil interaksjon?

Snevre inn søket ved å lese et moteksempel og legge til den manglende betingelsen. Behold skillet mellom å finne kandidatkort og å bekrefte teksten deres gjennom hele finjusteringen.

Spør:

Find green cards that draw when another creature enters, under 5 USD.

Et bredt kandidatsøk er:

f:commander id<=g o:enters o:draw usd<5

I vår direkte Scryfall-kontroll 10. november 2026 returnerte dette 161 kandidater, inkludert Abundant Growth. Korttrekket skjer når Auraen selv kommer inn. Det inneholder begge ordene, men det gir ikke den gjentakbare motoren for korttrekk ved skapningsinntreden som forespørselen antyder.

Prøv denne finjusteringen:

Keep the same colors and budget. Look for “whenever another creature”, then check the conditions in each returned card's text.

Det smalere søket vi kontrollerte var:

f:commander id<=g o:"whenever another creature" o:enters o:draw usd<5

Det finjusterte søket returnerte fire kandidater. Garruk’s Packleader er en nyttig betinget match: Den andre skapningen må ha styrke 3 eller høyere. Det skillet hører hjemme i anbefalingen. En token-strategi med mange 1/1-skapninger kan trenge et annet kort.

Å legge til bare o:"another creature" er mindre presist. Testen vår fant fortsatt Disciple of Freyalise, der egen inntreden kan føre til at du ofrer en annen skapning og trekker et kort. Det er enda en grunn til å undersøke hele evnen i stedet for å behandle en ekstra frase som bevis.

Gjenta den samme løkken for ditt eget deck: forespørsel → søk → korttekst → én finjustering. Hvis budsjettet fjerner alle nyttige kandidater, spør før du utvider det. Hvis et kort har en begrensning, si hva begrensningen er i stedet for å stille droppe den fra forklaringen.

Trinn 5: Hvordan tester du kortfinneren før du bruker den?

Test både svaret og API-kallet. En overbevisende setning kan ikke fastslå hvilket søk som ble kjørt eller hvilke oppføringer som kom tilbake.

1. Åpne Testing og opprett et datasett med navnet Open Query checks ved å bruke Create Dataset → Paste messages. Lim inn de uavhengige testmeldingene fra pakken.
2. Kjør testene. Vurder om svaret viser søket sitt, viser til returnerte kort og forklarer usikkerhet.
3. Åpne den samsvarende samtalen i Inbox og undersøk handlingskallet. Kontroller søket, sidenummeret, statusen og de returnerte feltene. Bruk handlingens View logs-kontroll for å finne enkeltkall.
4. Test finjustering og paginering i en fortløpende samtale, der det forrige søket er tilgjengelig.

For testen uten treff sender du:

Find a Commander card named definitely-not-a-real-card-xyz.

Én direkte API-test viste hvorfor advarsler betyr noe. Det feilformaterte søket f:commander o:/[/ returnerte HTTP 200, men Scryfall rapporterte at det hadde ignorert det ugyldige uttrykket. Resultatene var derfor bredere enn forespurt. Behold den advarselen, forklar det ignorerte filteret, og korriger søket før du anbefaler disse resultatene.

Våre lokale Agent-kjøringer dekket grunnlinjen, finjustering, tomme resultater og et søk over to sider. Separate API-kontroller dekket manglende priser, kortsider og syntaksadvarsler. Bruk et kontrollert testoppsett for å teste hastighetsbegrensning uten å sende unødvendig trafikk.

Dokumentasjonen for endepunktet for kortsøk spesifiserer for øyeblikket to søkeforespørsler per sekund. Hold minst 500 millisekunder mellom forespørslene. Denne veiledningen er en personlig søkehjelper. En offentlig bot som betjener mange spillere trenger delt hastighetsbegrensning og caching. Å be modellen om å roe ned håndhever ikke en global forespørselsgrense.

Kan ChatGPT eller Claude hjelpe med å konfigurere dette?

Du kan bruke Quickchat AI-pluginen for ChatGPT eller Quickchat AI-koblingen for Claude til å konfigurere Agenten gjennom tilkoblingen for kontoadministrasjon. Fullfør innloggingen selv, og gi deretter denne veiledningen og startpakken med følgende forespørsel:

Use Quickchat AI to create a dedicated Agent called Open Query using the attached tutorial and starter kit. Set its Main Prompt and create the Search Scryfall cards API Action with the exact parameters, headers and response filters. Show me the saved configuration, then run the baseline and impossible-name tests and show their Action call records. Run only those two conversations; they use AI credits. Do not publish the Agent or connect a public channel.

Dokumentasjonen for kontoadministrasjon forklarer tilkoblingen. Dette konfigurerer Quickchat AI-kontoen din. Det gjør ikke automatisk Open Query tilgjengelig for andre som et MCP-verktøy.

Ofte stilte spørsmål

Kan jeg søke i Scryfall med naturlig språk?

En AI-assistent kan oversette en forespørsel i vanlig språk til Scryfall-søkesyntaks og kjøre den gjennom Scryfall API-et. Denne veiledningen bygger den assistenten i Quickchat AI og får den til å vise søket, lenkede kortoppføringer og relevant Oracle-tekst slik at du kan kontrollere tolkningen.

Trenger jeg en Scryfall API-nøkkel?

Nei. Det offentlige endepunktet for kortsøk krever ikke konto eller API-nøkkel. Send identifiserende User-Agent- og Accept-headere, følg Scryfall sine hastighetsgrenser, og be om flere sider med hensikt.

Kan denne AI-kortfinneren hallusinere et kort?

Instruksjonene begrenser anbefalinger til oppføringer som returneres av handlingen, med Scryfall-lenker. Modellen kan fortsatt gjøre feil, så kontroller den returnerte ID-en og Oracle-teksten, og test et umulig kortnavn før du stoler på assistenten.

Hva er forskjellen mellom id<=g og id=g på Scryfall?

id<=g inkluderer grønne og fargeløse identiteter, noe som passer når du søker innenfor fargene til en monogrønn commander. id=g krever nøyaktig grønn identitet. Fargeidentitet er forskjellig fra kortfarge. Bruk identitetsfilteret for Commander-deckbygging.

Er Scryfall-priser garantert?

Nei. Feltet prices.usd er prisdata fra leverandøren for den returnerte trykkingen, ikke et tilbud fra en selger. Det kan være null. Filteret usd<5 søker under fem amerikanske dollar. Det fastslår ikke fraktkostnader, tilgjengelighet eller den billigste trykkingen du faktisk kan kjøpe.

Returnerer ett søk alle kort som matcher?

Et søk returnerer én API-side. Svaret inkluderer total_cards, has_more og, når det er relevant, next_page. Open Query viser opptil fem anbefalinger fra den hentede siden. Be om flere fra den siden eller be uttrykkelig om neste API-side. En kortliste er ikke hele resultatsettet.

Kan dette bygge hele Commander-dekket mitt?

Denne veiledningen bygger en assistent for kortsøk. Den hjelper deg med å finne og undersøke kandidater til en plass i dekket. Den validerer ikke et komplett deck på 100 kort, optimaliserer ikke en deckliste og erstatter ikke en dommer for reglene.