Search and retrieve Magic: The Gathering card data using the Scryfall API. Use this skill when the user asks about MTG cards, wants to search for cards by name, type, color, mana cost, oracle text, set, or any other card attribute. Also use for getting card images, prices, rulings, legality information, or random cards. Triggers include mentions of MTG, Magic, Magic: The Gathering, card names, deck building questions, or requests for card information.
使用Scryfall API搜索《万智牌》卡牌。
基础URL：https://api.scryfall.com
必需请求头：
python
headers = {
User-Agent: OpenClawMTGSkill/1.0,
Accept: application/json
}
速率限制： 请求间插入50-100毫秒延迟（最大每秒10次请求）。
GET /cards/search?q={查询词}
参数：
GET /cards/named?exact={名称}
GET /cards/named?fuzzy={名称}
使用fuzzy进行部分匹配（例如，jac bele → Jace Beleren）。
添加&set={代码}限制到特定系列。
GET /cards/random
GET /cards/random?q={查询词}
GET /cards/{id}
GET /cards/{系列代码}/{收藏编号}
GET /cards/autocomplete?q={部分名称}
返回最多20个卡牌名称建议。
完整搜索语法指南请参见references/search_syntax.md。
快速示例：
使用提供的脚本进行常见操作：
bash
python3 scripts/scryfall_search.py search lightning bolt
python3 scripts/scryfall_search.py named --exact Black Lotus
python3 scripts/scryfall_search.py random
python3 scripts/scryfall_search.py random --query t:dragon
或使用正确的请求头和速率限制直接调用API。
显示卡牌信息时，优先使用以下字段：
对于双面卡牌，请检查card_faces数组。
始终验证响应是否包含object字段；如果object: error，请检查details获取错误信息。
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 mtg-edh-deckbuilder-1776363593 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 mtg-edh-deckbuilder-1776363593 技能
skillhub install mtg-edh-deckbuilder-1776363593
文件大小: 7.21 KB | 发布时间: 2026-4-17 16:27
