万智牌卡牌查询

技能简介

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

能做什么

• 按多维度条件搜索卡牌（名称、类型、颜色、法术力值等）
• 获取指定卡牌的精确匹配或模糊匹配结果
• 查询卡牌市场价格（普通/闪卡）
• 查看各赛制合法性状态
• 抽取随机卡牌或按条件随机筛选
• 获取卡牌图片链接与完整规则文本

使用说明

1. 确保已安装 Python 3 环境
2. 克隆技能仓库到本地目录
3. 安装依赖：pip install requests
4. 使用示例脚本查询：
   python3 scripts/scryfall_search.py search "lightning bolt"
python3 scripts/scryfall_search.py named --exact "Black Lotus"
python3 scripts/scryfall_search.py random --query "t:dragon"
5. 直接调用 API 时需设置请求头：User-Agent 为 OpenClawMTGSkill/1.0，Accept 为 application/json
6. 注意控制请求频率，每次请求间隔 50-100 毫秒（上限 10 次/秒）

输入与输出

见下方输入与输出表格。

风险提示

• API 返回 429 状态码时表示触发速率限制，需等待后重试
• 模糊匹配可能返回非预期卡牌，关键查询建议使用精确匹配
• 双面色卡牌需检查 card_faces 数组获取完整信息
• 价格数据仅供参考，实际交易以市场为准

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/santidev95/mtg-edh-deckbuilder/SKILL.md
来源类型：GitHub 仓库