Scryfall

简介

Scryfall 是顶级的万智牌卡牌数据库 API——10 万+ 张卡牌，含完整 oracle 文本、裁定、价格和图片。免费、免密钥且支持 CORS（实测可用）——是 MTG 应用的标准选择（比旧 MTG API 更新更快）。

快速开始

随机卡牌（实测可用）：

curl "https://api.scryfall.com/cards/random"

{
  "object": "card",
  "name": "Utopia Mycon",
  "lang": "en",
  "released_at": "2007-05-04",
  "mana_cost": "{2}{G}",
  "type_line": "Creature — Fungus",
  "oracle_text": "At the beginning of your upkeep...",
  "prices": { "usd": "0.20", "usd_foil": "0.40" },
  "image_uris": { "png": "https://cards.scryfall.io/..." }
}

搜索：

curl "https://api.scryfall.com/cards/search?q=type%3Adragon+cmc%3C4"

按名称查卡：

curl "https://api.scryfall.com/cards/named?fuzzy=black+lotus"

系列 / 裁定：

curl "https://api.scryfall.com/sets"
curl "https://api.scryfall.com/cards/random/rulings"

认证方式

无需认证——免密钥。（批量数据下载需要 GitHub 令牌，但 API 本身免费。）

速率限制与注意事项

• 约 10 次请求/秒每 IP（官方要求礼貌使用）——无需密钥。
• Scryfall 搜索语法：q= 支持 t:、c:、cmc:、pow:、set: 和全文 oracle 搜索。
• 图片从 cards.scryfall.io 提供——支持热链。
• fuzzy= 名称匹配容忍拼写错误（“black l0tus” → Black Lotus）。

常见问题

Scryfall 免费吗？ 是的——免费、免密钥、支持 CORS。

为什么用它替代 MTG API？ Scryfall 对新系列更新更快、搜索更丰富（实测——旧 MTG API 落后于发布）。

速率限制是多少？ 每 IP 约 10 次/秒。