万智牌卡牌查询

技能简介

通过Scryfall API查询Magic: The Gathering（万智牌）卡牌信息，支持按名称、类型、颜色、法术力费用、规则文本、系列等属性检索，可获取卡牌图片、价格、赛制合法性及随机卡牌。

业务背景

面向万智牌玩家与卡牌交易者，提供一站式卡牌信息检索服务。支持按名称、颜色、稀有度等多维度精准找卡，实时获取市场价格与赛制合法性，辅助卡组构建、交易决策及赛事准备，降低信息搜集成本。

落地案例：牌店店主收到顾客询问某张卡牌库存时，输入卡牌名称即可快速调取完整信息：展示卡牌图片确认品相、查看实时美元定价制定收购/出售策略、核实该卡在标准赛或摩登赛的合法性状态。遇到顾客只记得部分卡名时，通过模糊搜索或自动补全功能定位目标卡牌。

能做什么

• 按多维度条件搜索卡牌（名称模糊/精确匹配、颜色、力量/防御、稀有度等）
• 查询卡牌实时价格（美元/闪卡价格）
• 获取卡牌图片链接及各赛制合法性状态
• 抽取随机卡牌或满足特定条件的随机卡牌
• 自动补全卡牌名称输入
• 查看卡牌官方规则解答（rulings）

使用说明

安装准备

1. 确保系统已安装Python 3.x环境
2. 克隆技能仓库至本地目录
3. 无需额外依赖库，使用标准urllib/http库即可调用

基础调用方式

# 设置必需请求头
headers = {
    "User-Agent": "OpenClawMTGSkill/1.0",
    "Accept": "application/json"
}

# 搜索卡牌示例
GET https://api.scryfall.com/cards/search?q=lightning+bolt

# 精确名称查询
GET https://api.scryfall.com/cards/named?exact=Black+Lotus

# 随机卡牌
GET https://api.scryfall.com/cards/random

搜索语法示例

• c:red pow=3 – 红色且力量为3的卡牌
• t:merfolk t:legend – 传奇人鱼生物
• o:"draw a card" – 含”抓一张牌”文本的卡牌
• usd<1 – 价格低于1美元的卡牌
• f:standard – 标准赛制可用卡牌

速率限制：请求间隔保持50-100毫秒（最高10次/秒）

输入与输出

见下方输入与输出表格。

风险提示

• API返回404表示卡牌不存在，需检查拼写或改用模糊搜索
• 422错误提示搜索语法无效，需对照搜索语法文档修正
• 429状态码表示触发速率限制，应等待后重试
• 价格数据仅供参考，实际交易价格可能波动
• 双面色卡牌需读取card_faces数组获取完整信息

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/santidev95/scryfall-cards/SKILL.md
来源类型：GitHub开源技能